الفرق بين المراجعتين لصفحة: «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> ===
يُعيد التّابع asciicompat_encoding التّرميز المتوافق مع ASCII المقابل للترميز المعطى.
يُعيد التّرميز المتوافق مع <code>ASCII</code> المقابل للترميز المعطى.


=== new ===
=== <code>[[Ruby/Encoding/Converter/new|new]]</code> ===
يُنشئ التّابع new كائنًا جديدًا من الصنف Encoding::Converter.
يُنشئ كائنًا جديدًا من الصنف <code>Encoding::Converter</code>.


=== search_convpath ===
=== <code>[[Ruby/Encoding/Converter/search convpath|search_convpath]]</code> ===
يُعيد التّابع search_convpath مسار التحويل.
يُعيد مسار التحويل.


== توابع الكائن العامة (Public Instance Methods) ==
== توابع الكائن العامة (Public Instance Methods) ==


=== ec ===
====== المعامل <code>[[Ruby/Encoding/Converter/3D-3D|==]]</code> ======
يتحقق من تساوي كائنين من الصنف <code>Encoding::Converter</code> مع بعضهما بعضًا.


=== التابع convert ===
=== <code>[[Ruby/Encoding/Converter/convert|convert]]</code> ===
يُحوِّل التابع convert ترميز سلسلة نصية معينة.
يُحوِّل ترميز سلسلة نصية معينة.


=== convpath ===
=== <code>[[Ruby/Encoding/Converter/convpath|convpath]]</code> ===
يُعيد التّابع convpath مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter.
يُعيد مسار التّحويلِ الخاصَّ بالكائن من الصنف Converter.


=== destination_encoding ===
=== <code>[[Ruby/Encoding/Converter/destination encoding|destination_encoding]]</code> ===
يُعيد التّابع destination_encoding التّرميز الوجهة على شكل كائنٍ من الصنف Encoding.
يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف <code>Encoding</code>.


=== finish ===
=== <code>[[Ruby/Encoding/Converter/finish|finish]]</code> ===
يُنهي التّابع finish محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.
يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.


=== insert_output ===
=== <code>[[Ruby/Encoding/Converter/insert output|insert_output]]</code> ===
يضيف التّابع insert_output سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.
يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.


=== inspect ===
=== <code>[[Ruby/Encoding/Converter/inspect|inspect]]</code> ===
يُعيد التّابع inspect نسخةً قابلةً للطباعة من الكائن Encoding::Converter.
يُعيد نسخةً قابلةً للطباعة من الكائن <code>Encoding::Converter</code>.


=== last_error ===
=== <code>[[Ruby/Encoding/Converter/last error|last_error]]</code> ===
يُعيد التّابع last_error الكائن exception عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة nil إن لم يحصل أي خطأ.
يُعيد الكائن <code>exception</code> عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة <code>nil</code> إن لم يحصل أي خطأ.


=== primitive_convert ===
=== <code>[[Ruby/Encoding/Converter/primitive convert|primitive_convert]]</code> ===
يحوّل التابع primitive_convert ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.
يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.


=== primitive_errinfo ===
=== <code>[[Ruby/Encoding/Converter/primitive errinfo|primitive_errinfo]]</code> ===
يُعيد التّابع primitive_errinfo معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.
يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر.


=== putback ===
=== <code>[[Ruby/Encoding/Converter/putback|putback]]</code> ===
يُعيد التّابع putback البايتات التي ستُحوَّل.
يُعيد البايتات التي ستُحوَّل.


=== replacement:: ===
=== <code>[[Ruby/Encoding/Converter/replacement|replacement::]]</code> ===
يُعيد التّابع replacement سلسلة الاستبدال النصية.
يُعيد سلسلة الاستبدال النصية.


=== replacement ===
=== <code>[[Ruby/Encoding/Converter/replacement-3D|replacement]]</code> ===
يضبط التّابع replacement سلسلة الاستبدال النصية.
يضبط سلسلة الاستبدال النصية.


=== source_encoding ===
=== <code>[[Ruby/Encoding/Converter/source encoding|source_encoding]]</code> ===
يُعيد التّابع source_encoding الترميز المصدر على شكل كائن من الصنف Encoding.
يُعيد الترميز المصدر على شكل كائن من الصنف <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.

مصادر