الصنف `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`

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

`new`

يُنشئ التّابع new كائنًا جديدًا من الصنف Encoding::Converter.

`search_convpath`

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

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

`==`

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

`convert`

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

`convpath`

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

`destination_encoding`

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

`finish`

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

`insert_output`

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

`inspect`

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

`last_error`

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

`primitive_convert`

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