الفرق بين المراجعتين ل"Ruby/IO/try convert"

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>try_convert‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>IO.try_convert‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: Ruby IO]]
يحاول التابع <code>try_convert</code> تحويل الوسيط <code>obj</code> (انظر فقرة البنية العامة) إلى [[Ruby/IO|مجرى د/خ]] باستخدام التابع <code>[[Ruby/IO/to_io|to_io]]</code>. تم يعيد [[Ruby/IO|المجرى]]  المُحوّل، أو يعيد <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>
 
<syntaxhighlight lang="ruby">try_convert(obj)  → io or nil‎</syntaxhighlight>
 
==المعاملات==
 
==المعاملات==
 
===<code>obj‎</code>===
 
===<code>obj‎</code>===
كائن.
+
كائن يراد تحويله إلى كائن من النوع <code>[[Ruby/IO|IO]]</code>.
  
==القيمة المُعادة==
+
==القيمة المعادة==
يعيد التابع <code>try_convert</code>  [[Ruby/IO|المجرى]] المُحوّل، أو يعيد <code>nil</code> إذا تعذر تحويل <code>obj</code> لأي سبب من الأسباب.
+
يعاد [[Ruby/IO|المجرى]] المُحوّل عن الكائن <code>obj</code>، أو تعاد القيمة <code>nil</code> إذا تعذر تحويل الكائن <code>obj</code> لأي سبب من الأسباب.
  
 
==أمثلة==
 
==أمثلة==
سطر 21: سطر 21:
 
z = Zlib::GzipReader.open(f) #=> #<Zlib::GzipReader:0x81d8744>
 
z = Zlib::GzipReader.open(f) #=> #<Zlib::GzipReader:0x81d8744>
 
IO.try_convert(z)            #=> #<File:/tmp/zz.gz>‎</syntaxhighlight>
 
IO.try_convert(z)            #=> #<File:/tmp/zz.gz>‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <code>[[Ruby/IO/new|new]]</code>: يُعيد التابع <code>new</code> كائنًا جديدًا من النوع <code>IO</code> 
+
* التابع [[Ruby/IO/copy stream|<code>copy_stream</code>]]: ينسخ بيانات من مجرى إلى مجرى آخر.
 +
 
 +
* التابع <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‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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.

مصادر