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

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) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.

primitive_errinfo

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

putback

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

replacement::

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

replacement

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

source_encoding

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

مصادر