نتائج البحث

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

يُعيد التّابع 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 تفاصيل الخطأ. ...

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

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

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

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

يُنشئ التّابع 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 سلاسل البايت غير الصالحة. ...

يُعيد التّابع 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: يضيف سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيحويل ترميز هذه السلسلة إلى ترميز الوجهة نفسه ...

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

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