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

المراجعة الحالية بتاريخ 13:07، 21 نوفمبر 2018

يُستعمَل الصنف Encoding::Converter في عمليات تحويل الترميز في السلاسل النصية.

الثوابت

`AFTER_OUTPUT`

يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال.

`CRLF_NEWLINE_DECORATOR`

يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF.

`CR_NEWLINE_DECORATOR`

يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR.

`INVALID_MASK`

يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences).

`INVALID_REPLACE`

يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة.

`PARTIAL_INPUT`

يُشير الثّابت PARTIAL_INPUT إلى أنَّ المصدر قد يكون جزءًا من سلسلةٍ نصّيةٍ أكبر. انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال.

`UNDEF_HEX_CHARREF`

يَستبدِل الثّابت UNDEF_HEX_CHARREF سلاسل البايت غير المعرَّفة في التّرميز الوجهة بمرجع XML لمحرف ست عشري (XML hexadecimal character reference). يصلح هذا الثّابت في تحويلات XML.

`UNDEF_MASK`

يُمثِّل الثابت UNDEF_MASK قناعًا لمحارف موجودةٍ في التّرميز المصدر ولكن لا يوجد لها محارف ذات صلةٍ في التّرميز الوجهة.

`UNDEF_REPLACE`

يَستبدِل الثّابت UNDEF_REPLACE سلاسل البايت غير المعرَّفة في التّرميز الوجهة.

`UNIVERSAL_NEWLINE_DECORATOR`

يمثّل الثابت UNIVERSAL_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من CRLF و CR إلى LF.

`XML_ATTR_CONTENT_DECORATOR`

يُمثِّل الثابت XML_ATTR_CONTENT_DECORATOR هروبًا على شكل XML AttValue.

`XML_ATTR_QUOTE_DECORATOR`

يُمثِّل الثابت XML_ATTR_QUOTE_DECORATOR هروبًا على شكل XML AttValue.

`XML_TEXT_DECORATOR`

يُمثِّل الثابت XML_TEXT_DECORATOR هروبًا على شكل XML CharData.

توابع الصنف العامة (Public Class Methods)

`asciicompat_encoding`

يُعيد التّرميز المتوافق مع ASCII المقابل للترميز المعطى.

`new`

يُنشئ كائنًا جديدًا من الصنف Encoding::Converter.

`search_convpath`

يُعيد مسار التحويل.

توابع الكائن العامة (Public Instance Methods)

المعامل `==`

يتحقق من تساوي كائنين من الصنف Encoding::Converter مع بعضهما بعضًا.

`convert`

يُحوِّل ترميز سلسلة نصية معينة.

`convpath`

يُعيد مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter.

`destination_encoding`

يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف Encoding.

`finish`

يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.

`insert_output`

يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.

`inspect`

يُعيد نسخةً قابلةً للطباعة من الكائن Encoding::Converter.

`last_error`

يُعيد الكائن exception عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة nil إن لم يحصل أي خطأ.

`primitive_convert`

يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.

`primitive_errinfo`

يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.

`putback`

يُعيد البايتات التي ستُحوَّل.

`replacement::`

يُعيد سلسلة الاستبدال النصية.

`replacement`

يضبط سلسلة الاستبدال النصية.

`source_encoding`

يُعيد الترميز المصدر على شكل كائن من الصنف Encoding.

مصادر

الصنف Encoding::Converter في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
+يُستعمَل الصنف <code>Encoding::Converter</code> في عمليات تحويل الترميز في السلاسل النصية.
 {{DISPLAYTITLE:الصنف <code>Encoding::Converter</code> في روبي}}
 == الثوابت ==
@@ سطر 44: / سطر 45: @@
 === <code>[[Ruby/Encoding/Converter/asciicompat encoding|asciicompat_encoding]]</code> ===
-يُعيد التّابع <code>asciicompat_encoding</code> التّرميز المتوافق مع <code>ASCII</code> المقابل للترميز المعطى.
+يُعيد التّرميز المتوافق مع <code>ASCII</code> المقابل للترميز المعطى.
 === <code>[[Ruby/Encoding/Converter/new|new]]</code> ===
-يُنشئ التّابع <code>new</code> كائنًا جديدًا من الصنف <code>Encoding::Converter</code>.
+يُنشئ كائنًا جديدًا من الصنف <code>Encoding::Converter</code>.
 === <code>[[Ruby/Encoding/Converter/search convpath|search_convpath]]</code> ===
-يُعيد التّابع <code>search_convpath</code> مسار التحويل.
+يُعيد مسار التحويل.
 == توابع الكائن العامة (Public Instance Methods) ==
-====== <code>[[Ruby/Encoding/Converter/3D-3D|==]]</code> ======
+====== المعامل <code>[[Ruby/Encoding/Converter/3D-3D|==]]</code> ======
-يتحقق المعامل<code>==</code> من تساوي كائنين من الصنف <code>Encoding::Converter</code> مع بعضهما بعضًا.
+يتحقق من تساوي كائنين من الصنف <code>Encoding::Converter</code> مع بعضهما بعضًا.
-=== <code>[[wiki.hsoub.com/Ruby/Encoding/Converter/convert|convert]]</code> ===
+=== <code>[[Ruby/Encoding/Converter/convert|convert]]</code> ===
-يُحوِّل التابع <code>convert</code> ترميز سلسلة نصية معينة.
+يُحوِّل ترميز سلسلة نصية معينة.
 === <code>[[Ruby/Encoding/Converter/convpath|convpath]]</code> ===
-يُعيد التّابع <code>convpath</code> مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter.
+يُعيد مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter.
 === <code>[[Ruby/Encoding/Converter/destination encoding|destination_encoding]]</code> ===
-يُعيد التّابع <code>destination_encoding</code> التّرميز الوجهة على شكل كائنٍ من الصنف <code>Encoding</code>.
+يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف <code>Encoding</code>.
 === <code>[[Ruby/Encoding/Converter/finish|finish]]</code> ===
-يُنهي التّابع <code>finish</code> محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.
+يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.
 === <code>[[Ruby/Encoding/Converter/insert output|insert_output]]</code> ===
-يضيف التّابع <code>insert_output</code> سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.
+يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.
 === <code>[[Ruby/Encoding/Converter/inspect|inspect]]</code> ===
-يُعيد التّابع <code>inspect</code> نسخةً قابلةً للطباعة من الكائن <code>Encoding::Converter</code>.
+يُعيد نسخةً قابلةً للطباعة من الكائن <code>Encoding::Converter</code>.
 === <code>[[Ruby/Encoding/Converter/last error|last_error]]</code> ===
-يُعيد التّابع <code>last_error</code> الكائن <code>exception</code> عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة <code>nil</code> إن لم يحصل أي خطأ.
+يُعيد الكائن <code>exception</code> عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة <code>nil</code> إن لم يحصل أي خطأ.
 === <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> ===
-يحوّل التابع <code>primitive_convert</code> ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.
+يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.
 === <code>[[Ruby/Encoding/Converter/primitive errinfo|primitive_errinfo]]</code> ===
-يُعيد التّابع <code>primitive_errinfo</code> معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.
+يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.
 === <code>[[Ruby/Encoding/Converter/putback|putback]]</code> ===
-يُعيد التّابع <code>putback</code> البايتات التي ستُحوَّل.
+يُعيد البايتات التي ستُحوَّل.
 === <code>[[Ruby/Encoding/Converter/replacement|replacement::]]</code> ===
-يُعيد التّابع <code>replacement</code> سلسلة الاستبدال النصية.
+يُعيد سلسلة الاستبدال النصية.
 === <code>[[Ruby/Encoding/Converter/replacement-3D|replacement]]</code> ===
-يضبط التّابع <code>replacement</code> سلسلة الاستبدال النصية.
+يضبط سلسلة الاستبدال النصية.
 === <code>[[Ruby/Encoding/Converter/source encoding|source_encoding]]</code> ===
-يُعيد التّابع <code>source_encoding</code> الترميز المصدر على شكل كائن من الصنف <code>Encoding</code>.
+يُعيد الترميز المصدر على شكل كائن من الصنف <code>Encoding</code>.
 == مصادر ==
@@ سطر 100: / سطر 101: @@
 [[تصنيف:Ruby]]
 [[تصنيف:Ruby Class]]
+[[تصنيف:Ruby Encoding]]
 [[تصنيف:Ruby Encoding::Converter]]

المراجعة الحالية بتاريخ 13:07، 21 نوفمبر 2018

الثوابت

AFTER_OUTPUT

CRLF_NEWLINE_DECORATOR

CR_NEWLINE_DECORATOR

INVALID_MASK

INVALID_REPLACE

PARTIAL_INPUT

UNDEF_HEX_CHARREF

UNDEF_MASK

UNDEF_REPLACE

UNIVERSAL_NEWLINE_DECORATOR

XML_ATTR_CONTENT_DECORATOR

XML_ATTR_QUOTE_DECORATOR

XML_TEXT_DECORATOR