Ruby/Encoding/Converter/asciicompat encoding

يُعيد التّابع asciicompat_encoding التّرميز المتوافق مع ASCII المقابل للترميز المعطى.

هذا التّرميز المقابل الذي يعيده التابع هو ترميزٌ متوافقٌ مع ASCII يمثّل نفس المحارف تمامًا الموجودة في التّرميز المعطى غير المتوافق مع ASCII. بناءً على ذلك، لن يحدث أي خطأ عند التّحويل بين هذين التّرميزين.

البنية العامة

Encoding::Converter.asciicompat_encoding(string) → encoding or nil

Encoding::Converter.asciicompat_encoding(encoding) → encoding or nil

المعاملات

string

سلسلةٌ نصّيةٌ تمثل الترميز غير المتوافق مع ASCII.

encoding

كائن الترميز غير المتوافق مع ASCII.

القيم المعادة

يُعاد كائن من النوع Encoding يمثل الترميز المتوافق مع ASCII المقابل للترميز string أو encoding، أو تُعاد القيمة nil في حال كان التّرميز المعطى متوافقًا بالفعل مع ASCII.

أمثلة

مثالٌ عن استخدام التابع asciicompat_encoding‎:

Encoding::Converter.asciicompat_encoding("ISO-2022-JP") #=> #<Encoding:stateless-ISO-2022-JP>
Encoding::Converter.asciicompat_encoding("UTF-16BE") #=> #<Encoding:UTF-8>
Encoding::Converter.asciicompat_encoding("UTF-8") #=> nil

انظر أيضًا

• التّابع destination_encoding: يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف Encoding.
• التّابع source_encoding: يُعيد الترميز المصدر على شكل كائن من الصنف Encoding.
• التّابع primitive_convert: يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها ثم يضع الناتج في مخزَّن محدَّد.
• التّابع insert_output: يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحول ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.
• التّابع finish: يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.

مصادر

• صفحة التابع asciicompat_encoding‎ في الصنف Encoding::Converter في توثيق روبي الرسمي.