نتائج البحث

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

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

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

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

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

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

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

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

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

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

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

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

يُعيد التّابع 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. إذًا، تكون ...

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

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

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

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

يُنهي التّابع 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 المقابل للترميز المعطى. التّابع ...

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

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

يمثل الصنف 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 في ...

يُرمَى الاستنثناء 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: يُعيد اسم التّرميز ...

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

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

يُعيد التّابع 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 يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع ...

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

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

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

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

يُعيد التّابع 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: يعيد التّرميز المصدر. ...

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

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

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

يُطلق الاستثناء RangeError عندما تكون قيمة عددية معطاة خارج النطاق. [1, 2, 3].drop(1 << 100) سيُطلق الاستثناء RangeError بعد تنفيذ هذه الشيفرة: RangeError: bignum too big to convert into `long' مصادر صفحة الصنف RangeError في توثيق روبي الرسمي.

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

يتحقّق التّابع ?dummy من التّرميز الزّائف وهو ترميزٌ لم يُتعامل به مع المحارف تعاملًا صحيحًا. يستخدم هذا التابع مع التّرميزات التي لها حالة (stateful encodings). البنية العامة dummy?  → true or false القيم المعادة تُعاد القيمة true في حالة وجود ترميزٍ زائفٍ، أو تُعاد القيمة false خلاف ذلك. أمثلة مثالٌ عن استخدام التابع dummy?‎: Encoding::ISO_2022_JP.dummy? #=> true Encoding::UTF_8.dummy? #=> false انظر أيضًا التابع ?compatible: ...

يبحث التّابع find عن ترميزٍ باسمٍ محدّد. الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: "external": يمثل الترميز الخارجي الافتراضي (default external encoding). "internal": يمثل الترميز الداخلي الافتراضي (default external encoding). "locale": يمثل الترميز المحدد في المحلية (locale encoding). "filesystem": يمثل ترميز نظام الملفات (filesystem encoding). البنية العامة find(string) → enc المعاملات string سلسلة نصية تمثل اسم الترميز المراد البحث عنه. القيم المعادة يعاد الترميز ذو الاسم string في حال ...

يتحقّق التّابع ascii_compatible?‎ من توافق ترميز محدد مع الترميز ASCII. البنية العامة ascii_compatible? → true or false القيم المعادة تُعاد القيمة true في حال توافق الترميز المعطى مع التّرميز ASCII، أو تُعاد القيمة false خلاف ذلك. أمثلة مثالٌ عن استخدام التابع ascii_compatible?‎: Encoding::UTF_8.ascii_compatible? #=> true Encoding::UTF_16BE.ascii_compatible? #=> false انظر أيضًا التّابع ?dummy: يتحقّق من التّرميز الزّائف. التابع ?compatible: يتحقّق من توافق كائنين مع بعضهما بعضًا. التّابع replicate: يُنشئ نسخة مطابقة من ترميز الكائن. مصادر قسم التابع ...

يعيد التابع chr‎ سلسلة نصية تحتوي على الحرف الذي تمثله قيمة العدد الذي استُدعي معه حسب الترميز المحدد. البنية العامة chr([encoding]) → string‎ المعاملات encoding‎ الترميز المراد تمثل العدد به. القيمة المعادة تعاد سلسلة نصية تحتوي على الحرف الذي تمثله قيمة العدد الذي استُدعي معه حسب الترميز المُمرّر encoding. أمثلة مثال على استخدام التابع chr‎: 65.chr #=> "A" 230.chr #=> "\xE6" 255.chr(Encoding::UTF_8) #=> "\u00FF" ‎ انظر أيضا التابع abs: يعيد القيمة المطلقة للعدد الذي استُدعي ...

يتحقق التابع fixed_encoding?‎ إن كان التعبير النمطي الذي استُدعي معه قابلًا للتطبيق على سلسلة نصية ذات ترميز متوافق مع الترميز ASCII. البنية العامة fixed_encoding?→ true or false‎ القيمة المعادة تعاد القيمة false إن كان التعبير النمطي المعطى قابلًا للتطبيق على سلسلة نصية ذات ترميز متوافق مع الترميز ASCII، أو تعاد القيمة true خلاف ذلك. أمثلة مثال على استخدام التابع fixed_encoding?‎: r = /a/ r.fixed_encoding? ...

يُعيد التّابع inspect‎ سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. البنية العامة inspect → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ تمثّل التّرميز المعطى بشكل يخص المبرمجين فقط. أمثلة مثالٌ عن استخدام التابع inspect‎: Encoding::UTF_8.inspect #=> "#<Encoding:UTF-8>" Encoding::ISO_2022_JP.inspect #=> "#<Encoding:ISO-2022-JP (dummy)>" انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التّابع name: يُعيد اسم التّرميز المستخدم. التّابع names: ...

يعيد التابع entries‎ مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط encoding الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات. البنية العامة entries( dirname ) → array entries( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المراد معرفة محتوياته. encoding ترميز المجلد. القيمة المعادة تُعاد مصفوفةٌ تحوي جميع أسماء الملفات في المجلد المحدد. أمثلة مثال عن استخدام التابع entries ...

يعيد التابع children‎ مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط الاختياري encoding الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه. البنية العامة children( dirname ) → array children( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المُحدد المراد معرفة محتواه. encoding ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات. القيمة المعادة تُعاد مصفوفة تحوي جميع ...

يفتح التابع open مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. إن لم تمرَّر إليه كتلة، فهو مرادف للتابع Dir::new. أمَّا إن مُرِّرت إليه كتلة، فسيُمرّر إليها aDir (انظر فقرة البنية العامة) كمعامل. يُغلَق المجلد في بعد الانتهاء من تنفيذ الكتلة، ويعيد التابع Dir::open ناتج تنفيذ هذه الكتلة. البنية العامة open( string ) → aDir open( string, encoding: enc ) → aDir open( string ) {| aDir | block } → anObject open( string, encoding: enc ) {| aDir | block } → anObject ...

يستدعي التابع foreach الكتلة المعطاة على كل ملف من الملفات الموجودة في المجلد المحدد، إذ يمُمرّر أسماء تلك الملفات كوسائط للكتلة. في حال عدم تمرير أي كتلة، يعاد كائنٌ من النوع enumerator. البنية العامة foreach( dirname ) {| filename | block } → nil foreach( dirname, encoding: enc ) {| filename | block } → nil foreach( dirname ) → an_enumerator foreach( dirname, encoding: enc ) → an_enumerator المعاملات dirname اسم المجلد المعطى المراد تنفيذ الكتلة block على كل عنصر من عناصره. encoding ...

يعيد التابع casefold?‎ قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). البنية العامة casefold?→ true or false‎ القيمة المعادة تعاد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). أمثلة مثال على استخدام التابع casefold?‎: /a/.casefold? #=> false /a/i.casefold? #=> true /(?i:a)/.casefold? #=> false‎ انظر أيضًا التابع encoding: يُعيد كائنًا من النوع Encoding، والذي يمثل ترميز الكائن. مصادر قسم التابع casefold?‎ في الصنف ...

يستدعي التابع each_child الكتلة المعطاة على كل ملف أو مجلد موجود في المجلد المحدد باستثناء ".." و "." إذ يمُمرّر أسماء تلك الملفات كوسائط إلى الكتلة. في حال عدم تمرير أي كتلة، يعاد كائنٌ من النوع enumerator. البنية العامة each_child( dirname ) {| filename | block } → nil click to toggle source each_child( dirname, encoding: enc ) {| filename | block } → nil each_child( dirname ) → an_enumerator each_child( dirname, encoding: enc ) → an_enumerator المعاملات dirname اسم المجلد المراد تنفيذ ...

يُعيد التابع external_encoding الكائن Encoding الذي يمثل ترميز الملف للمجرى الذي استدعي معه. إن كان المجرى في وضع الكتابة ولم يُحدّد أي ترميز، فستعاد القيمة nil. البنية العامة external_encoding→ encoding‎ القيمة المعادة يعاد كائن من النوع Encoding يمثل ترميز الملف للمجرى المعطى. إن كان المجرى في وضع الكتابة ولم يُحدّد أي ترميز، فستعاد القيمة nil. انظر أيضًا التابع internal_encoding: يعيد ترميز السلسلة النصية الداخلية. التابع set_encoding: يضبط الترميز الداخلي والخارجي في المجرى الذي استدعي معه. مصادر قسم التابع external_encoding‎ في الصنف IO‎ ...

يعيد التابع new كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. البنية العامة new( string ) → aDir new( string, encoding: enc ) → aDir المعاملات string  اسم المجلد المعطى. encoding يحدِّد هذا الوسيط الاختياري ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات. القيمة المعادة يعاد كائنٌ مجلديٌ (directory object) جديدٌ خاص بالمجلد string المعطى. انظر أيضًا التابع open: يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. مصادر قسم التابع new في الصنف Dir في توثيق روبي الرسمي.

يُنشئ التّابع replicate نسخة مطابقة من الترميز الذي استدعي معه. سيكون للتّرميز الجّديد نفس بنية البايت (byte structure) للترميز الذي نُسِخ منه. إذا كان الاسم مستخدمًا من قبل ترميزٍ آخر، فسيُرمى الخطأ ArgumentError. البنية العامة replicate(name) → encoding المعاملات name اسم الترميز المراد النسخ منه. القيم المعادة يُعاد ترميزٌ جديدٌ مطابقٌ للترميز المعطى ويملك الاسم name. انظر أيضًا التابع ?compatible: يتحقّق من توافق كائنين مع بعضهما بعضًا. التابع ?ascii_compatible: يتحقّق من توافق ترميز محدد مع الترميز ASCII. التابع locale_charmap‎: يعيد ...

يُعيد التّابع name اسم التّرميز الفعلي لترميز محدد. البنية العامة name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الفعلي للترميز المعطى. أمثلة مثالٌ عن استخدام التابع name: Encoding::UTF_8.name      #=> "UTF-8" انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. ...

يُعيد التّابع list قائمةً بالترميزات المُحمّلة (loaded encodings). البنية العامة list → [enc1, enc2, ...] القيم المعادة: تعاد قائمة بالتّرميزات المُحمّلة. أمثلة بعض الأمثلة عن استخدام التابع list‎: Encoding.list #=> [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>, #<Encoding:ISO-2022-JP (dummy)>] Encoding.find("US-ASCII") #=> #<Encoding:US-ASCII> Encoding.list #=> [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>, #<Encoding:US-ASCII>, #<Encoding:ISO-2022-JP (dummy)>] انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد ...

يُعيد التّابع to_s اسم التّرميز الفعلي لترميز محدد. البنية العامة to_s → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الفعلي لترميز محدد. أمثلة مثالٌ عن استخدام التابع to_s: Encoding::UTF_8.name      #=> "UTF-8" انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. ...

يُعيد التّابع names اسم ترميزٍ محدد وجميع الأسماء البديلة الخاصّة به. البنية العامة names → array القيم المعادة تُعاد قائمة (list) تحوي اسم الترميز المعطى والأسماء البديلة الخاصّة به. أمثلة مثالٌ عن استخدام التابع names: Encoding::WINDOWS_31J.names  #=> ["Windows-31J", "CP932", "csWindows31J"] انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل ...

يقرأ التابع read ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج. البنية العامة read(name, [length [, offset]] [, opt] )→ string‎ المعاملات name‎ اسم الملف المراد القراءة منه. إن كان name يبدأ بمحرف الأنبوب ("|")، فستُنشَأ عملية فرعية (subprocess) بطريقة مشابهة للتابع Kernel.open، ثم ستعاد مُخرجاتها. length‎ عدد صحيح يمثل عدد البايتات المراد قراءتها من الملف. القيمة الافتراضية لهذا المعامل هي القراءة حتى نهاية الملف. offset‎ عدد صحيح يمثل إزاحة موضع المؤشر في الملف إلى المكان الذي يراد بدء القراءة ...

يُمثِّل الصنف EncodingError الصِّنفَ القاعديَّ (base class) لجميعِ أخطاء التّرميز (الصنف Encoding). مصادر صفحة الصنف EncodingError في توثيق روبي الرسمي.

يعيد التّابع locale_chaemap اسم مخطّط توزيع الأحرف (charmap) للمحلية (locale) الحالية. البنية العامة locale_charmap → string القيم المعادة تعاد سلسلة نصية تمثل اسم مخطّط توزيع الأحرف (charmap) للمحلية الحالية، أو تعاد القيمة nil العدمية  إذا لم توجد معلومات موافقة. أمثلة بعض الأمثلة عن استخدام التابع locale_charmap‎‎: Debian GNU/Linux LANG=C Encoding.locale_charmap #=> "ANSI_X3.4-1968" LANG=ja_JP.EUC-JP Encoding.locale_charmap #=> "EUC-JP" SunOS 5 LANG=C Encoding.locale_charmap #=> "646" LANG=ja ...

يضبط التابع set_encoding الترميز الداخلي والخارجي في المجرى الذي استدعي معه. في حال تمرير وسيط واحد إلى التابع، فستوسم السلسلة النصية المقروءة من المجرى بالترميز المحدد. إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين مثل "A:B"، فستُحوّل السلسلة النصية المقروءة من الترميز A (الترميز الخارجي) إلى الترميز B (الترميز الداخلي)، ثم ستوسم بالترميز B. في حال تمرير وسيطين، فيجب أن يكونا كائني ترميز، أو اسمي ترميز، إذ يمثل أولهما الترميز الخارجي، فيما يمثل ثانيهما الترميز الداخلي. في حال ...

يعيد التّابع aliases الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. البنية العامة aliases → {"alias1" => "orig1", "alias2" => "orig2", ...} القيم المعادة تُعاد خريطةٌ تحوي الأسماء البديلة (alias) لجميع أسماء الترميزات الأصلية المتاحة. أمثلة مثالٌ عن استخدام التابع aliases: Encoding.aliases #=> {"BINARY"=>"ASCII-8BIT", "ASCII"=>"US-ASCII", "ANSI_X3.4-1986"=>"US-ASCII", "SJIS"=>"Shift_JIS", "eucJP"=>"EUC-JP", "CP932"=>"Windows-31J"} انظر أيضًا التابع list: يعيد قائمةً بالترميزات المُحمّلة (loaded encodings). التابع name_list: يُعيد قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين ...

يعيد التابع unicode_normalize نسخة موحدة (normalized string، أي ذات ترميز موحد) للسلسلة النصية التي استدعيت معه، باستخدام ترميزات يونيكود الموحدة (Unicode normalizations) التالية: NFC، أو NFD، أو NFKC، أو NFKD. يطلق التابع استثناءً إذا كانت السلسلة النصية غير مُرمّزة بترميز اليونيكود. يُقصَد بترميز اليونيكود (Unicode Encoding) أيًا من الترميزات التالية: UTF-8، أو UTF-16BE/LE، أو UTF-32BE/LE، أو GB18030، أو UCS_2BE، أو UCS_4BE. تُحوَّل السلسلة النصية إلى الترميز UTF-8، إذا كانت مُرمّزة بترميز مغاير له، مما يجعل العملية أبطأ فيما إذا كانت ...

يوحد التابع unicode_normalize!‎ ترميز السلسلة النصية التي استدعيت معه باستخدام ترميزات يونيكود الموحدة (Unicode normalizations) التالية: NFC، أو NFD، أو NFKC، أو NFKD. يطلق التابع استثناءً إذا كانت السلسلة النصية غير مُرمّزة بترميز اليونيكود. يُقصَد بترميز اليونيكود (Unicode Encoding) أيًا من الترميزات التالية: UTF-8، أو UTF-16BE/LE، أو UTF-32BE/LE، أو GB18030، أو UCS_2BE، أو UCS_4BE. تُحوَّل السلسلة النصية إلى الترميز UTF-8، إذا كانت مُرمّزة بترميز مغاير له، مما يجعل العملية أبطأ فيما إذا كانت السلاسل مُرمّزة بالترميز UTF-8. البنية العامة unicode_normalize!(form=:nfc) ...

يعيد التابع denominator‎ القيمة 1. البنية العامة denominator → 1‎ القيمة المعادة يعاد العدد 1. انظر أيضا التابع chr: يعيد سلسلة نصية تحتوي على الحرف الذي تمثله قيمة العدد الذي استُدعي معه حسب الترميز المُمرّر encoding. مصادر قسم التابع denominator‎ في الصنف Integer‎ في توثيق روبي الرسمي.

تتيح هذه الدالة عرض الأخطاء tracebacks الناتجة عن الدوال والمجاميع aggregates والمحوّلات converters والاستدعاءات الخلفية authorizer callbacks المفوِّضة المعرّفة من قبل المستخدم. البنية العامة sqlite3.enable_callback_tracebacks(flag) ‎المعاملات لا تعرض اللغة -بصورة افتراضية- الأخطاء tracebacks في الدوال والمجاميع aggregates والمحوّلات converters والاستدعاءات الخلفية المفوِّضة authorizer callbacks المعرّفة من قبل المستخدم. ولتنقيح بنى التحكم هذه يمكن استدعاء هذه الدالة مع تعيين القيمة True للمعامل flag. بعد ذلك ستعرض اللغة الأخطاء الناتجة من الاستدعاءات الخلفية في sys.stderr. يمكن استخدام القيمة False لإلغاء هذه الخاصية ...

يتحقق التابع empty?‎ مما إذا كان الرمز الذي استُدعي معه يساوي "" أم لا. البنية العامة empty?→ true or false‎ القيمة المعادة تعاد القيمة true إن كان الرمز الذي استُدعي معه يساوي ""، وإلا فستعاد القيمة false. انظر أيضًا التابع encoding: يُعيد الترميز الذي يمثل ترميز الرمز التي استُدعي معه. مصادر قسم التابع empty?‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

يعيد التابع id2name الاسم أو السلسلة نصية التي تمثل الرمز. البنية العامة id2name→ string‎ القيمة المعادة تعاد سلسلة نصية تمثِّل الاسم أو السلسلة نصية التي تمثل الرمز. أمثلة مثال على استخدام التابع id2name‎: :fred.id2name #=> "fred" :ginger.to_s #=> "ginger"‎ انظر أيضا التابع encoding: يُعيد الترميز الذي يمثل ترميز الرمز التي استُدعي معه. التابع inspect: يعيد سلسلة نصية تمثِّل الرمز التي استُدعي معه. التابع intern: يُعيد الرمز المقابل للسلسلة النصية التي استدعي معها، أو يُنشىء ذلك الرمز إذا لم يكن ...

يعيد التابع coerce‎ مصفوفة تضم القيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، وذلك عبر تحويل numeric إلى Bignum. سيُطلق الخطأ TypeError في حال لم يكن numeric المعطى من النوع Fixnum أو Bignum. البنية العامة coerce(numeric) → array‎ القيمة المعادة تعاد مصفوفة تضم قيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، عبر تحويل numeric إلى Bignum. أمثلة مثال على استخدام التابع coerce‎: (0x3FFFFFFFFFFFFFFF+1).coerce(42) #=> [42, 4611686018427387904] ‎ انظر أيضا التابع chr: يعيد سلسلة نصية تحتوي على ...

يضبط التابع default_external التّرميز الخارجي الافتراضي. لا يجدر بك ضبط قيمة التابع default_external:: في شيفرة روبي إذ أنَّ السّلاسل النّصية التي أُنشئت قبل تعديل القيمة قد تملك ترميزًا مختلفًا عن السّلاسل المنشأة بعد تغيير القيمة. يجب أن عليك أن تستخدم ruby -E بدلاً منها لاستدعاء روبي مع الترميز الخارجي الصحيح. ألقِ نظرة على التابع default_external:: لمعلومات أوسع عن طريقة استخدام التّرميز الخارجي الافتراضي. البنية العامة default_external = enc انظر أيضًا التّابع ?dummy: يتحقّق من التّرميز الزّائف. التابع default_external::: يُعيد قيمة ...

يضبط التّابع default_internal القيمة الافتراضية التّرميز الداخلي أو يحذفها عند تعيين القيمة nil. لا يجدر بك ضبط قيمة التابع ‎::default_internal في شيفرة روبي، إذ أن السّلاسل النّصية التي أُنشئَت  قبل تعديل القيمة قد تملك ترميزًا مختلفًا عن السّلاسل المنشأة بعد تغيير القيمة. يجب عليك أن تستخدم ruby -E بدلاً منها لبدء روبي مع الترميز الداخلي الافتراضي الصحيح. ألقِ نظرة على التابع default_internal:: لمعلومات أوسع عن طريقة استخدام التّرميز الداخلي الافتراضي. البنية العامة default_internal = enc or nil انظر أيضًا التّابع ...

يعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. البنية العامة name_list → ["enc1", "enc2", ...] القيم المعادة تُعاد قائمة بأسماء التّرميزات المتاحة. أمثلة مثالٌ عن استخدام التابع name_list: Encoding.name_list #=> ["US-ASCII", "ASCII-8BIT", "UTF-8", "ISO-8859-1", "Shift_JIS", "EUC-JP", "Windows-31J", "BINARY", "CP932", "eucJP"] انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التّابع inspect: ...

يفكك التابع digits‎ العدد الذي استٌدعي معه عبر تقسيم الأرقام التي تكوّنه من اليسار إلى اليمين، بحيث تكون أصغر من الوسيط الممرر إليه ثم يضعها في مصفوفة، مع وضع الرقم الأقل أهمية (least significant digit) في بداية المصفوفة. البنية العامة digits → array digits(base) → array‎ المعاملات base‎ عدد صحيح يمثل الأساس. يجب أن تكون قيمته أكبر من أو تساوي 2. القيمة الافتراضية: 10. القيمة المعادة تعاد مصفوفة تضم ناتج تفكيك العدد الذي استٌدعي معه. أمثلة مثال على ...

يتحقق التابع casecmp?‎ إن كان الرمز الذي استُدعي معه والرمز المُمرَّر إليه متساويين بشكل غير حساس لحالة الأحرف. البنية العامة casecmp?(other_symbol)→ true, false, or nil‎ المعاملات other_symbol‎ الرمز الآخر المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الرمز الذي استُدعي معه والرمز other_symbol المعطى متساويين بعد طي حالة الترميز الموحد (Unicode case folding)، أو تعاد القيمة false إذا لم يكونا متساويين، أو تُعاد القيمة nil إذا كان للرمزين ترميزين غير متوافقين، أو إن لم يكن other_symbol رمزًا. أمثلة ...

ينشئ التابع new كائنًا جديدًا من النوع IO انطلاقًا من واصف الملف (file descriptor) ووضع الفتح الممرَّرين إليه. يُستدعَى التابع new عبر العديد من توابع الفتح الخاصة بالصنفين File و IO، مثل open و Kernel.open و File.open. البنية العامة new(fd [, mode] [, opt])→ io‎ المعاملات fd‎ واصف الملف المراد فتحه. mode‎ وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف fd. وضع الفتح (Open Mode) إن كان المعامل mode عددًا صحيحًا، فيجب أن يكون مزيجًا من الأوضاع المعرفة ...

يتحقّق التابع compatible?‎ من توافق كائنين مع بعضهما بعضًا. إذا كان نوع كلا الكائنين سلسلة نصية (string)، فإنهما يكونان متوافقين عندما يكونان قابلين للتسلسل (Concatenation). أمَّا إن لم يكن هذان الكائنان سلسلةً نصيةً، فسيُعدُّ كلاهما متوافقين عندما يملكان ترميزًا وكان: كلا الترميزين متوافق مع الترميز US-ASCII، أو أحد هذان التّرميزان هو ترميز من النوع 7-bit. البنية العامة compatible?(obj1, obj2) → enc or nil المعاملات obj1 الكائن الأول المراد التحقق من توافقه مع الكائن obj2. obj2 الكائن الثاني المراد التحقق من ...

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

يقارن التابع casecmp بين رمزين بشكل غير حساس لحالة الأحرف. هذا التابع هو نسخة غير حساسة لحالة الأحرف (Case-insensitive) من المعامل <=>‎. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف A-Z/a-z، وليس على كل محارف اليونيكود. هذا السلوك مختلف عن التابع casecmp?‎. البنية العامة casecmp(other_symbol)→ -1, 0, +1, or nil‎ المعاملات other_symbol‎ الرمز المراد التحقق من مقارنته مع الرمز المعطى. القيمة المعادة تعاد القيمة ‎-1 أو 0 أو ‎+1 أو بناءً على ما إذا كان الرمز أصغر من أو يساوي أو أكبر من other_symbol. أو ...

يُعيد التّابع default_internal:: قيمة التّرميز الداخلي الافتراضية. يُغيَّر ترميز السّلاسل النصّية في الحالات التّالية إذا لم تكن قيمة التّرميز الداخلي الافتراضية مضبوطةً إلى القيمة nil: الملفات ذات الصيغة CSV. التابع Etc.systmpdir و التابع Etc.sysconfdir. بيانات الصنف File المقروءة من القرص. أسماء الملفات الموجودة في الصنف File المقروءة من مجرى أحد المجلدات Dir. التابع Integer.chr. التابع Regexp.inspect والتابع String.inspect. السلاسل النصية المعادة أثناء قراءة الأسطر. السلاسل المعادة من الصنف SBDM. التابع Time.zone. القيم المعادة من الصنف ENV. القيم التابعة للصنف ARGV ...

يتحقق التابع unicode_normalized?‎ إذا كانت السلسلة النصية التي استدعيت معه ذات ترميز موحَّد باستخدام أحد ترميزات يونيكود الموحدة (Unicode normalizations). يطلق التابع استثناءً إذا كانت السلسلة النصية غير مُرمّزة بترميز يونيكود. لمزيد من التفاصيل، اطلع على صفحة التابع unicode_normalize. البنية العامة unicode_normalized?(form=:nfc) المعاملات form يحدد نمط ترميزات يونيكود الموحدة المراد التحقق منها مع السلسلة النصية المعطاة؛ ويأخذ إحدى القيم التالية: nfc: (القيمة الافتراضية) nfd: nfkc: nfkd: القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية مرمزة بأحد ترميزات يونيكود الموحدة ...

يُعيد التابع default_external:: قيمة الترميز الخارجي الافتراضية. يُستخدَم التّرميز الخارجي الافتراضي دومًا مع السّلاسل النصّية التي أُنشئت في الأماكن التّالية: الملفات ذات الصيغة CSV. بيانات الصنف File المقروءة من القرص. الصنف SDBM. الصنف StringIO. الصنف Zlib::GzipReader. الصنف Zlib::GzipWriter. التابع String.inspect. التابع Regexp.inspect. إن السلسلة النصية المنشأة من هذه الأماكن ستكون مرمَّزةً بهذا الترميز، ولكن قد يكون هذا الترميز غير صالح لها. حاول دومًا أن تتحقّق من ذلك من خلال التابع ?String.valid_encoding. يُغيَّر ترميز بيانات الصنف File عند كتابتها إلى القرص ...

تحلل الدالة سلسلة الاستعلام النصية المعطاة كسلسلة معاملات نصية string argument (بيانات من نوع application/x-www-form-urlencoded). تعاد البيانات على هيئة قائمة أزواج اسم، قيمة. البنية العامة urllib.parse.parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) ‎المعاملات keep_blank_values راية تحدد إذا ما كان المطلوب معاملة القيم الفارغة في سلاسل الاستعلام المرمّزة بالنسبة المئوية percent-encoded queries على أنّها سلاسل نصية فارغة. تشير القيمة الصحيحة لهذا المعامل إلى أنّ الفراغات ستبقى سلاسل نصية فارغة، أما القيمة الخاطئة (وهي القيمة الافتراضية) فتشير إلى أن القيم الفارغة ستُتجاهل من ...

تحلل الدالة سلسلة الاستعلام المعطاة كسلسلة من المعاملات (بيانات من نوع application/x-www-form-urlencoded). تعاد البيانات على هيئة قاموس، تكون مفاتيحه أسماء متغيرات الاستعلام وقيمه قوائم تضمّ قيم كل اسم من أسماء المتغيرات. البنية العامة urllib.parse.parse_qs(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) ‎المعاملات keep_blank_values راية تحدد إذا ما كان المطلوب معاملة القيم الفارغة في سلاسل الاستعلام المرمّزة بالنسبة المئوية percent-encoded queries على أنّها سلاسل نصية فارغة. تشير القيمة الصحيحة لهذا المعامل إلى أنّ الفراغات ستبقى سلاسل نصية فارغة، أما القيمة الخاطئة (وهي القيمة ...

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. البنية العامة urllib.parse.quote(string, safe='/', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يحمل هذا المعامل القيمة الافتراضية '/'. string يمكن أن يكون سلسلة نصية أو كائن bytes. ملاحظة: اعتُمد المعيار RFC 3986 عوضًا عن المعيار RFC 2396 لاقتباس سلاسل URL النصية في الإصدار 3.7 من بايثون، وقد أضيف الرمز "~" إلى مجموعة المحارف المحجوزة. encoding و errors ...