الفرق بين المراجعتين لصفحة: «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
.