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