الفرق بين المراجعتين لصفحة: «Ruby/Encoding/find»

المراجعة الحالية بتاريخ 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: يُعيد اسم التّرميز المستخدم.

مصادر

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

@@ سطر 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>
 </syntaxhighlight>