الفرق بين المراجعتين لصفحة: «Ruby/String/encode-21»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) إضافة المحتوى |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يحول التابع <code>encode!</code> سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيدها. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">encode!(encoding [, options] ) → str | <syntaxhighlight lang="ruby">encode!(encoding [, options] ) → str | ||
encode!(dst_encoding, src_encoding [, options] ) → str</syntaxhighlight> | encode!(dst_encoding, src_encoding [, options] ) → str</syntaxhighlight>يحول الشكل الأول من التابع السلسلة النصية التي استدعيت معه من الترميز المرمزة به إلى الترميز <code>encoding</code> المعطى. أمَّا الشكل الثاني، فيحول السلسلة النصية التي استدعيت معه من الترميز <code>dst_encoding</code> إلى الترميز <code>src_encoding</code>. | ||
== المعاملات == | |||
=== <code>encoding</code> === | |||
الترميز المراد تحويل السلسلة النصية المعطاة إليه. | |||
=== <code>dst_encoding</code> === | |||
الترميز الوجهة المراد تحويل السلسلة النصية المعطاة إليه. | |||
=== <code>srd_encoding</code> === | |||
الترميز الهدف المراد تحويل السلسلة النصية المعطاة منه. أي يمثِّل الترميز الحالي للسلسلة النصية المعطاة. | |||
=== <code>options</code> === | |||
جدول Hash يعطي تفاصيل عملية التحويل. اطلع على التابع <code>[[Ruby/String/encode|encode]]</code> لمزيد من التفاصيل حول المفتاتيح التي يمكن استعمالها مع هذا الخيار. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تعاد السلسلة النصية المعطاة بعد تحويلها من ترميزٍ إلى ترميزٍ آخر محدَّد. | |||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/ascii only-3F|ascii_only?]]</code>: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز <nowiki/>[[Arduino/asciichart|ASCII]] فقط. | |||
* التابع <code>[[Ruby/String/encode|encode]]</code>: يحول سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيد نسخة عنها. | |||
* التابع <code>[[Ruby/String/encoding|encoding]]</code>: يُعيد ترميز السلسلة النصية التي استُدعيت معه. | |||
* التابع <code>[[Ruby/String/force encoding|force_encoding]]</code>: يغير ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-encode-21 قسم التابع encode! في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-encode-21 قسم التابع encode! في الصنف String في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 08:27، 26 مارس 2019
يحول التابع encode! سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيدها.
البنية العامة
encode!(encoding [, options] ) → str
encode!(dst_encoding, src_encoding [, options] ) → str
يحول الشكل الأول من التابع السلسلة النصية التي استدعيت معه من الترميز المرمزة به إلى الترميز encoding المعطى. أمَّا الشكل الثاني، فيحول السلسلة النصية التي استدعيت معه من الترميز dst_encoding إلى الترميز src_encoding.
المعاملات
encoding
الترميز المراد تحويل السلسلة النصية المعطاة إليه.
dst_encoding
الترميز الوجهة المراد تحويل السلسلة النصية المعطاة إليه.
srd_encoding
الترميز الهدف المراد تحويل السلسلة النصية المعطاة منه. أي يمثِّل الترميز الحالي للسلسلة النصية المعطاة.
options
جدول Hash يعطي تفاصيل عملية التحويل. اطلع على التابع encode لمزيد من التفاصيل حول المفتاتيح التي يمكن استعمالها مع هذا الخيار.
القيمة المعادة
تعاد السلسلة النصية المعطاة بعد تحويلها من ترميزٍ إلى ترميزٍ آخر محدَّد.
انظر أيضًا
- التابع
ascii_only?: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. - التابع
encode: يحول سلسلة نصية مرمزة بترميز محدَّد إلى ترميز آخر ثم يعيد نسخة عنها. - التابع
encoding: يُعيد ترميز السلسلة النصية التي استُدعيت معه. - التابع
force_encoding: يغير ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها.