الفرق بين المراجعتين لصفحة: «Ruby/Encoding::Converter»
طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (10 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
{{DISPLAYTITLE:الصنف Encoding::Converter في روبي}} | يُستعمَل الصنف <code>Encoding::Converter</code> في عمليات تحويل الترميز في السلاسل النصية. | ||
{{DISPLAYTITLE:الصنف <code>Encoding::Converter</code> في روبي}} | |||
== الثوابت == | == الثوابت == | ||
| سطر 44: | سطر 44: | ||
== توابع الصنف العامة (Public Class Methods) == | == توابع الصنف العامة (Public Class Methods) == | ||
=== <code>asciicompat_encoding</code> === | === <code>[[Ruby/Encoding/Converter/asciicompat encoding|asciicompat_encoding]]</code> === | ||
يُعيد | يُعيد التّرميز المتوافق مع <code>ASCII</code> المقابل للترميز المعطى. | ||
=== <code>new</code> === | === <code>[[Ruby/Encoding/Converter/new|new]]</code> === | ||
يُنشئ | يُنشئ كائنًا جديدًا من الصنف <code>Encoding::Converter</code>. | ||
=== <code>search_convpath</code> === | === <code>[[Ruby/Encoding/Converter/search convpath|search_convpath]]</code> === | ||
يُعيد | يُعيد مسار التحويل. | ||
== توابع الكائن العامة (Public Instance Methods) == | == توابع الكائن العامة (Public Instance Methods) == | ||
=== <code> | ====== المعامل <code>[[Ruby/Encoding/Converter/3D-3D|==]]</code> ====== | ||
يتحقق من تساوي كائنين من الصنف <code>Encoding::Converter</code> مع بعضهما بعضًا. | |||
=== <code>convert</code> === | === <code>[[Ruby/Encoding/Converter/convert|convert]]</code> === | ||
يُحوِّل | يُحوِّل ترميز سلسلة نصية معينة. | ||
=== <code>convpath</code> === | === <code>[[Ruby/Encoding/Converter/convpath|convpath]]</code> === | ||
يُعيد | يُعيد مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter. | ||
=== <code>destination_encoding</code> === | === <code>[[Ruby/Encoding/Converter/destination encoding|destination_encoding]]</code> === | ||
يُعيد | يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف <code>Encoding</code>. | ||
=== <code>finish</code> === | === <code>[[Ruby/Encoding/Converter/finish|finish]]</code> === | ||
يُنهي | يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك. | ||
=== <code>insert_output</code> === | === <code>[[Ruby/Encoding/Converter/insert output|insert_output]]</code> === | ||
يضيف | يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل. | ||
=== <code>inspect</code> === | === <code>[[Ruby/Encoding/Converter/inspect|inspect]]</code> === | ||
يُعيد | يُعيد نسخةً قابلةً للطباعة من الكائن <code>Encoding::Converter</code>. | ||
=== <code>last_error</code> === | === <code>[[Ruby/Encoding/Converter/last error|last_error]]</code> === | ||
يُعيد | يُعيد الكائن <code>exception</code> عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة <code>nil</code> إن لم يحصل أي خطأ. | ||
=== <code>primitive_convert</code> === | === <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> === | ||
يحوّل | يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد. | ||
=== <code>primitive_errinfo</code> === | === <code>[[Ruby/Encoding/Converter/primitive errinfo|primitive_errinfo]]</code> === | ||
يُعيد | يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر. | ||
=== <code>putback</code> === | === <code>[[Ruby/Encoding/Converter/putback|putback]]</code> === | ||
يُعيد | يُعيد البايتات التي ستُحوَّل. | ||
=== <code>replacement::</code> === | === <code>[[Ruby/Encoding/Converter/replacement|replacement::]]</code> === | ||
يُعيد | يُعيد سلسلة الاستبدال النصية. | ||
=== <code>replacement</code> === | === <code>[[Ruby/Encoding/Converter/replacement-3D|replacement]]</code> === | ||
يضبط | يضبط سلسلة الاستبدال النصية. | ||
=== <code>source_encoding</code> === | === <code>[[Ruby/Encoding/Converter/source encoding|source_encoding]]</code> === | ||
يُعيد | يُعيد الترميز المصدر على شكل كائن من الصنف <code>Encoding</code>. | ||
== مصادر == | == مصادر == | ||
| سطر 100: | سطر 101: | ||
[[تصنيف:Ruby]] | [[تصنيف:Ruby]] | ||
[[تصنيف:Ruby Class]] | [[تصنيف:Ruby Class]] | ||
[[تصنيف:Ruby Encoding]] | |||
[[تصنيف:Ruby Encoding::Converter]] | [[تصنيف:Ruby Encoding::Converter]] | ||
المراجعة الحالية بتاريخ 13:07، 21 نوفمبر 2018
يُستعمَل الصنف 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.