الفرق بين المراجعتين ل"Ruby/Dir/seek"

من موسوعة حسوب
< Ruby‏ | Dir
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق)
 
(3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:  التابع <code>seek</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.seek</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Dir]]
 
[[تصنيف: Ruby Dir]]
يذهب التابع <code>seek</code> إلى موضع محدد في الكائن من صنف <code>Dir</code>  الذي استٌدعي معه.  
+
يذهب التابع <code>seek</code> إلى موضع محدد في المجلد الذي استٌدعي معه.  
 
+
==البنية العامة==
== البنية العامة ==
 
 
<syntaxhighlight lang="ruby">
 
<syntaxhighlight lang="ruby">
 
seek( integer ) → dir
 
seek( integer ) → dir
</syntaxhighlight>الوسيط ''<code>integer</code>'' ينبغي أن يكون عددًا معادًا من التابع <code>[[Ruby/Dir/tell|tell]]</code>.  
+
</syntaxhighlight>ينبغي أن يكون الوسيط <code>integer</code> عددًا معادًا من التابع <code>[[Ruby/Dir/tell|tell]]</code>.
 
+
==المعاملات==
== القيمة المٌعادة ==
+
===<code>integer</code> ===
يعيد التابع <code>seek</code> الموضع الحالي في الكائن من صنف <code>Dir</code>  الذي استٌدعي معه.  
+
عددٌ معاد من التابع <code>[[Ruby/Dir/tell|tell]]</code>.
 
+
==القيمة المعادة==
== أمثلة ==
+
يعاد الكائن <code>Dir</code>  المعطى بعد إعادة ضبط موضع المؤشر فيه.
مثال عن استخدام التابع <code>seek:</code><syntaxhighlight lang="ruby">
+
==أمثلة==
d = Dir.new("testdir")
+
مثال عن استخدام التابع <code>seek</code> على المجلد <code>testdir</code> الذي يحوي ملفين عاديين (<code>config.h</code> و <code>main.rb</code>)، والمجلد الأب (<code>..</code>)، والمجلد نفسه (<code>.</code>):<syntaxhighlight lang="ruby">
d.tell   #=> 0
+
d = Dir.new("testdir")   #=> #<Dir:0x401b3c40>
d.read   #=> "."
+
d.read                  #=> "."
d.tell  #=> 12
+
i = d.tell               #=> 12
 +
d.read                   #=> ".."
 +
d.seek(i)                #=> #<Dir:0x401b3c40>
 +
d.read                  #=> ".."
 
</syntaxhighlight>
 
</syntaxhighlight>
 
+
==انظر أيضًا==
== أنظر أيضًا ==
+
*التابع <code>[[Ruby/Dir/pos|pos]]</code>: يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه.
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
+
==مصادر==
 
+
*[http://ruby-doc.org/core-2.5.1/Dir.html#method-i-seek قسم التابع seek في الصنف Dir في توثيق روبي الرسمي.]
* التابع <code>[[Ruby/Dir/getwd|getwd]]</code>: يعيد التابع <code>getwd</code> مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية. 
 
* التابع <code>[[uby/Dir/seek|seek]]</code>: يذهب إلى موضع محدد في الكائن من صنف <code>Dir</code>  الذي استٌدعي معه.
 
 
 
== مصادر ==
 
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-i-pos قسم التابع seek في الصنف Dir في توثيق روبي الرسمي.]
 

المراجعة الحالية بتاريخ 08:35، 11 نوفمبر 2018

يذهب التابع seek إلى موضع محدد في المجلد الذي استٌدعي معه.

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

seek( integer )  dir

ينبغي أن يكون الوسيط integer عددًا معادًا من التابع tell.

المعاملات

integer 

عددٌ معاد من التابع tell.

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

يعاد الكائن Dir المعطى بعد إعادة ضبط موضع المؤشر فيه.

أمثلة

مثال عن استخدام التابع seek على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.):

d = Dir.new("testdir")   #=> #<Dir:0x401b3c40>
d.read                   #=> "."
i = d.tell               #=> 12
d.read                   #=> ".."
d.seek(i)                #=> #<Dir:0x401b3c40>
d.read                   #=> ".."

انظر أيضًا

  • التابع pos: يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه.

مصادر