الفرق بين المراجعتين لصفحة: «Ruby/Encoding/find»
إضافة كافة معلومات التابع |
لا ملخص تعديل |
||
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
{{DISPLAYTITLE:التابع <code>Encoding.find</code> في روبي}} | |||
يبحث التّابع find عن | يبحث التّابع <code>find</code> عن ترميزٍ باسمٍ محدّد. | ||
الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: | الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: | ||
سطر 19: | سطر 19: | ||
== القيم المعادة == | == القيم المعادة == | ||
يعاد الترميز ذو الاسم string في حال إيجاده، أو يرمى الخطأ ArgumentError خلاف ذلك. | يعاد الترميز ذو الاسم string في حال إيجاده، أو يرمى الخطأ <code>ArgumentError</code> خلاف ذلك. | ||
تعاد القيمة nil عند البحث عن الترميز الداخلي الافتراضي أي ("Encoding.find("internal وكانت قيمته غير محددة بعد؛ بعبارةٍ أُخرى، عندما لا تملك روبي ترميزًا داخليًّا افتراضيًّا. | تعاد القيمة <code>nil</code> عند البحث عن الترميز الداخلي الافتراضي أي <code>("Encoding.find("internal</code> وكانت قيمته غير محددة بعد؛ بعبارةٍ أُخرى، عندما لا تملك روبي ترميزًا داخليًّا افتراضيًّا. | ||
== أمثلة == | == أمثلة == | ||
مثالٌ عن استخدام التّابع find:<syntaxhighlight lang="ruby"> | مثالٌ عن استخدام التّابع <code>find</code>:<syntaxhighlight lang="ruby"> | ||
Encoding.find("US-ASCII") #=> #<Encoding:US-ASCII> | Encoding.find("US-ASCII") #=> #<Encoding:US-ASCII> | ||
</syntaxhighlight> | </syntaxhighlight> |
المراجعة الحالية بتاريخ 18:44، 8 أكتوبر 2018
يبحث التّابع 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
: يُعيد اسم التّرميز المستخدم.
مصادر