الصنف 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
يتحقق التابع 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) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.
primitive_errinfo
يُعيد التّابع primitive_errinfo
معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.
putback
يُعيد التّابع putback
البايتات التي ستُحوَّل.
replacement::
يُعيد التّابع replacement
سلسلة الاستبدال النصية.
replacement
يضبط التّابع replacement
سلسلة الاستبدال النصية.
source_encoding
يُعيد التّابع source_encoding
الترميز المصدر على شكل كائن من الصنف Encoding
.