التابع Encoding.find في روبي

يبحث التّابع find عن ترميزٍ باسمٍ محدّد.

الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية:

• "external": يمثل الترميز الخارجي الافتراضي (default external encoding).
• "internal": يمثل الترميز الداخلي الافتراضي (default external encoding).
• "locale": يمثل الترميز المحدد في المحلية (locale encoding).
• "filesystem": يمثل ترميز نظام الملفات (filesystem encoding).

البنية العامة

find(string) → enc

المعاملات

string

سلسلة نصية تمثل اسم الترميز المراد البحث عنه.

القيم المعادة

يعاد الترميز ذو الاسم string في حال إيجاده، أو يرمى الخطأ ArgumentError خلاف ذلك.

تعاد القيمة nil عند البحث عن الترميز الداخلي الافتراضي أي ("Encoding.find("internal وكانت قيمته غير محددة بعد؛ بعبارةٍ أُخرى، عندما لا تملك روبي ترميزًا داخليًّا افتراضيًّا.

أمثلة

مثالٌ عن استخدام التّابع find:

Encoding.find("US-ASCII")  #=> #<Encoding:US-ASCII>

انظر أيضًا

• التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة.
• التابع list: يعيد قائمةً بالترميزات المُحمّلة (loaded encodings).
• التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة.
• التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط.
• التّابع name: يُعيد اسم التّرميز المستخدم.
• التّابع names: يُعيد الأسماء والأسماء البديلة الخاصّة بالتّرميز المستخدم.
• التّابع to_s: يُعيد اسم التّرميز المستخدم.

مصادر

• قسم التابع find‎‎ في الصنف Encoding في توثيق روبي الرسمي.