نتائج البحث

يضيف التّابع insert_output سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيُحول ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتُوضع في نهاية مخرجات عملية التحويل. إذا كان التّرميز الوجهة هو من أحد الترميزات التي لها حالة (stateful encodings)، فستُحوَّل السلسلة حسب حالة الترميز وتُحدَّث الحالة بعدئذٍ. لا يجب استخدام هذا التّابع إلا عند حدوث أخطاء في عملية التحويل. البنية العامة insert_output(string) → nil المعاملات string السلسلة النصيّة المراد إدخالها في محوَّل الترميز. القيم المعادة تعاد القيمة nil بعد إضافة السلسلة النصية string ...

يُعيد التّابع source_encoding_name اسم التّرميز المصدر. البنية العامة source_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز المصدر. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف على شكل كائن. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التابع error_char: يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. التّابع source_encoding: يعيد التّرميز المصدر. مصادر صفحة التابع source_encoding_name في الصنف Encoding::UndefinedConversionError في توثيق روبي الرسمي.

يُعيد التّابع primitive_errinfo معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر مثل: [result, enc1, enc2, error_bytes, readagain_bytes] تكون result هي آخر نتيجة تحويل للتّابع primitive_convert. تكون العناصر الأخرى ذات معنى فقط عندما تكون result هي invalid_byte_sequence:، أو incomplete_input:، أو undefined_conversion:. تدلُّ القيمتان enc1 و enc2 على خطوة التحويل على شكل زوجٍ من السلاسل النصيّة. على سبيل المثال، يحول محولٌ (converter) من التّرميز EUC-JP إلى الترميز ISO-8859-1 سلسلة نصية بالشكل التالي: EUC-JP -> UTF-8 -> ISO-8859-1. إذًا، تكون ...

يُعيد التّابع search_convpath مسار التحويل. البنية العامة Encoding::Converter.search_convpath(source_encoding, destination_encoding) → ary Encoding::Converter.search_convpath(source_encoding, destination_encoding, opt) → ary المعاملات source_encoding كائنٌ يمثَّل التّرميز المصدر. destination_encoding كائنٌ يمثَّل التّرميز الوجهة. opt يجب أن يكون هذا المعامل قيمةً عدميّةً (nil)، أو القيمة hash، أو عددًا صحيحًا (integer). القيم المعادة تعاد مصفوفة تحوي مسار التّحويل. أمثلة مثالٌ عن استخدام التابع search_convpath: p Encoding::Converter.search_convpath("ISO-8859-1", "EUC-JP") #=> [[#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>], # [#<Encoding:UTF-8>, #<Encoding:EUC-JP>]] p Encoding::Converter.search_convpath("ISO-8859-1", "EUC-JP", universal_newline: true) or p Encoding::Converter.search_convpath("ISO-8859-1", "EUC-JP", newline: :universal) #=> [[#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>], # [#<Encoding:UTF-8>, #<Encoding:EUC-JP>], # ...

يحوّل التابع primitive_convert ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد. يحذف التّابع primitive_convert الجزء المحوّل من المخزن source_buffer المصدر، ويضعه في المخزن destination_buffer الوجهة أو يخزنِّه مؤقتًا في كائن من الصنفEncoding::Converter بعد تحويله بالتأكيد. يوقف التّابع primitive_convert عملية التحويل عند تحقّق أحد الشّروط التالية: وجود سلسلة بايت غير صالحة (invalid_byte_sequence:) في المخزن source_buffer المصدر . يُعيد التابعان primitive_errinfo و last_error تفاصيل الخطأ. ...

يعيد التّابع source_encoding التّرميز المصدر ككائن. لاحظ أنَّ التّرميز النّاتج قد لا يكون مطابقًا للترميز المصدري الخاص بالمحوّل إذا تمّت عملية التّحويل على عدّة مراحل. البنية العامة source_encoding → encoding القيم المعادة يُعاد كائن من النوع Encoding يمثل التّرميز المصدر. أمثلة مثالٌ عن استخدام  التّابع source_encoding: ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP") # ISO-8859-1 -> UTF-8 -> EUC-JP begin ec.convert("\xa0") # NO-BREAK SPACE, which is available in UTF-8 but not in EUC-JP. rescue Encoding::UndefinedConversionError p $!.source_encoding ...

يُنهي التّابع finish محوّل الترميز، ويُعيد الجزء الأخير من السلسلة النصيّة التي يحول ترميزها حينذاك. البنية العامة finish → string القيم المعادة تُعاد سلسلةٌ نصيّةٌ تمثِّل الجزء الأخير من السلسلة النصيّة المحوّلة. أمثلة مثالٌ عن استخدام التابع finish: ec = Encoding::Converter.new("utf-8", "iso-2022-jp") p ec.convert("\u3042") #=> "\e$B$\"" p ec.finish #=> "\e(B" انظر أيضًا التّابع asciicompat_encoding: يُعيد التّرميز المتوافق مع ASCII المقابل للترميز المعطى. التّابع ...

يُعيد التّابع putback البايتات التي ستُحوَّل. يمكن استدعاء هذا التابع بشكل متسلسل (call-seq). ec.putback -> string ec.putback(max_numbytes) -> string تنتج البايتات من الخطأ invalid_byte_sequence. عند حصول هذا الخطأ تهمل بعض البايتات ويخزَّن بعضها الآخر مؤقتًا بانتظار تحويلها لاحقًا. البايتات التي سيعيدها التابع هي الأخير (أي البايتات المخزنة). يمكن مراقبة وتتبع هذه الحالة باستخدام التّابع Encoding::InvalidByteSequenceError.readagain_bytes والتّابع primitive_errinfo. البنية ...

يُرمَى الاستثناء UndefinedConversionError من قبل توابع الصّنفين String و Encoding عندما تفشل عملية تبديل التّرميز (transcoding). توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد الترميز الهدف على شكل كائن. destination_encoding_name يُعيد اسم التّرميز الهدف. error_char يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. source_encoding يعيد الترميز المصدر على شكل كائن. لاحظ أنَّ التّرميز المصدري النّاتج قد لا يكون مطابقًا لترميز محوّل الترميز المصدري إذا تمّت عملية التّحويل على عدّة مراحل. source_encoding_name يُعيد اسم الترميز المصدر. مصادر صفحة ...

يضبط التّابع replacement سلسلة الاستبدال النصية. البنية العامة replacement = string أمثلة مثالٌ عن استخدام التابع replacement: ec = Encoding::Converter.new("utf-8", "us-ascii", :undef => :replace) ec.replacement = "<undef>" p ec.convert("a \u3042 b") #=> "a <undef> b" انظر أيضًا التّابع replacement::: يُعيد سلسلة الاستبدال النصية. التّابع inspect: يُعيد نسخةً قابلةً للطباعة من كائن الصنف Encoding::Converter. التّابع primitive_errinfo: يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر. التّابع putback: يُعيد البايتات التي ستُحوَّل. مصادر صفحة التابع ...