نتائج البحث

يمثل الصنف Encoding ترميز المحارف الذي يمكننا استخدامه في لغة روبي. تُعرَّف النّسخة المنشأة من الصنف Encoding بأنّها ثابتٌ (constant) يندرج ضمن مجال أسماء الصنف (encoding namespace)؛ يكون لها اسم، واسم بديل (Alias) اختياري. Encoding::ISO_8859_1.name #=> "ISO-8859-1" Encoding::ISO_8859_1.names #=> ["ISO-8859-1", "ISO8859-1"] التّوابع (methods) في لغة روبي التي تتعامل مع التّرميزات تعيد أو تقبل النسخ Encoding على شكل وسيط (عندما يقبل التّابع كائنًا على شكل وسيط، يمكن عندها أن نستخدم اسم أو لقب الترميز عوضًا عن الكائن). "some string".encoding #=> #<Encoding:UTF-8> string = "some string".encode(Encoding::ISO_8859_1) #=> "some string" string.encoding #=> ...

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

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

يُعيد التّابع destination_encoding_name اسم الترميز الهدف. البنية العامة destination_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الهدف. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع readagain_bytes: يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز المصدر. مصادر صفحة التابع destination_encoding_name في ...

يُعيد التّابع inspect نسخةً قابلةً للطباعة من الكائن Encoding::Converter. البنية العامة inspect → string القيم المعادة تُعاد سلسلةٌ نصيّةٌ قابلةٌ للطباعة من الكائن Encoding::Converter. أمثلة مثالٌ عن استخدام التابع inspect: ec = Encoding::Converter.new("iso-8859-1", "utf-8") puts ec.inspect #=> #<Encoding::Converter: ISO-8859-1 to UTF-8> انظر أيضًا التّابع convert: يُحوِّل سلسلة نصية معينة. التّابع replacement::: يُعيد سلسلة الاستبدال النصية. التّابع replacement: يضبط سلسلة الاستبدال النصية. التّابع primitive_errinfo: يُعيد معلوماتٍ مهمّةً حول آخر خطأٍ حدث في مصفوفة مكونة من خمسة عناصر. التّابع putback: ...

يُرمَى الاستنثناء InvalidByteSequenceError من قبل توابع الصّنفين String و Encoding عندما تحوي السّلسلة النّصية التي يجري تحويل ترميزها بايتًا غير صالح إما للتّرميز المصدر أو التّرميز الهدف المراد التحويل إليه. توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد التّرميز الهدف. destination_encoding_name يُعيد اسم الترميز الهدف. error_bytes يعيد البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. ?incomplete_input يتحقّق فيما إذا كان خطأ تسلسل البايت (byte sequence error) الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. readagain_bytes يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع ...

يعُيد التابع readagain_bytes البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. البنية العامة readagain_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل البايتات المطلوب قراءتها مجدَّدًا عندما يقع الخطأ InvalidByteSequenceError. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز ...

يضيف التّابع 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>], # ...

يُرمى الاستثناء ConverterNotFoundError من قبل توابع تبديل التّرميز (transcoding) عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ (converter) محدَّد. انظر أيضًا الاستثناء CompatibilityError: يُرمى عندما لا يتوافق التّرميز المصدر مع التّرميز الهدف. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::ConverterNotFoundError في توثيق روبي الرسمي.

يحوّل التابع 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 ...

يُحوِّل التابع convert ترميز سّلسلة نصيّة معينة. يجب استخدام التابع finish في النّهاية. إذا حدث خطأٌ في التحويل، فسيُرمَى أحد الخطأين Encoding::UndefinedConversionError أو Encoding::InvalidByteSequenceError. لا يزوِّد التّابع convert أي طرائق لاسترداد أو إعادة العملية بدءًا من الاستثناء المرمي. استخدم التابع primitive_convert عندما تريد التّعامل مع هذه الاستثناءات. البنية العامة convert(source_string) → destination_string المعاملات source_string السلسلة النّصية ذات التّرميز المصدر المراد تحويله. يعدُّ المعامل source_string جزءًا من المصدر. تُعين partial_input: مثلًا إلى القيمة true داخليًا (partial_input=>true:). القيم المعادة تُعاد السلسلة النصيّة ...

يُرمى الاستثناء ConverterNotFoundError من قبل توابع تبديل التّرميز (transcoding) عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ (converter) محدَّد. انظر أيضًا الاستثناء CompatibilityError: يُرمى عندما لا يتوافق التّرميز المصدر مع التّرميز الهدف. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::ConverterNotFoundError في توثيق روبي الرسمي.

يُنهي التّابع 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. البنية ...

يُعيد التّابع source_encoding_name اسم التّرميز المصدر. البنية العامة source_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز المصدر. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع readagain_bytes: يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. التّابع source_encoding: يعيد التّرميز المصدر. مصادر صفحة التابع source_encoding_name ...

يعيد التّابع 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 ...

يُرمَى الاستنثناء InvalidByteSequenceError من قبل توابع الصّنفين String و Encoding عندما تحوي السّلسلة النّصية التي يجري تحويل ترميزها بايتًا غير صالح إما للتّرميز المصدر أو التّرميز الهدف المراد التحويل إليه. توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد التّرميز الهدف. destination_encoding_name يُعيد اسم الترميز الهدف. error_bytes يعيد البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. ?incomplete_input يتحقّق فيما إذا كان خطأ تسلسل البايت (byte sequence error) الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. readagain_bytes يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع ...

يُعيد التّابع last_error الكائن exception عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة nil إن لم يحصل أي خطأ. تشير القيمة "error" إلى أنَّ الخطأين Encoding::InvalidByteSequenceError وEncoding::UndefinedConversionError نتجا من التّابع convert، وأنَّ invalid_byte_sequence: وincomplete_input: و undefined_conversion: نتجوا من التّابع primitive_convert. البنية العامة last_error → exception or nil القيم المعادة يُعاد الكائن exception عند حصول خطأٍ في آخر عملية تحويل، أو تعاد القيمة nil إذا جرى التحويل الأخير من دون أخطاءٍ. أمثلة مثالٌ عن استخدام التابع last_error: ec = ...

يُعيد التّابع error_bytes البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. البنية العامة error_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل البايتات التي أهملت (discarded bytes) عندما وقع الخطأ InvalidByteSequenceError. أمثلة مثالٌ عن استخدام  التّابع error_bytes: ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1") begin ec.convert("abc\xA1\xFFdef") rescue Encoding::InvalidByteSequenceError p $! #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "\xFF" on EUC-JP> puts $!.error_bytes.dump #=> "\xA1" puts $!.readagain_bytes.dump ...

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

يتحقّق التّابع ?incomplete_input فيما إذا كان خطأ تسلسل البايت (byte sequence error) الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. البنية العامة incomplete_input? → true or false القيم المعادة تُعاد القيمة true إذا كان خطأ تسلسل البايت الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية، أو تُعاد القيمة false خلاف ذلك. أمثلة مثالٌ عن استخدام  التّابع ?incomplete_input: ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1") begin ec.convert("abc\xA1z") rescue Encoding::InvalidByteSequenceError p $! #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "z" on EUC-JP> p ...

يضبط التّابع 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: يُعيد البايتات التي ستُحوَّل. مصادر صفحة التابع ...

يُرمى الاستثناء CompatibilityError من قبل توابع الصّنفين String و Encoding عندما لا يتوافق ترميز المصدر مع ترميز الهدف. انظر أيضًا الاستثناء ConverterNotFoundError: يُرمى عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ محدَّد. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::CompatibilityError في توثيق روبي الرسمي.

يُنشئ التّابع new:: كائنًا جديدًا من الصنف Encoding::Converter. التّرميز المصدر والتّرميز الوجهة يجب أن يكونا إما سلسلةً نصّيةً أو كائنًا من الصّنف Encoding. يقبل التّابع new:: اختياريًّا أن يمرر إليه خيارٌ من النوع hash أو integer. عندما يكون من النوع hash، فمن الممكن أن يحتوي على ‎:invalid => nil وغيرها. وعندما يكون من النوع integer، فإنه يجب أن يكون منطقيًّا (logical)، أو أحد الثوابت المعرَّفة مثل Encoding::Converter::INVALID_REPLACE وغيرها. تكون بنية الخيار الممرر إلى التابع عندما يكون من النوع hash بالشكل: ...

يُستعمَل الصنف 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 سلاسل البايت غير الصالحة. ...

يُرمى الاستثناء CompatibilityError من قبل توابع الصّنفين String و Encoding عندما لا يتوافق ترميز المصدر مع ترميز الهدف. انظر أيضًا الاستثناء ConverterNotFoundError: يُرمى عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ محدَّد. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::CompatibilityError في توثيق روبي الرسمي.

يُعيد التّابع 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 ...

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

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

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

يُعيد التّابع convpath مسار التّحويلِ الخاصَّ بالكائن من الصنف Encoding::Converter. البنية العامة convpath → ary القيم المعادة تُعاد مصفوفة تحوي ترميزات مسار التحويل. يكون كل عنصر في هذه المصفوفة إما زوجًا من الترميزات أو سلسلةً نصيّةً. يمثّل هذا الزّوج عملية التحويل التي حصلت. بينما تمثل السلسلة النصية المُزخرف (decorator) المُستعمَل. أمثلة مثالٌ عن استخدام التابع convpath: ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP", crlf_newline: true) p ec.convpath #=> [[#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>], # [#<Encoding:UTF-8>, #<Encoding:EUC-JP>], # "crlf_newline"] في المثال أعلاه، يمثل الزوج [#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>] ...

يُعيد التّابع error_char سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. البنية العامة error_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تحوي المحرف الذي كان سببًا في رمي الاستثناء UndefinedConversionError. أمثلة مثالٌ عن استخدام  التّابع error_char: ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP") begin ec.convert("\xa0") rescue Encoding::UndefinedConversionError puts $!.error_char.dump #=> "\xC2\xA0" p $!.error_char.encoding #=> #<Encoding:UTF-8> end انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف على شكل كائن. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع source_encoding: يعيد التّرميز المصدر. ...

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

يُستعمَل الصنف 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 سلاسل البايت غير الصالحة. ...

يُعيد التّابع destination_encoding التّرميز الهدف. البنية العامة destination_encoding → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ تمثّل التّرميز الهدف. انظر أيضًا التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع readagain_bytes: يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز المصدر. مصادر صفحة التابع destination_encoding في الصنف Encoding::InvalidByteSequenceError ...

يتحقق المعامل == من تساوي كائنين من الصنف Encoding::Converter مع بعضهما بعضًا. البنية العامة ec == other → true or false المعاملات ec كائن من الصنف Encoding::Converter يراد التحقق من تساويه مع الكائن الآخر other. other الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن ec. القيم المعادة تُعاد القيمة false إذا كان الكائن other ليس كائنًا من الصنف Encoding::Converter. عدا ذلك، تُعاد القيمة true إذا كان الكائنين ec و other يتشاركان نفس الصّنف. انظر أيضًا التابع new: يُنشئ كائنًا جديدًا ...

يحول التابع encode!‎ سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيدها. البنية العامة encode!(encoding [, options] ) → str encode!(dst_encoding, src_encoding [, options] ) → str يحول الشكل الأول من التابع السلسلة النصية التي استدعيت معه من الترميز المرمزة به إلى الترميز encoding المعطى. أمَّا الشكل الثاني، فيحول السلسلة النصية التي استدعيت معه من الترميز dst_encoding إلى الترميز src_encoding. المعاملات encoding الترميز المراد تحويل السلسلة النصية المعطاة إليه. dst_encoding الترميز الوجهة المراد تحويل السلسلة النصية المعطاة إليه. srd_encoding الترميز الهدف ...

يحول التابع encode سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيد نسخة عنها. البنية العامة encode(encoding [, options] ) → str encode(dst_encoding, src_encoding [, options] ) → str encode([options]) → str يعيد الشكل الأول من التابع نسخة عن السلسلة النصية التي استدعيت معه بعد تحويل ترميزها إلى الترميز encoding المعطى. أمَّا الشكل الثاني، فيعيد نسخة عن السلسلة النصية التي استدعيت معه بعد تحويل ترميزها من الترميز dst_encoding إلى الترميز src_encoding. أمَّا الشكل الأخير، فيعيد نسخة من السلسلة النصية التي استدعيت معه ...

يُعيد التابع encoding ترميز السلسلة النصية التي استُدعيت معه. البنية العامة encoding → encoding القيمة المعادة يُعاد ترميز السلسلة النصية المُعطاة. أمثلة مثال على استعمال التابع encoding: "hello".encoding   #=> #<Encoding:ASCII-8BIT> "\u0639".encoding #=> #<Encoding:UTF-8> انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع force_encoding: يغير ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. مصادر قسم التابع encoding‎ في الصنف String في توثيق روبي الرسمي.

يعيد التابع internal_encoding الترميز الداخلي (internal encoding) للسلاسل النصية المقروءة من المجرى ARGF على شكل كائن من النوع Encoding. البنية العامة internal_encoding → encoding القيم المعادة إن استدعي التابع ARGF.set_encoding مع تمرير اسمين لأحد الترميزات المستعملة، فسيُعاد كائن من النوع Encoding يمثل الترميز الثاني. خلا ذلك، إن ضبطت القيمة Encoding.default_external، فستُعاد هذه القيمة. إذا تعذر ذلك وحُدِّد الترميز الخارجي الافتراضي (default external encoding) المراد استعماله في سطر الأوامر، فستُستخدم تلك القيمة. أمَّا إن كان الترميز مجهولًا، فستُعاد القيمة nil. ...

يعيد التابع external_encoding الترميز الخارجي (external encoding) للملفات المقروءة من ARGF على شكل كائن من النوع Encoding. الترميز الخارجي هو الترميز الذي كُتِب به النص وخُزِّن في الملف. إن وازنَّا هذا التابع مع التابع ARGF.internal_encoding، نجد أنَّ الأخير يعيد الترميز المستخدم لتمثيل هذا النص ضمن روبي. لضبط الترميز الخارجي، استخدم التابع ARGF.set_encoding. البنية العامة external_encoding → encoding القيم المعادة يعاد كائن من النوع Encoding يمثِّل الترميز الخارجي المستعمل في كتابة محتوى الملف المقروء من المجرى ARGF. أمثلة مثال على ...

يُعيد التابع encoding كائنُا من النوع Encoding يمثل ترميز الرمز التي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنُ من النوع Encoding يمثل ترميز الرمز التي استُدعي معه. انظر أيضا التابع id2name: يعيد الاسم أو السلسلة نصية التي تمثل الرمز. مصادر قسم التابع encoding‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يُعيد التابع encoding كائنًا من النوع Encoding، والذي يمثل ترميز الكائن الذي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنٌ من النوع Encoding يمثِّل الترميز المستعمل. انظر أيضًا التابع casefold?‎: يعيد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). مصادر قسم التابع encoding‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

ينشئ التابع new سلسلةً نصيةً جديدةً تحوي البيانات المُمرَّرة إليه. البنية العامة new(str="") → new_str new(str="", encoding: enc) → new_str new(str="", capacity: size) → new_str المعاملات str السلسلة النصية المراد إنشاؤها. القيمة الافتراضية هي: "". encoding وسيط مسمى يحدِّد ترميز السلسلة النصية المراد إنشاؤها. وفي حال عدم تحديد القيمة للمفتاح، تكون قيمة المفتاح هي ترميز السلسلة النصية str نفسه؛ وفي حال كانت السلسلة النصية str فارغةً، يأخذ المفتاح قيمة افتراضية ألا وهي "ASCII-8BIT" . capacity وسيط مسمى يحدِّد الحجم (بالبايت) الذي ستحجزه ...

يغيِّر التابع force_encoding ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. البنية العامة force_encoding(encoding) → str المعاملات encoding يمثل الترميز الجديد للسلسلة النصية. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد تغيير ترميزها إلى الترميز encoding. انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع encoding: يُعيد ترميز السلسلة النصية التي استُدعيت معه. مصادر قسم التابع ‎force_encoding في الصنف String في توثيق روبي الرسمي.

يضبط التابع set_encoding الترميز الداخلي والخارجي المستعمل مع السلاسل النصية المقروءة من المجرى ARGF. البنية العامة set_encoding(ext_enc) → ARGF set_encoding("ext_enc:int_enc") → ARGF set_encoding(ext_enc, int_enc) → ARGF set_encoding("ext_enc:int_enc", opt) → ARGF set_encoding(ext_enc, int_enc, opt) → ARGF إن مرِّر المعامل ext_enc، فستُوسَم السلاسل النصية المقروءة من المجرى ARGF بهذا الترميز المعطى. إن مرِّرت السلسلة النصية "ext_enc:int_enc" التي تمثِّل اسمي ترميزين مفصولين بنقطتين، مثل "ascii:utf-8"، فستُحوَّل السلسلة النصية المقروءة من الترميز الأول (الترميز الخارجي) إلى الترميز الثاني (الترميز الداخلي)، ثم تُوسَم بالترميز الثاني. أمَّا إن مرِّر المعاملان ext_enc ...