الفرق بين المراجعتين ل"Ruby/IO/seek"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.seek</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method [[تصنيف: Ruby IO]...') |
|||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
− | يسعى التابع <code>seek</code> إلى التموضع عند الإزاحة المعطاة | + | يسعى التابع <code>seek</code> إلى التموضع عند الإزاحة المعطاة في [[Ruby/IO|مجرى د/خ]] وفقا لقيمة <code>whence</code> (انظر فقرة البنية العامة): |
+ | {| class="wikitable" | ||
+ | !قيمة الوسيط ''<code>whence</code>'' | ||
+ | !شرح | ||
+ | |- | ||
+ | |<code>:CUR</code> أو <code>IO::SEEK_CUR</code> | ||
+ | |يسعى إلى موضع الإزاحة الذي يساوي <code>amount</code> + موضع الإزاحة الحالي. | ||
+ | |- | ||
+ | | | ||
+ | ====== :END أو <code>IO::SEEK_END</code> ====== | ||
+ | |يسعى إلى موضع الإزاحة الذي يساوي <code>amount</code> + نهاية المجرى (ستحتاج على الأرجح لإعطاء <code>amount</code> قيمة سالبة). | ||
+ | |- | ||
+ | |<code>:SET</code> أو <code>IO::SEEK_SET</code> | ||
+ | |يسعى إلى موضع الإزاحة الموجود عند الموضع <code>amount</code> | ||
+ | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">seek(amount, whence=IO::SEEK_SET) → 0</syntaxhighlight> | <syntaxhighlight lang="ruby">seek(amount, whence=IO::SEEK_SET) → 0</syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
===<code>amount</code>=== | ===<code>amount</code>=== | ||
+ | عدد صحيح. | ||
+ | |||
===<code>whence</code>=== | ===<code>whence</code>=== | ||
+ | راية. | ||
+ | |||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
+ | يعيد التابع <code>seek</code> القيمة صفر. | ||
+ | |||
==أمثلة== | ==أمثلة== | ||
− | مثال على استخدام التابع <code>seek</code>: | + | مثال على استخدام التابع <code>seek</code>:<syntaxhighlight lang="ruby">f = File.new("testfile") |
− | <syntaxhighlight lang="ruby">f = File.new("testfile") | ||
f.seek(-13, IO::SEEK_END) #=> 0 | f.seek(-13, IO::SEEK_END) #=> 0 | ||
f.readline #=> "And so on...\n"</syntaxhighlight> | f.readline #=> "And so on...\n"</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
− | * التابع <code>[[Ruby/IO/rewind|rewind]]</code>: يُموضِع [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه | + | *التابع <code>[[Ruby/IO/rewind|rewind]]</code>: يُموضِع [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه عند بداية الإدخال، مع تعيين <code>[[Ruby/IO/lineno|lineno]]</code> عند القيمة صفر. |
− | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-seek قسم التابع seek في الصنف IO في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-seek قسم التابع seek في الصنف IO في توثيق روبي الرسمي.] |
مراجعة 19:54، 13 نوفمبر 2018
يسعى التابع seek
إلى التموضع عند الإزاحة المعطاة في مجرى د/خ وفقا لقيمة whence
(انظر فقرة البنية العامة):
قيمة الوسيط whence
|
شرح |
---|---|
:CUR أو IO::SEEK_CUR
|
يسعى إلى موضع الإزاحة الذي يساوي amount + موضع الإزاحة الحالي.
|
:END أو
|
يسعى إلى موضع الإزاحة الذي يساوي amount + نهاية المجرى (ستحتاج على الأرجح لإعطاء amount قيمة سالبة).
|
:SET أو IO::SEEK_SET
|
يسعى إلى موضع الإزاحة الموجود عند الموضع amount
|
البنية العامة
seek(amount, whence=IO::SEEK_SET) → 0
المعاملات
amount
عدد صحيح.
whence
راية.
القيمة المُعادة
يعيد التابع seek
القيمة صفر.
أمثلة
مثال على استخدام التابع seek
:
f = File.new("testfile")
f.seek(-13, IO::SEEK_END) #=> 0
f.readline #=> "And so on...\n"