الفرق بين المراجعتين لصفحة: «Ruby/IO/tell»

المراجعة الحالية بتاريخ 11:54، 23 ديسمبر 2018

يُعيد التابع tell موضع المؤشر الحالي (بالبايت) للمجرى الذي استدعي معه.

البنية العامة

tell → integer‎

القيمة المعادة

يعاد عدد صحيح يمثِّل موضع الموشر الحالي للمجرى المعطى بالبايت.

أمثلة

مثال على استخدام التابع tell‎:

f = File.new("testfile")
f.pos    #=> 0
f.gets   #=> "This is line one\n"
f.pos    #=> 17‎

انظر أيضًا

التابع pos: يُعيد موضع المؤشر الحالي بدءًا من بداية الملف (بالبايت) للمجرى الذي استدعي معه.

التابع rewind: يعيد مؤشر المجرى الذي استُدعي معه إلى موضع بداية الإدخال.

التابع seek: يحرِّك مؤشر المجرى الذي استدعي معه إلى موضع محدَّد.

مصادر

قسم التابع tell‎ في الصنف IO‎ في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يُعيد التابع <code>tell</code> الإزاحة الحالية (بالبايت) في [[Ruby/IO|مجرى د/خ]] <code>ios</code>.
+يُعيد التابع <code>tell</code> موضع المؤشر الحالي (بالبايت) [[Ruby/IO|للمجرى]] الذي استدعي معه.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">tell → integer‎</syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
+يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل موضع الموشر الحالي [[Ruby/IO|للمجرى]] المعطى بالبايت.
 ==أمثلة==
 مثال على استخدام التابع <code>tell‎</code>:
@@ سطر 13: / سطر 15: @@
 f.gets   #=> "This is line one\n"
 f.pos    #=> 17‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/IO/syswrite|syswrite]]</code>: يكتب  [[Ruby/String|السلسلة النصية]] المعطاة في [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه <code>ios</code> باستخدام كتابة منخفض المستوى (low-level write). ثم يعيد عدد البايتات المكتوبة. لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|مجرى د/خ]] <code>ios</code>، أو قد تحصل على نتائج غير متوقعة. يُطلق استثناء <code>SystemCallError</code> عند حدوث خطأ.
+* التابع [[Ruby/IO/pos|<code>pos</code>]]: يُعيد موضع المؤشر الحالي بدءًا من بداية الملف (بالبايت) [[Ruby/IO|للمجرى]] الذي استدعي معه.
-* التابع <code>[[Ruby/IO/to_i|to_i]]</code>:
+* التابع [[Ruby/IO/rewind|<code>rewind</code>]]: يعيد مؤشر [[Ruby/IO|المجرى]] الذي استُدعي معه إلى موضع بداية الإدخال.
+* التابع <code>[[Ruby/IO/syswrite|seek]]</code>: يحرِّك مؤشر [[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-tell قسم  التابع tell‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-tell قسم التابع tell‎ في الصنف IO‎ في توثيق روبي الرسمي.]