الصنف Encoding::Converter في روبي

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

يُستعمَل الصنف 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.

مصادر