التابع 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") #=> nill
انظر أيضًا
- التّابع destination_encoding: يُعيد التّرميز الوجهة على شكل كائنٍ من الصنف Encoding.
- التّابع source_encoding: يُعيد الترميز المصدر على شكل كائن من الصنف Encoding.
- التّابع primitive_convert: يحوّل ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد.
- التّابع insert_output: يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتوضع في نهاية مخرجات عملية التحويل.
- التّابع finish: يُنهي محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك.