الفرق بين المراجعتين لصفحة: «Ruby/IO/set encoding»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
في | يضبط التابع <code>set_encoding</code> الترميز الداخلي والخارجي في [[Ruby/IO|المجرى]] الذي استدعي معه. | ||
إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين "<code>A:B</code>"، فستُحوّل [[Ruby/String|السلسلة النصية]] المقروءة من الترميز <code>A</code> (الترميز الخارجي) إلى الترميز <code>B</code> (الترميز الداخلي)، ثم ستوسم بالترميز <code>B</code>. | في حال تمرير وسيط واحد إلى التابع، فستوسم [[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 | ||
| سطر 14: | سطر 16: | ||
==المعاملات== | ==المعاملات== | ||
===<code>ext_enc</code>=== | ===<code>ext_enc</code>=== | ||
الترميز الخارجي | كائن من النوع <code>[[Ruby/Encoding|Encoding]]</code> أو اسم ترميز صالح يحدد الترميز الخارجي المراد ضبطه في المجرى. | ||
===<code>int_enc</code>=== | ===<code>int_enc</code>=== | ||
الترميز الداخلي | كائن من النوع <code>[[Ruby/Encoding|Encoding]]</code> أو اسم ترميز صالح يحدد الترميز الداخلي المراد ضبطه في المجرى. | ||
===<code>opt</code>=== | ===<code>opt</code>=== | ||
خيارات | خيارات التحويل بين الترميزين الداخلي والخارجي. | ||
==القيمة | ==القيمة المعادة== | ||
يعاد [[Ruby/IO| | يعاد [[Ruby/IO|المجرى]] المعطى بعد ضبط الترميز فيه. | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/IO/external encoding|external_encoding]]</code>: يُعيد كائن <nowiki/>[[Ruby/Encoding|الترميز]] الذي يمثل ترميز الملف. | * التابع <code>[[Ruby/IO/external encoding|external_encoding]]</code>: يُعيد كائن <nowiki/>[[Ruby/Encoding|الترميز]] الذي يمثل ترميز الملف. | ||
| سطر 28: | سطر 30: | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-set_encoding قسم | *[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
خيارات التحويل بين الترميزين الداخلي والخارجي.
القيمة المعادة
يعاد المجرى المعطى بعد ضبط الترميز فيه.
انظر أيضًا
- التابع
external_encoding: يُعيد كائن الترميز الذي يمثل ترميز الملف.
- التابع
internal_encoding: يعيد ترميز السلسلة النصية الداخلية..