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

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.set_encoding‎</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف:...')
 
ط (تدقيق)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: Ruby IO]]
في حال تمرير وسيط واحد، فستوسم [[Ruby/String|السلسلة النصية]] المقروءة من [[Ruby/IO|مجرى د/خ]] وفق [[Ruby/Encoding|الترميز]] المحدد. إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين "A: B"، فستُحوّل [[Ruby/String|السلسلة النصية]] المقروءة من الترميز A (الترميز الخارجي) إلى الترميز B (الترميز الداخلي)، ثم توسم بـ B. في حال إعطاء وسيطين، فيجب أن يكونا كائني [[Ruby/Encoding|ترميز]]، أو اسمي ترميز، حيث يمثل أولها الترميز الخارجي، فيما يمثل ثانيهما الترميز الداخلي. في حال تحديد الترميز الخارجي والترميز الداخلي، فسيحدد الوسيط الاختياري opt خيارات التحويل.
+
يضبط التابع <code>set_encoding</code> الترميز الداخلي والخارجي في [[Ruby/IO|المجرى]] الذي استدعي معه.
 +
 
 +
في حال تمرير وسيط واحد إلى التابع، فستوسم [[Ruby/String|السلسلة النصية]] المقروءة من [[Ruby/IO|المجرى]] [[Ruby/Encoding|بالترميز]] المحدد.
 +
 
 +
إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين مثل "<code>A:B</code>"، فستُحوّل [[Ruby/String|السلسلة النصية]] المقروءة من الترميز <code>A</code> (الترميز الخارجي) إلى الترميز <code>B</code> (الترميز الداخلي)، ثم ستوسم بالترميز <code>B</code>. في حال تمرير وسيطين، فيجب أن يكونا كائني [[Ruby/Encoding|ترميز]]، أو اسمي ترميز، إذ يمثل أولهما الترميز الخارجي، فيما يمثل ثانيهما الترميز الداخلي. في حال تحديد الترميز الخارجي والترميز الداخلي، فسيحدد الوسيط الاختياري <code>opt</code> (انظر فقرة البنية العامة) خيارات التحويل.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">set_encoding(ext_enc) → io
 
<syntaxhighlight lang="ruby">set_encoding(ext_enc) → io
سطر 12: سطر 16:
 
==المعاملات==
 
==المعاملات==
 
===<code>ext_enc‎</code>===
 
===<code>ext_enc‎</code>===
الترميز الخارجي
+
كائن من النوع <code>[[Ruby/Encoding|Encoding]]</code> أو اسم ترميز صالح يحدد الترميز الخارجي المراد ضبطه في المجرى.
===<code>"ext_enc:int_enc"‎</code>===
 
 
===<code>int_enc‎</code>===
 
===<code>int_enc‎</code>===
الترميز الداخلي
+
كائن من النوع <code>[[Ruby/Encoding|Encoding]]</code> أو اسم ترميز صالح يحدد الترميز الداخلي المراد ضبطه في المجرى.
 
===<code>opt‎</code>===
 
===<code>opt‎</code>===
خيارات
+
خيارات التحويل بين الترميزين الداخلي والخارجي.
==القيمة المُعادة==
+
==القيمة المعادة==
==انظر أيضا==
+
يعاد [[Ruby/IO|المجرى]] المعطى بعد ضبط الترميز فيه.
* التابع <code>[[Ruby/IO/seek|seek]]</code>: يسعى  إلى التموضع عند الإزاحة المعطاة <code>anInteger</code> في [[Ruby/IO|مجرى د/خ]] وفقا لقيمة <code>whence</code> (انظر فقرة البنية العامة):
+
 
* التابع <code>[[Ruby/IO/stat|stat]]</code>: يُعيد  معلومات الحالة ل[[Ruby/IO|مجرى د/خ]] الذي استُدعي معه <code>ios</code> على هيئة كائن من النوع <code>File::Stat</code>.
+
==انظر أيضًا==
 +
* التابع <code>[[Ruby/IO/external encoding|external_encoding]]</code>: يُعيد  كائن <nowiki/>[[Ruby/Encoding|الترميز]] الذي يمثل ترميز الملف.
 +
 
 +
* التابع <code>[[Ruby/IO/internal encoding|internal_encoding]]</code>: يعيد ترميز السلسلة النصية الداخلية..
 +
 
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-set_encoding قسم التابع set_encoding‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-set_encoding قسم التابع set_encoding‎ في الصنف IO‎ في توثيق روبي الرسمي.]

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

يضبط التابع set_encoding الترميز الداخلي والخارجي في المجرى الذي استدعي معه.

في حال تمرير وسيط واحد إلى التابع، فستوسم السلسلة النصية المقروءة من المجرى بالترميز المحدد.

إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين مثل "A:B"، فستُحوّل السلسلة النصية المقروءة من الترميز A (الترميز الخارجي) إلى الترميز B (الترميز الداخلي)، ثم ستوسم بالترميز B. في حال تمرير وسيطين، فيجب أن يكونا كائني ترميز، أو اسمي ترميز، إذ يمثل أولهما الترميز الخارجي، فيما يمثل ثانيهما الترميز الداخلي. في حال تحديد الترميز الخارجي والترميز الداخلي، فسيحدد الوسيط الاختياري opt (انظر فقرة البنية العامة) خيارات التحويل.

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

set_encoding(ext_enc)  io
set_encoding("ext_enc:int_enc") io
set_encoding(ext_enc, int_enc)  io
set_encoding("ext_enc:int_enc", opt)  io
set_encoding(ext_enc, int_enc, opt)   io

المعاملات

ext_enc‎

كائن من النوع Encoding أو اسم ترميز صالح يحدد الترميز الخارجي المراد ضبطه في المجرى.

int_enc‎

كائن من النوع Encoding أو اسم ترميز صالح يحدد الترميز الداخلي المراد ضبطه في المجرى.

opt‎

خيارات التحويل بين الترميزين الداخلي والخارجي.

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

يعاد المجرى المعطى بعد ضبط الترميز فيه.

انظر أيضًا

  • التابع internal_encoding: يعيد ترميز السلسلة النصية الداخلية..

مصادر