نتائج البحث

يُرمَى الاستنثناء 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: يُنشئ كائنًا جديدًا ...