الفرق بين المراجعتين ل"Ruby/Encoding::Converter"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
 
(11 مراجعة متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
−
{{DISPLAYTITLE:الصنف Encoding::Converter في روبي}}
+
يُستعمَل الصنف <code>Encoding::Converter</code> في عمليات تحويل الترميز في السلاسل النصية.
−
 
+
{{DISPLAYTITLE:الصنف <code>Encoding::Converter</code> في روبي}}
 
== الثوابت ==
 
== الثوابت ==
  
سطر 44: سطر 44:
 
== توابع الصنف العامة (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.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Ruby/Encoding::Converter&oldid=24243"