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

المراجعة الحالية بتاريخ 07:19، 22 ديسمبر 2018

يحاول التابع try_convert تحويل الكائن المُمرَّر إليه إلى مجرى د/خ باستخدام التابع to_io.

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

try_convert(obj)  → io or nil‎

المعاملات

`obj‎`

كائن يراد تحويله إلى كائن من النوع IO.

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

يعاد المجرى المُحوّل عن الكائن obj، أو تعاد القيمة nil إذا تعذر تحويل الكائن obj لأي سبب من الأسباب.

أمثلة

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

IO.try_convert(STDOUT)     #=> STDOUT
IO.try_convert("STDOUT")   #=> nil
require 'zlib'
f = open("/tmp/zz.gz")       #=> #<File:/tmp/zz.gz>
z = Zlib::GzipReader.open(f) #=> #<Zlib::GzipReader:0x81d8744>
IO.try_convert(z)            #=> #<File:/tmp/zz.gz>‎

انظر أيضًا

التابع copy_stream: ينسخ بيانات من مجرى إلى مجرى آخر.

التابع new: ينشئ كائنًا جديدًا من النوع IO.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>try_convert‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>IO.try_convert‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يحاول التابع <code>try_convert</code> تحويل الوسيط <code>obj</code> (انظر فقرة البنية العامة) إلى [[Ruby/IO|مجرى د/خ]] (<code>[[Ruby/IO|IO]]</code>)، باستخدام التابع <code>[[Ruby/IO/to_io|#to_io]]</code>. تم يعيد [[Ruby/IO|مجرى د/خ]] <code>[[Ruby/IO|IO]]</code> المُحوّل، أو يعيد <code>nil</code> إذا تعذر تحويل <code>obj</code> لأي سبب من الأسباب.
+يحاول التابع <code>try_convert</code> تحويل الكائن المُمرَّر إليه إلى [[Ruby/IO|مجرى د/خ]] باستخدام التابع <code>[[Ruby/IO/to_io|to_io]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">try_convert(obj)  → io or nil‎</syntaxhighlight>
 ==المعاملات==
 ===<code>obj‎</code>===
-==القيمة المُعادة==
+كائن يراد تحويله إلى كائن من النوع <code>[[Ruby/IO|IO]]</code>.
+==القيمة المعادة==
+يعاد [[Ruby/IO|المجرى]] المُحوّل عن الكائن <code>obj</code>، أو تعاد القيمة <code>nil</code> إذا تعذر تحويل الكائن <code>obj</code> لأي سبب من الأسباب.
 ==أمثلة==
 مثال على استخدام التابع <code>try_convert‎</code>:
@@ سطر 17: / سطر 21: @@
 z = Zlib::GzipReader.open(f) #=> #<Zlib::GzipReader:0x81d8744>
 IO.try_convert(z)            #=> #<File:/tmp/zz.gz>‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/IO/sysopen|sysopen]]</code>: يفتح التابع <code>sysopen</code> المسار المحدد، ثم يعيد واصف الملف الأساسي ك[[Ruby/Integer|عدد صحيح]] <code>[[Ruby/Integer|Integer]]</code>.
+* التابع [[Ruby/IO/copy stream|<code>copy_stream</code>]]: ينسخ بيانات من مجرى إلى مجرى آخر.
-* التابع <code>[[Ruby/IO/write|write]]</code>: يفتح التابع <code>write</code> الملف، ويتموضع (seeks) اختياريا عند الإزاحة <code>offset</code> المعطاة (انظر فقرة البنية العامة)، ثم يكتب <code>string</code>، ثم يعيد طول [[Ruby/String|السلسلة النصية]] المكتوبة. يضمن التابع <code>write</code> أن يُغلق الملف قبل العودة. إذا لم يتم إعطاء <code>offset</code> في وضع الكتابة (write mode)، سيتم اقتطاع الملف. خلاف ذلك، لا يُقتطع.
+* التابع <code>[[Ruby/IO/new|new]]</code>: ينشئ كائنًا جديدًا من النوع <code>IO</code>.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-try_convert قسم  التابع try_convert‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-try_convert قسم التابع try_convert‎ في الصنف IO‎ في توثيق روبي الرسمي.]