الفرق بين المراجعتين ل"Ruby/Encoding::Converter"
(أنشأ الصفحة ب'{{DISPLAYTITLE:الصنف Encoding::Converter في روبي}} == الثوابت == === AFTER_OUTPUT === يوقف الثّابت AFTER_OUTPUT عمليّة التحوي...') |
جميل-بيلوني (نقاش | مساهمات) ط |
||
(12 مراجعة متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | {{DISPLAYTITLE:الصنف Encoding::Converter في روبي}} | + | يُستعمَل الصنف <code>Encoding::Converter</code> في عمليات تحويل الترميز في السلاسل النصية. |
− | + | {{DISPLAYTITLE:الصنف <code>Encoding::Converter</code> في روبي}} | |
== الثوابت == | == الثوابت == | ||
− | === AFTER_OUTPUT === | + | === <code>AFTER_OUTPUT</code> === |
− | يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. | + | يوقف الثّابت <code>AFTER_OUTPUT</code> عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> للاطلاع على مثال. |
− | === CRLF_NEWLINE_DECORATOR === | + | === <code>CRLF_NEWLINE_DECORATOR</code> === |
− | يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF. | + | يمثّل الثابت <code>CRLF_NEWLINE_DECORATOR</code> مُزخرِف (decorator) يُحوِّل من <code>LF</code> إلى <code>CRLF</code>. |
− | === CR_NEWLINE_DECORATOR === | + | === <code>CR_NEWLINE_DECORATOR</code> === |
− | يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR. | + | يمثّل الثابت <code>CR_NEWLINE_DECORATOR</code> مُزخرِف (decorator) يُحوِّل من <code>LF</code> إلى <code>CR</code>. |
− | === INVALID_MASK === | + | === <code>INVALID_MASK</code> === |
− | يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). | + | يمثِّل الثابت <code>INVALID_MASK</code> قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). |
− | === INVALID_REPLACE === | + | === <code>INVALID_REPLACE</code> === |
− | يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة. | + | يستبدل الثّابت <code>INVALID_REPLACE</code> سلاسل البايت غير الصالحة. |
− | === PARTIAL_INPUT === | + | === <code>PARTIAL_INPUT</code> === |
− | يُشير الثّابت PARTIAL_INPUT إلى أنَّ المصدر قد يكون جزءًا من سلسلةٍ نصّيةٍ أكبر. انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. | + | يُشير الثّابت <code>PARTIAL_INPUT</code> إلى أنَّ المصدر قد يكون جزءًا من سلسلةٍ نصّيةٍ أكبر. انتقل إلى صفحة التابع <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> للاطلاع على مثال. |
− | === UNDEF_HEX_CHARREF === | + | === <code>UNDEF_HEX_CHARREF</code> === |
− | يَستبدِل الثّابت UNDEF_HEX_CHARREF سلاسل البايت غير المعرَّفة في التّرميز الوجهة بمرجع XML لمحرف ست عشري (XML hexadecimal character reference). يصلح هذا الثّابت في تحويلات XML. | + | يَستبدِل الثّابت <code>UNDEF_HEX_CHARREF</code> سلاسل البايت غير المعرَّفة في التّرميز الوجهة بمرجع <code>XML</code> لمحرف ست عشري (XML hexadecimal character reference). يصلح هذا الثّابت في تحويلات <code>XML</code>. |
− | === UNDEF_MASK === | + | === <code>UNDEF_MASK</code> === |
− | يُمثِّل الثابت UNDEF_MASK قناعًا لمحارف موجودةٍ في التّرميز المصدر ولكن لا يوجد لها محارف ذات صلةٍ في التّرميز الوجهة. | + | يُمثِّل الثابت <code>UNDEF_MASK</code> قناعًا لمحارف موجودةٍ في التّرميز المصدر ولكن لا يوجد لها محارف ذات صلةٍ في التّرميز الوجهة. |
− | === UNDEF_REPLACE === | + | === <code>UNDEF_REPLACE</code> === |
− | يَستبدِل الثّابت UNDEF_REPLACE سلاسل البايت غير المعرَّفة في التّرميز الوجهة. | + | يَستبدِل الثّابت <code>UNDEF_REPLACE</code> سلاسل البايت غير المعرَّفة في التّرميز الوجهة. |
− | === UNIVERSAL_NEWLINE_DECORATOR === | + | === <code>UNIVERSAL_NEWLINE_DECORATOR</code> === |
− | يمثّل الثابت UNIVERSAL_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من CRLF و CR إلى LF. | + | يمثّل الثابت <code>UNIVERSAL_NEWLINE_DECORATOR</code> مُزخرِف (decorator) يُحوِّل من <code>CRLF</code> و <code>CR</code> إلى <code>LF</code>. |
− | === XML_ATTR_CONTENT_DECORATOR === | + | === <code>XML_ATTR_CONTENT_DECORATOR</code> === |
− | يُمثِّل الثابت XML_ATTR_CONTENT_DECORATOR هروبًا على شكل XML AttValue. | + | يُمثِّل الثابت <code>XML_ATTR_CONTENT_DECORATOR</code> هروبًا على شكل <code>XML AttValue</code>. |
− | === XML_ATTR_QUOTE_DECORATOR === | + | === <code>XML_ATTR_QUOTE_DECORATOR</code> === |
− | يُمثِّل الثابت XML_ATTR_QUOTE_DECORATOR هروبًا على شكل XML AttValue. | + | يُمثِّل الثابت <code>XML_ATTR_QUOTE_DECORATOR</code> هروبًا على شكل <code>XML AttValue</code>. |
− | === XML_TEXT_DECORATOR === | + | === <code>XML_TEXT_DECORATOR</code> === |
− | يُمثِّل الثابت XML_TEXT_DECORATOR هروبًا على شكل XML CharData. | + | يُمثِّل الثابت <code>XML_TEXT_DECORATOR</code> هروبًا على شكل <code>XML CharData</code>. |
== توابع الصنف العامة (Public Class Methods) == | == توابع الصنف العامة (Public Class Methods) == | ||
− | === asciicompat_encoding === | + | === <code>[[Ruby/Encoding/Converter/asciicompat encoding|asciicompat_encoding]]</code> === |
− | يُعيد | + | يُعيد التّرميز المتوافق مع <code>ASCII</code> المقابل للترميز المعطى. |
− | === new === | + | === <code>[[Ruby/Encoding/Converter/new|new]]</code> === |
− | يُنشئ | + | يُنشئ كائنًا جديدًا من الصنف <code>Encoding::Converter</code>. |
− | === search_convpath === | + | === <code>[[Ruby/Encoding/Converter/search convpath|search_convpath]]</code> === |
− | يُعيد | + | يُعيد مسار التحويل. |
== توابع الكائن العامة (Public Instance Methods) == | == توابع الكائن العامة (Public Instance Methods) == | ||
− | === | + | ====== المعامل <code>[[Ruby/Encoding/Converter/3D-3D|==]]</code> ====== |
+ | يتحقق من تساوي كائنين من الصنف <code>Encoding::Converter</code> مع بعضهما بعضًا. | ||
− | === | + | === <code>[[Ruby/Encoding/Converter/convert|convert]]</code> === |
− | يُحوِّل | + | يُحوِّل ترميز سلسلة نصية معينة. |
− | === convpath === | + | === <code>[[Ruby/Encoding/Converter/convpath|convpath]]</code> === |
− | يُعيد | + | يُعيد مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter. |
− | === destination_encoding === | + | === <code>[[Ruby/Encoding/Converter/destination encoding|destination_encoding]]</code> === |
− | يُعيد | + | يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف <code>Encoding</code>. |
− | === finish === | + | === <code>[[Ruby/Encoding/Converter/finish|finish]]</code> === |
− | يُنهي | + | يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك. |
− | === insert_output === | + | === <code>[[Ruby/Encoding/Converter/insert output|insert_output]]</code> === |
− | يضيف | + | يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل. |
− | === inspect === | + | === <code>[[Ruby/Encoding/Converter/inspect|inspect]]</code> === |
− | يُعيد | + | يُعيد نسخةً قابلةً للطباعة من الكائن <code>Encoding::Converter</code>. |
− | === last_error === | + | === <code>[[Ruby/Encoding/Converter/last error|last_error]]</code> === |
− | يُعيد | + | يُعيد الكائن <code>exception</code> عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة <code>nil</code> إن لم يحصل أي خطأ. |
− | === primitive_convert === | + | === <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> === |
− | يحوّل | + | يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد. |
− | === primitive_errinfo === | + | === <code>[[Ruby/Encoding/Converter/primitive errinfo|primitive_errinfo]]</code> === |
− | يُعيد | + | يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر. |
− | === putback === | + | === <code>[[Ruby/Encoding/Converter/putback|putback]]</code> === |
− | يُعيد | + | يُعيد البايتات التي ستُحوَّل. |
− | === replacement:: === | + | === <code>[[Ruby/Encoding/Converter/replacement|replacement::]]</code> === |
− | يُعيد | + | يُعيد سلسلة الاستبدال النصية. |
− | === replacement === | + | === <code>[[Ruby/Encoding/Converter/replacement-3D|replacement]]</code> === |
− | يضبط | + | يضبط سلسلة الاستبدال النصية. |
− | === source_encoding === | + | === <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
.