نتائج البحث

تُقرأ شيفرات بايثون بواسطة المحلّل parser. مدخلات المحلّل هي تدفّق من العلامات tokens التي ينشئها محلل المفردات lexical analyzer. يصف هذا القسم طريقة تقسيم ملفات بايثون إلى علامات بواسطة محلل المفردات. بنية السطر تقسم شيفرة بايثون إلى نوعين من الأسطر هما الأسطر المنطقية والأسطر الفيزيائية. الأسطر المنطقية Logical lines ينتهي السطر المنطقي بعلامة السطر الجديد NEWLINE، ولا يمكن للعبارات أن تتجاوز حدود السطر المنطقي إلا إذا كانت صيغتها تسمح بذلك. ويتألف السطر المنطقي من سطر فيزيائي واحد أو أكثر وبالاعتماد ...

(PHP 4, PHP 5, PHP 7) تُقدِّر البنيةُ eval()‎ قيمة شيفرة PHP المُمثَّلة في سلسلةٍ نصيةٍ الوصف mixed eval ( string $code ) تُقدِّر البنيةُ eval()‎ قيمة شيفرة PHP المُمثَّلة في سلسلةٍ نصيةٍ. تحذير: إن البنية eval()‎ خطيرة للغاية لأنها تسمح بتنفيذ أي شيفرة مكتوبة بلغة PHP اعتباطيًا. وبالتالي لا يُنصَح باستعمالها. إذا كنت قد تحققت من عدم وجود خيار آخر سوى استخدام هذه البِنْيَة، فَأَوْلِ اهتمامًا خاصًا لعدم تمرير أي بيانات مقدمة من المستخدم إليها دون التحقق من صحتها مسبقًا. ...

تتكون جميع شيفرات PHP من سلسلة من العبارات (statements)، ويمكن للعبارة أن تكون إسنادًا (assignment) أو استدعاءً لدالّة، أو حلقة تكرارية، أو عبارة شرطية أو حتى عبارة لا تقوم بأي عمل على الإطلاق (عبارة فارغة). تنتهي العبارات عادة بالفاصلة المنقوطة (;)، ويمكن تجميع العبارات بإحاطتها بالأقواس المعقوفة ({}) لتصبح مجموعة عبارات (statement-group)، والتي تعدّ بدورها عبارات أيضًا. سنفصل الحديث في هذا الفصل عن أنواع متعددة من العبارات. if بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات ...

وسوم PHP عندما تُفسِّر PHP ملفًا فهي تبحث عن وسوم البداية والنهاية، وهي ‎<?php و ‎?>‎، والتي تخبر PHP أين يجب أن تُفسِّر الشيفرات، وهذا يعني أنَّ بالإمكان تضمين لغة PHP في مختلف أنواع المستندات، وسيتجاهل المُفسِّر أي شيء خارج وسمَي البداية والنهاية. تسمح PHP بوسم البداية المختصر وهو ‎<?‎ (لكن استعماله غير منصوح به، لأنها لا يعمل إلا إذا فعّلناه باستخدام تعليمة الضبط short_open_tag). إذا كان الملف لا يحتوي إلا على شيفرات PHP، فمن المستحسن حذف وسم النهاية في ...

سنتعلم في هذا الباب كيف نبني سلاسل شرطية في برامجنا بحيث نستطيع اتخاذ إجراءات مختلفة بناء على نجاح الأوامر أو فشلها، وستُحدد تلك الإجراءات باستخدام عبارة if، وسيسمح هذا بتنفيذ مقارنات حسابية ونصية، واختبار رموز الخروج والمدخلات والملفات التي يحتاجها البرنامج. عادة ما يسبق الأوامر في برامج الصدفة اختبارُ if/then/fi لمنع إنشاء الخرج كي يعمل البرنامج في الخلفية أو من خلال أداة cron، أما الشروط الأكثر تعقيدًا فتوضع في عبارة case. ويخبر البرنامج الصدفة الأم عند نجاح اختبار الشرط باستخدام ...

(PHP 4, PHP 5, PHP 7) تُخرج البنية exit()‎ رسالةً وتنهي البرنامج الحالي. الوصف void exit ([ string $status ] ) void exit ( int $status ) توقف البنية exit()‎ تنفيذ البرنامج. أما دوال إيقاف التشغيل والدالة الهادمة فستُنفَّذ دومًا حتى في حالة استدعاء البنية exit()‎. البنية exit()‎ بنية من بنى اللغة (language construct)، ويمكن استدعاؤها بدون أقواس إذا لم يُمَرر إليها المعامل status. المعاملات status إذا كانت قيمة المعامل status سلسلةً نصيةً، فستطبع البنية اللغوية exit()‎ المعامل status قبل إنهاء تنفيذ ...

حالات مُبسطة قد يكون من السهل اللجوء إلى استخدام عبارات if لبداهة أسلوبها، لكن تلك السهولة تنقلب إلى حيرة حين تواجه بضعة اختيارات مختلفة لإجراءات محتملة يجب اتخاذها، ولمثل تلك الحالات نستخدم عبارة case، وبنيتها اللغوية هي كما يلي: case EXPRESSION in CASE1) COMMAND-LIST;; CASE2) COMMAND-LIST;; ... CASEN) COMMAND-LIST;; esac وتطابق كل حالة في التعبير السابق نمطًا (pattern)، وتُنفَّذ الأوامر التي في قائمة COMMAND-LIST لأول تطابق، ويُستخدم محرف الأنبوب | لفصل الأنماط المتعددة، وينهي معامِل ( قائمة الأنماط، ويُطلق اسم البند ...

وسوم PHP عندما تُفسِّر PHP ملفًا فهي تبحث عن وسوم البداية والنهاية، وهي ‎<?php و ‎?>‎، والتي تخبر PHP أين يجب أن تُفسِّر الشيفرات، وهذا يعني أنَّ بالإمكان تضمين لغة PHP في مختلف أنواع المستندات، وسيتجاهل المُفسِّر أي شيء خارج وسمَي البداية والنهاية. تسمح PHP بوسم البداية المختصر وهو ‎<?‎ (لكن استعماله غير منصوح به، لأنها لا يعمل إلا إذا فعّلناه باستخدام تعليمة الضبط short_open_tag). إذا كان الملف لا يحتوي إلا على شيفرات PHP، فمن المستحسن حذف وسم النهاية في ...

(PHP 4, PHP 5, PHP 7) تكافئ البنيةُ die البنيةَ exit()‎. الوصف تكافئ البنيةُ die البنيةَ exit()‎. مصادر صفحة البنية die في توثيق PHP الرسمي.

مقدمة تهدف هيكلية تطبيق Laravel الافتراضية إلى توفير نقطة بداية رائعة لكل من التطبيقات الكبيرة والصغيرة. بالطبع، أنت حر في تنظيم تطبيقك كما تشاء. لا يفرض Laravel أي قيود تقريبًا على مكان وجود أي صنف من أصناف مشروعك، طالما أن Composer يمكنه تحميل الصنف تلقائيًا. أين هو مجلّد النماذج؟ عند عملية البدء مع Laravel، يشوشّ العديد من المطورين بسبب عدم وجود المجلّد models. ومع ذلك، فإن عدم وجود مثل هذا المجلّد هو متعمد. نجد كلمة "نماذج" غامضة لأنها تعني الكثير ...

(PHP 4, PHP 5, PHP 7) تطبع print‎ سلسلةً نصيةً. الوصف int print ( string $arg ) تُخرِج print‎‎ المعامل arg. ليست print في الواقع دالةً حقيقية إنما هي بنيةٌ من بنى اللغة (language construct)، لذلك لا حاجة لاستخدام الأقواس لتمرير الوسائط إليها. الاختلافان الرئيسيّان مع البنية echo هما أنَّ print لا تقبل إلا معاملًا واحدًا وأنها تعيد القيمة 1 دائمًا. المعاملات arg البيانات المدخلة. القيم المعادة تعيد 1 دائمًا. الأمثلة مثال 1: أمثلة على البنية print <?php print("Hello World"); print "print() also ...

(PHP 4, PHP 5, PHP 7) تعرض ‎echo سلسلةً نصيةً وحيدة أو عدة سلاسل نصية. الوصف void echo ( string $arg1 [, string $... ] ) تُخرِج echo كل المعاملات، ولا تضيف إليها سطرًا جديدًا بعدها. لا تعدّ echo دالةً بالمعنى الصريح للكلمة إذ تُعد بنيةً من بنى اللُّغة (‎language construct) لذلك فلستَ مجبرًا على إضافة الأقواس لها. على العكس من بنى اللُّغة الأخرى، فإن echo لا تتصرف مثل الدوال لذلك لا يمكن استخدامها في سياق الدوال دائمًا. إذا أردنا استعمال ...

تعريف الحزم (Package) يُكتب توصيف الحزمة (package) في بداية الملف المصدريّ (source file) بالشكل الآتي: package my.demo import java.util.* // ... ولا يُشترط التوافق ما بين الحزمة (package) والمجلد الذي توجد فيه (directory)، إذ من الممكن أن تتوضع الملفات المصدريّة عشوائيًّا في نظام الملفات. المزيد عن الحزم (packages). تعريف الدوال (Function) إن كانت الدالة بمتحولين من نوع Int وتعيد قيمةً بنوع Int أيضًا، فسيصبح تعريفها بالشكل: fun sum(a: Int, b: Int): Int {   return a + b } أما الشيفرة الآتية فهي لتعريف دالةٍ باسم sum ...

بدءًا من ECMAScript 2015 (أي ES6)، يمكن تعريف الدوال التابعة للكائن بطريقة مختصرة عند تهيئة الكائنات. البنية العامة var obj = { property( parameters… ) {}, *generator( parameters… ) {}, async property( parameters… ) {}, async* generator( parameters… ) {}, // مع مفاتيح محسوبة [property]( parameters… ) {}, *[generator]( parameters… ) {}, async [property]( parameters… ) {}, // قارن مع شكل getter/setter get property() {}, set property(value) {} }; الوصف ...

تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. البنية العامة pprint.saferepr(object) القيمة المعادة تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. إن تضمّن تمثيل الكائن المعطى عنصرًا تعاوديًا، فإنّ الإشارة التعاودية ستمثّل بالصيغة ‎<Recursion on typename with id=number>‎، ولا يُنسّق التمثيل بطريقة أخرى. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pprint.pprint(stuff) [<Recursion on list with id=...>, 'spam', ...

يُنشئ المعامل =[] مرجعًا ضعيفًا (weak reference) من المفتاح المُعطى إلى القيمة المعطية. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. p2 القيمة المعطية. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل =[] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يُنشئ المعامل =[] مرجعًا ضعيفًا (weak reference) من المفتاح المُعطى إلى القيمة المعطية. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. p2 القيمة المعطية. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل =[] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يعيد المعامل [] كائنًا ذو مرجع ضعيف (weakly referenced) مع المفتاح المُعطى. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. انظر أيضًا المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل [] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يعيد المعامل [] كائنًا ذو مرجع ضعيف (weakly referenced) مع المفتاح المُعطى. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. انظر أيضًا المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل [] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقق التابع ?exist فيما إذا كان الملف المعطى مجلدًا. البنية العامة exist?(file_name) → true or false المعاملات file_name اسم الملف المعطى المراد التحقق منه. القيمة المعادة تُعاد القيمة true في حال كان الملف المعطى مجلدًا، وإلا فستُعاد القيمة false. انظر أيضًا التابع ?empty: يتحقق فيما إذا كان المجلد المعطى فارغًا. مصادر قسم التابع ?exist في الصنف Dir في توثيق روبي الرسمي.

يعيد التابع class صنف الكائن المعطى. يجب أن يُستدعى هذا التابع دائمًا مع مستقبل (receiver) صريح، إذ أنَّ class هي كلمةٌ محجوزةٌ في روبي. البنية العامة class → class القيم المعادة يعاد صنف الكائن المعطى المراد معرفة صنفه. أمثلة مثالٌ عن استخدام التابع class: 1.class #=> Integer self.class #=> Object انظر أيضًا التابع clone: يُنتج نسخةً سطحيةً من الكائن المعطى. التابع dup: ينتج نسخةً سطحية من الكائن. التابع tap: يُدخل الكائن المعطى إلى الكتلة ...

تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ...

تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ...

يعيد التابع to_path سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. لا يعمل هذا التابع على توحيد شكل وبنية المسار (normalize). قد لا يشير اسم المسار إلى الملف المقابل للملف المعطى. على سبيل المثال، يصبح اسم المسار خاويًا (void) عندما يُنقَل أو يحذف الملف. يرمي هذا التابع الاسثناء IOError للملف المعطى إذا كان قد أنشئ باستعمال File::Constants::TMPFILE لأنه لا يملك اسم مسارٍ.  البنية العامة to_path → filename القيمة المعادة تعاد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف ...

يعيد التابع String المعامل المعطى على شكل سلسلة نصية (String). يحاول التابع String في البدء استدعاء التابع to_str ثم التابع to_s. البنية العامة String(arg)→ string‎ المعاملات arg القيمة المراد تحويلها إلى سلسلة نصية. القيمة المعادة تعاد سلسلة نصية تحوي قيمة المعامل arg المعطى. أمثلة مثال على استخدام التابع String‎: String(self) #=> "main" String(self.class) #=> "Object" String(123456) #=> "123456" ‎ انظر أيضا التابع Array: يعيد المعامل المعطى على شكل مصفوفة (Array). التابع Integer: يحول ...

يعيد التابع path سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. لا يعمل هذا التابع على توحيد شكل وبنية المسار (normalize). قد لا يشير اسم المسار إلى الملف المقابل للملف المعطى. على سبيل المثال، يصبح اسم المسار خاويًا (void) عندما يُنقَل أو يحذف الملف. يرمي هذا التابع الاسثناء IOError للملف المعطى إذا كان قد أنشئ باستعمال File::Constants::TMPFILE لأنه لا يملك اسم مسارٍ. البنية العامة path → filename to_path → filename القيمة المعادة تعاد سلسلة نصية تمثِّل المسار الذي استُعمِل ...

يعيد التابع ‎ clamp‎الوسيط المُعطى min (أنظر فقرة البنية العامة) إن كان ناتج obj <=> min أقل من 0، أو يعيد max إن كان عائد obj <=> max أكبر من 0؛ خلا ذلك، سيعيد الكائنَ obj الذي استدعي معهق أي إن كان واقعًا ضمن المجال. البنية العامة clamp(min, max) → obj المعاملات min يمثل هذا المعامل القيمة الدنيا. max  يمثل هذا المعامل القيمة القصوى. القيمة المعادة تُعاد قيمة المعامل min إن كانت قيمة الكائن المعطى أصغر منها، أو تُعاد قيمة المعامل max إن كانت ...

تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلا فإنّها ستفتح العنوان المعطى في النافذة الموجودة فقط. البنية العامة webbrowser.open_new(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new_tab()‎: تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون ...

يجلب التابع instance_variable_get قيمة مُتغيِّر النسخة (instance variable) المُمرَّر إليه من الكائن المعطى، أو يُعيد قيمةً عدميّةً nil إذا كان المتغيِّر غير معيَّن في ذلك الكائن. يجب أن يحتوي اسم المُتغيِّر على الرمز @ في حال كان من متغيرات النسخة النظامية (regular instance variables). يُرمى الاستثناء NameError إذا كان الرَّمز المُعطى غير معرَّفٍ على أنَّه اسمٌ لمتغيِّر نسخة. تُحوَّل الوسائط النّصية المُمرَّرة إلى التابع إلى رموز. البنية العامة instance_variable_get(symbol) → obj instance_variable_get(string) → obj المعاملات symbol الرمزُ المراد جلب قيمته في ...

يُدخل التابع yield_self الكائن المعطى إلى الكتلة (block) ويُعيد ناتج تنفيذ هذه الكتلة. البنية العامة ield_self {|x| block } → an_object المعاملات x الكائن المراد إدخاله إلى الكتلة. block الكتلة المراد تنفيذها على الكائن. القيم المعادة يُعاد الكائن الناتج عن تنفيذ الكتلة block بعد تمرير الكائن المعطى إليها. أمثلة: مثالٌ عن استخدام التابع yield_self: "my string".yield_self {|s| s.upcase } #=> "MY STRING" 3.next.yield_self {|x| x**x }.to_s #=> "256" انظر أيضًا التابع class: يعيد ...

يعيد التابع nlink عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة nlink → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع nlink: File.stat("testfile").nlink #=> 1 File.link("testfile", "testfile.bak") #=> 0 File.stat("testfile").nlink #=> 2 انظر أيضًا التابع ftype: يعرِّف نوع الملف ...

يجلب المعامل [] قيمة عضو البنية المعطى، أو قيمة العضو ذي الفهرس المحدَّد. البنية العامة struct[member]→ object struct[index] → object‎ المعاملات member اسم العضو المراد جلب قيمته. index فهرس العضو المراد جلب قيمته. القيمة المعادة تعاد قيمة عضو البنية member المعطى، أو العضو ذو الفهرس index. يطلق الاستثناء NameError إن لم يكن member موجودًا، أو الاستثناء IndexError إن كان index خارج النطاق. أمثلة مثال على استخدام المعامل []‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe["name"] ...

ينشئ تابع الصنف هذا كائن ZipInfo للملف المعطى، ويهيّئه لإضافته إلى ملف zip. البنية العامة ZipInfo.from_file(filename, arcname=None) ‎ المعاملات filename مسار الملف أو المجلّد المعطى. arcname معامل اختياري، يستخدم كاسمٍ للملف المعطى داخل الأرشيف. في حال عدم تعيين قيمة لهذا المعامل، فإنّ اسم الملف المعطى سيبقى نفسه داخل الأرشيف، ولكن بعد اقتطاع محرف محرّك الأقراص وفواصل المسارات. ملاحظات: هذا التابع جديد في الإصدار 3.6 من بايثون. يستقبل المعامل filename كائنًا شبيهًا بالمسارات في الإصدار 3.6.2. مصادر صفحة Work with ZIP ...

تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. البنية العامة copyreg.constructor(object) ‎ المعاملات object الكائن الذي ستصرح الدالة بأنّه دالة بانية صحيحة. القيمة المعادة تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا يكون غير صالح لأن يصبح دالة بانية) فإنّ الدالة تطلق الاستثناء TypeError. انظر أيضًا الدالة copyreg.pickle: تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. مصادر صفحة Register pickle support ...

يجري المعامل & العملية And المنطقية على الكائن المعطى والقيمة nil أو false. يعيد المعامل القيمة false دائمًا. يُقيَّم هذا الكائن obj المعطى باعتباره دومًا معاملًا يُمرَّر إلى تابع عند استدعائه. ليس هنالك اختبارٌ لوجود «دارة قصيرة» (short-circuit) في هذه الحالة. البنية العامة false & obj→ false nil & obj → false‎ القيمة المعادة تعاد القيمة false دومًا مهما كانت قيمة الكائن obj. انظر أيضا المعاملor: يجري العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. المعامل ^: يجري العملية ...

يحسب التابع asinh معكوس الجيب القطعي (inverse hyperbolic sine) للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة asinh(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة معكوس الجيب القطعي للعدد x المعطى. أمثلة مثال على استخدام التابع asinh‎: Math.asinh(1) #=> 0.881373587019543‎ انظر أيضا التابع asin: يحسب معكوس الجيب للعدد المعطى. التابع atan: يحسب معكوس الظل (arc tangent) للعدد المعطى. مصادر قسم التابع asinh‎ في الصنف Math‎ في توثيق روبي الرسمي.

يعيد التابع size حجم الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف الذي يشير إليه الكائن File::Stat المعطى بالبايت. أمثلة مثال على استعمال التابع size: File.stat("testfile").size #=> 66 انظر أيضًا التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. التابع zero?‎: يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). مصادر قسم التابع size ...

يتحقق التابع class_variable_defined?‎ إن كان متغير الصنف (class variable) المعطى مٌعرّفا في الكائن الذي استُدعي معه. تُحوّل المعاملات النصية إلى رموز. البنية العامة class_variable_defined?(symbol) → true or false class_variable_defined?(string) → true or false‎ المعاملات symbol‎ رمز يمثل متغير الصنف. string‎ سلسلة نصية تمثل متغير الصنف. القيمة المعادة تعاد القيمة true إن كان متغير الصنف المعطى مٌعرّفا في الكائن المعطى، وإلا فستُعاد false. أمثلة مثال على استخدام التابع class_variable_defined?‎: class Fred @@foo = 99 end Fred.class_variable_get(:@@foo) #=> 99 انظر ...

يتكرَّر التابع each_key على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_key() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع keys على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة keys() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع keys في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع values على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة values() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع values في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع values على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة values() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع values في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_value على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_value() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_value في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_key على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_key() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_value على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_value() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_value في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_pair على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_pair() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_pair في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع keys على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة keys() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع keys في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_pair على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_pair() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_pair في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?nil فيما إذا كان الكائن المعطى هو nil أم لا. البنية العامة nil? → true or false القيم المعادة تُعاد القيمة true إذا كان الكائن المعطى هو nil؛ خلاف ذلك، تعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ?nil: Object.new.nil? #=> false nil.nil? #=> true انظر أيضًا التابع ?eql: يتحقَّق من استخدام كلا الكائنين نفس مفتاح التجزئة. التابع ?instance_of: يتحقَّق إذا كان الكائن الذي استدعي معه نسخةً من ...

يحسب التابع log10 اللوغاريتم ذا الأساس 10 للعدد المعطى. مجال التعريف: (‎0 ، INFINITY]. المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة log10(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج اللوغاريتم ذي الأساس 10 للعدد x المعطى. أمثلة مثال على استخدام التابع log10‎: Math.log10(1) #=> 0.0 Math.log10(10) #=> 1.0 Math.log10(10**100) #=> 100.0‎ انظر أيضا التابع log: يحسب لوغاريتم العدد المعطى. التابع log2: يحسب اللوغاريتم ذا الأساس ...

يعيد التابع has_value?‎ إذا كانت قيمةٌ معيَّنةٌ موجودةً في الكائن Hash المعطى ومرتبطة بمفتاح. البنية العامة has_value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها. القيمة المعادة تعاد القيمة true إذا كانت القيمة value المُعطاة موجودةً ومرتبطة بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في ...

يعيد التابع log2 اللوغاريتم ذا الأساس 2 للعدد المعطى. مجال التعريف: (‎0 ، INFINITY]. المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة log2(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج اللوغاريتم ذي الأساس 2 للعدد x المعطى. أمثلة مثال على استخدام التابع log2‎: Math.log2(1) #=> 0.0 Math.log2(2) #=> 1.0 Math.log2(32768) #=> 15.0 Math.log2(65536) #=> 16.0‎ انظر أيضا التابع log10: يحسب اللوغاريتم ذا الأساس 10 للعدد ...

يُعيِّن التابع instance_variable_set قيمة متغيِّر نسخةٍ (instance variable) محدِّدٍ إلى قيمة معيَّنة في الكائن المُعطى؛ هذا يؤدي إلى إحباط جهود منشئ الصنف في محاولة توفير التغليف (encapsulation) المناسب. ليس من الضروري أن يتواجد المتغيِّر قبل استدعاء هذا التابع. إذا مُرِّر اسم متغيِّر النسخة بشكل سلسلةٍ نصيةٍ (string)، فستُحوَّل تلك السلسلة إلى رمز. البنية العامة instance_variable_set(symbol, obj) → obj instance_variable_set(string, obj) → obj المعاملات symbol الرمزُ الذي يشير إلى اسم متغيِّر النسخة المراد تعيين قيمة المعامل obj إليه في الكائن المُعطى. string ...

يتحقَّق التابع ?instance_of إذا كان الكائن الذي استدعي معه نسخةً من الصِّنف المُمرَّر إليه. البنية العامة instance_of?(class) → true or false المعاملات class الصنف المراد التحقُّق أنَّ الكائن المعطى نسخةٌ منه. القيم المعادة تُعاد القيمة true إذا كان الكائن المعطى نسخةً من الصنف class؛ خلاف ذلك، تُعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ?instance_of: class A; end class B < A; end class C < B; end b = B.new b.instance_of? A #=> false b.instance_of? B ...

يتحقق التابع ?empty فيما إذا كان المجلد المعطى فارغًا. البنية العامة empty?(path_name) → true or false المعاملات string يحتوي عنوان المجلد المراد التحقق منه. القيمة المعادة ستُعاد القيمة true في حال كان المجلد string المعطى فارغًا، وإلا فستعاد القيمة false. انظر أيضًا التابع ?exist: يتحقق فيما إذا كان الملف المعطى مجلدًا موجودًا.  مصادر قسم التابع ?empty في الصنف Dir في توثيق روبي الرسمي.

يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى. البنية العامة FieldStorage.getlist(name) ‎المعاملات name اسم الحقل المراد جلب القيمة المرتبطة به. القيمة المعادة يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى، ويعيد قائمة فارغة إن لم يكن هناك حقل أو قيمة النموذج تحمل الاسم المعطى، ويعيد قائمة تحتوي على عنصر واحد فقط إن كانت هناك قيمة واحدة فقط. أمثلة يبين المثال التالي كيفية استخدام التابع: import cgi form = cgi.FieldStorage() for item in form.getlist("item"): do_something(item) انظر أيضًا التابع ...

يتحقق التابع zero?‎ إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero? → true or false القيمة المعادة تعاد القيمة true إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع zero?‎: File.stat("testfile").zero? #=> false انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat ...

يجلب التابع instance_variables جميع أسماء متغيرات النسخة (instance variable) للمستقبل (receiver) المعطى. لاحظ أنَّ مجرَّد تعريف واصلٍ (accessor) لا يُنشئ متغيِّر النسخة الموافق له. البنية العامة instance_variables → array القيم المعادة تُعاد مصفوفةٌ تحتوي أسماء متغيرات النسخة للكائن المعطى. أمثلة مثالٌ عن استخدام التابع instance_variables: class Fred attr_accessor :a1 def initialize @iv = 3 end end Fred.new.instance_variables #=> [:@iv] انظر أيضًا التابع instance_variable_get: يجلب قيمة مُتغيِّر النسخة المُمرَّر إليه من الكائن المعطى. التابع instance_variable_set: ...

يتحقق التابع value?‎ إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. البنية العامة value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها وارتباطها بمفتاح في الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كانت القيمة المُمرَّرة إليه موجودةً ومرتبطةً بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع ...

يتحقق التابع writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. البنية العامة writable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع writable?‎: انظر أيضًا التابع readable?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف ...

يتحقق التابع sticky?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit). البنية العامة sticky? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit)، أو تعاد القيمة false إن لم يكن البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع sticky?‎: File.stat("testfile").sticky? #=> false انظر أيضًا التابع owned?‎: يتحقق إن ...

يتحقق التابع من وجود الخيار المعطى في القسم المحدّد. البنية العامة has_option(section, option) ‎المعاملات ‎section القسم الذي سيبحث فيه التابع عن الخيار المعطى. option الخيار الذي سيبحث عنه التابع. القيمة المعادة إن كان القسم المعطى موجودًا ويتضمّن الخيار المعطى فإنّ التابع يعيد القيمة True، ويعيد القيمة False فيما عدا ذلك. إن كان القسم المحدّد هو None أو سلسلة نصية فارغة، فإنّ التابع يفترض بأنّه القسم DEFAULT. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 ...

يتحقق التابع writable_real?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. البنية العامة writable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع chardev?‎: File.stat("testfile").writable_real? #=> true انظر أيضًا التابع readable_real?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى ...

ينفذ المعامل | العملية OR بين بتات العددين المعطيين. البنية العامة int | other_int → integer‎ القيمة المعادة يعاد ناتج تنفيذ العملية OR بين بين العدد int الصحيح والعدد other_int الصحيح. أمثلة مثال على استخدام المعامل |: 20 | 3 #=> 23 25 | 2 #=> 27 انظر أيضا المعامل ^: ينفذ العملية XOR بين بتات العددين المعطيين. المعامل &: ينفذ العملية AND بين بتات العددين المعطيين. مصادر قسم المعامل|‎في الصنف Integer‎ ...

الصنف الوحيد الذي تقدمه الوحدة pprint وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. البنية العامة ‎pprint.PrettyPrinter(indent=1, width=80, depth=None, stream=None, *, compact=False) المعاملات indent يُحدّد مقدار الإزاحة المضافة لكل مستوى تعاودي عن طريق المعامل indent الذي يأخذ القيمة 1 كقيمة افتراضية. قد تظهر المخرجات بمظهر غريب أحيانًا عند استخدام قيم أخرى لهذا المعامل، ولكن يمكن بسهولة تمييز النتائج المتشعّبة. width تحدّد قيمة هذا المعامل مقدار العرض المسموح به للمخرجات، والقيمة الافتراضية ...

الصنف الوحيد الذي تقدمه الوحدة pprint وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. البنية العامة ‎pprint.PrettyPrinter(indent=1, width=80, depth=None, stream=None, *, compact=False) المعاملات indent يُحدّد مقدار الإزاحة المضافة لكل مستوى تعاودي عن طريق المعامل indent الذي يأخذ القيمة 1 كقيمة افتراضية. قد تظهر المخرجات بمظهر غريب أحيانًا عند استخدام قيم أخرى لهذا المعامل، ولكن يمكن بسهولة تمييز النتائج المتشعّبة. width تحدّد قيمة هذا المعامل مقدار العرض المسموح به للمخرجات، والقيمة الافتراضية ...

يتحقق التابع size?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size? → Integer or nil القيمة المعادة تعاد القيمة nil إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعاد عدد صحيح يمثِّل حجم هذا الملف. انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. ...

يعيد التابع ino رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ino → integer القيمة المعادة يعاد عدد صحيح يمثِّل رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع ino: File.stat("testfile").ino #=> 1083669 انظر أيضا التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. التابع ftype: يعرِّف نوع الملف الذي يشير إليه الكائن File::Stat المعطى. التابع gid: يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. ...

يتحقق التابع member?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل ==كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة member?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجود في الكائن Hash المعطى. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع member?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") #=> false انظر ...

يحول التابع to_i قيمة التوقيت المعطى إلى عدد صحيح يمثل الثواني التي مرت منذ توقيت يونكس. البنية العامة to_i→ int‎ القيمة المعادة تعاد قيمة التوقيت كعدد صحيح يمثل عدد الثواني التي مرت منذ توقيت يونيكس. أمثلة مثال على استخدام التابع to_i‎: t = Time.now "%10.5f" % t.to_f #=> "1270968656.89607" t.to_i #=> 1270968656‎ انظر أيضًا التابع to_a: يحول التوقيت الذي استدعي معه إلى مصفوفة.. التابع to_f: يحول قيمة التوقيت المعطى إلى ...

يتحقق التابع key?‎ إذا كان مفتاحٌ محدَّدٌ موجودًا في الكائن Hash المستدعى معه. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده في الكائن الكائن Hash المعطى. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع key?‎: h = { "a" => 100, "b" => ...

ينسق التابع printf الكائنات المُمرَّرة إليه ثم يكتبها في المجرى الذي استدعي معه. البنية العامة printf(format_string [, obj, ...])→ nil‎ المعاملات format_string‎ سلسلة نصية تحدد التنسيق الكائنات المراد كتابتها على المجرى المعطى. اطلع على صفحة التابع Kernel.sprintf لمزيد من التفاصيل حول هذا المعامل. obj‎ كائن يراد كتابته على المجرى المعطى. ... الكائنات الأخرى المراد كتابتها على المجرى المعطى. القيمة المعادة تعاد القيمة nil بعد تنسيق الكائنات obj و ... وكتابتها على المجرى المعطى.  انظر أيضًا التابع print: يكتب الكائن (أو الكائنات) المُمرَّرة ...

تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. البنية العامة csv.unregister_dialect(name) ‎ المعاملات name اسم اللهجة المراد حذفها من سجلّ اللهجات. القيمة المعادة تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. تطلق الدالة استثناءً إن كان الاسم المعطى غير موجود في سجلّ اللهجات. أمثلة يبين المثال التالي آلية عمل التابع: >>> import csv >>> csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) >>> csv.get_dialect('unixpwd') >>> csv.unregister_dialect('unixpwd') >>> انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الدالة csv.list_dialects()‎: ...

يحول التابع to_f قيمة التوقيت المعطى إلى عدد عشري يمثل عدد الثواني التي مرَّت منذ توقيت يونكس. لاحظ أنه تختلف الأرقام الدنيا المعادة من التابع to_f والتابع subsec لأن الأعداد العشرية المضاعفة ذات المعيار IEEE 754 ليست دقيقة بما يكفي لتمثيل عدد النانوثواني التي مرت منذ حقبة يونيكس. البنية العامة to_f → float‎ القيمة المعادة يعاد عدد عشري يمثِّل قيمة التوقيت المعطى كعدد الثواني التي مرت منذ حقبة يونيكس. أمثلة مثال على استخدام التابع to_f‎: t = Time.now "%10.5f" % t.to_f ...

يتحقَّق التابع ?is_a إن كان الصنف المُمرَّر إليه هو نفسه صنف الكائن الذي استدعي معه، أو إن كان هذا الصنف أحد الأصناف العليا (superclasses) للكائن المعطى أو الوحدات المُضمَّنة في هذا الكائن. البنية العامة is_a?(class) → true or false المعاملات class الصنف المراد التحقق منه. القيم المعادة تُعاد القيمة true إذا كان الصنف class هو نفسه صنف الكائن المعطى، أو أنه أحد الأصناف العليا أو الوحدات المُضمَّنة في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ...

تحذير: لا تستخدم هذا التابع مباشرةً!. يُصنَّف التابع ?respond_to_missing من التوابع الخطَّافة (Hook method)، إذ يتحقَّق فيما إذا كان الكائن المعطى يستجيب إلى تابعٍ محدِّدٍ أم لا. إن أعطي معامل اسم التابع بشكل سلسلةٍ نصية، فستُحوَّل تلك السلسلة النصية إلى رمز. ألقِ نظرةً على التابع ?respond_to، وعلى المثال في صفحة الصنف BasicObject. البنية العامة respond_to_missing?(symbol, include_all) → true or false respond_to_missing?(string, include_all) → true or false المعاملات symbol الرَّمزُ المعرِّف للتابع المُعطى. include_all يأخذ هذا المعامل القيمة false (افتراضيًا)، أو القيمة ...

يتحقَّق التابع ?include إذا كان المفتاح مُسجّلًا (registered). البنية العامة include?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?include في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?member إذا كان المفتاح مُسجّلًا (registered). البنية العامة member?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?member في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?member إذا كان المفتاح مُسجّلًا (registered). البنية العامة member?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?member في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?key إذا كان المفتاح مُسجّلًا (registered). البنية العامة key?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?key إذا كان المفتاح مُسجّلًا (registered). البنية العامة key?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?include إذا كان المفتاح مُسجّلًا (registered). البنية العامة include?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?include في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يعيد التابع gid المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة gid → integer القيمة المعادة يعاد عدد صحيح يمثِّل المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال المعامل gid: File.stat("testfile").gid #=> 500 انظر أيضا التابع uid: يعيد المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف ...

يعيد التابع mode عددًا صحيحًا يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة mode → integer القيمة المعادة يعاد عدد صحيح يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع mode: File.chmod(0644, "testfile") #=> 1 s = File.stat("testfile") sprintf("%o", s.mode) #=> "100644" انظر أيضًا التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع gid: يعيد المعرِّف الرقمي للمجموعة ...

يعيد التابع lgamma مصفوفة بعنصرين تحتوي قيمة دالة غاما اللوغاريتمية (logarithmic gamma) للعدد المعطى وإشارته. يكافئ lgamma التعبير التالي: [Math.log(Math.gamma(x).abs), Math.gamma(x) < 0 ? -1 : 1] ملاحظة: تجنب تمرير أعداد كبيرة، حتى لا يستنزف التابع gamma الذاكرة. البنية العامة lgamma(x) → [float, -1 or 1]‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة تعاد مصفوفة ثنائية تحوي قيمة دالة غاما اللوغاريتمية (logarithmic gamma) للعدد x المعطى وإشارته. أمثلة مثال على استخدام التابع lgamma‎: Math.lgamma(0) #=> [Infinity, 1] انظر ...

يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. البنية العامة controller.open_new(url) المعاملات url العنوان المراد فتحه بواسطة التابع. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> firefox = webbrowser.get('firefox') >>> firefox.open_new("https://wiki.hsoub.com") انظر أيضًا التابع controller.open()‎: يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. التابع controller.open_new_tab()‎: يفتح التابع العنوان المعطى في تبويب جديد في المتصفّح الذي يتحكّم به هذا المتحكّم، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يحسب التابع tanh الظل القطعي (hyperbolic tangent) للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: [‎-1 ، 1]. البنية العامة tanh(x) → Float‎ المعاملات x‎ عدد يمثِّل الزاوية بالراديان. القيمة المعادة يعاد عدد عشري يمثِّل ناتج حساب الظل القطعي للعدد x المعطى. أمثلة مثال على استخدام التابع tanh‎: Math.tanh(0) #=> 0.0‎ انظر أيضا التابع tan: يحسب ظل العدد المعطى. مصادر قسم التابع tanh‎ في الصنف Math‎ في توثيق روبي الرسمي.

يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. البنية العامة controller.open_new_tab(url) المعاملات url العنوان المراد فتحه بواسطة التابع. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> firefox = webbrowser.get('firefox') >>> firefox.open_new_tab("https://wiki.hsoub.com") انظر أيضًا التابع controller.open()‎: يعرض التابع العنوان المعطى باستخدام المتصفّح الذي يتحكّم فيه هذا المتحكّم. التابع controller.open_new()‎: يفتح التابع العنوان المعطى في نافذة جديدة في المتصفّح الذي يتحكّم به هذا المتحكّم، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يعيد التابع to_hash الكائن Hash المعطى نفسه. البنية العامة to_hash => hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه.  انظر أيضًا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_hash في الصنف Hash في توثيق روبي ...

يحسب التابع tan ظل العدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة tan(x) → Float‎ المعاملات x‎ عدد يمثِّل الزاوية بالراديان. القيمة المعادة يعاد عدد عشري يمثِّل ناتج حساب ظل العدد x المعطى. أمثلة مثال على استخدام التابع tan‎: Math.tan(0) #=> 0.0‎ انظر أيضا التابع tanh: يحسب الظل القطعي (hyperbolic tangent) للعدد المعطى. مصادر قسم التابع tan‎ في الصنف Math‎ في توثيق روبي الرسمي.

يحسب التابع sinh الجيب القطعي (hyperbolic sine) للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة sinh(x) → Float‎ المعاملات x‎ عدد يمثِّل الزاوية بالراديان. القيمة المعادة يعاد عدد عشري يمثِّل ناتج حساب الجيب القطعي للعدد x المعطى.   أمثلة مثال على استخدام التابع sinh‎: Math.sinh(0) #=> 0.0‎ انظر أيضا التابع sin: يحسب جيب (sin) العدد المعطى. مصادر قسم التابع sinh‎ في الصنف Math‎ في توثيق روبي الرسمي.

يتحقق التابع world_writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: m = File.stat("/tmp").world_writable? #=> 511 sprintf("%o", m) ...

يتحقق التابع world_readable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_readable?‎: m = File.stat("/etc/passwd").world_readable? #=> 420 sprintf("%o", m) ...

تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلّا فإنّ الدالة تكون مكافئة للدالة webbrowser.open_new()‎. البنية العامة webbrowser.open_new_tab(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new_tab("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new()‎: تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يحسب التابع cosh جيب التمام القطعي (hyperbolic cosine) للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎1 ، INFINITY]. البنية العامة cosh(x) → Float‎ المعاملات x‎ عدد يمثِّل الزاوية التي ستُطبَّق عليها العملية بالراديان. القيمة المعادة يعاد عدد عشري يمثِّل قيمة جيب التمام القطعي للعدد x المعطى. أمثلة مثال على استخدام التابع cosh‎: Math.cosh(0) #=> 1.0‎ انظر أيضا التابع cos: يحسب جيب تمام العدد المعطى. مصادر قسم التابع cosh‎ في الصنف Math‎ في توثيق روبي الرسمي.

ينفذ المعامل & العملية AND بين بتات العددين المعطيين. البنية العامة int & other_int → integer القيمة المعادة يعاد ناتج تنفيذ العملية AND بين بين العدد int الصحيح والعدد other_int الصحيح. أمثلة مثال على استخدام المعامل &: 25 & 2 #=> 0 20 & -2 #=> 20 انظر أيضا المعامل |: ينفذ العملية OR بين بتات العددين المعطيين. المعامل ^: ينفذ العملية XOR بين بتات العددين المعطيين.  المعامل >>: يعيد قيمة ...

يتحقَّق التابع ?respond_to من استجابة الكائن الذي استدعي معه للتابع المُمرَّر إليه. ستُشمَل التوابع الخاصة والمحميَّة في عملية البحث فقط إذا مُرِّرت القيمة true إلى المعامل الثاني في التابع. إذا كان التابع غير مُنفَّذ، مثل التابع Process.fork في أنظمة ويندوز، والتابع File.lchmod في أنظمة GNU/Linux وغيرهما، فستُعاد القيمة false. إذا كان التابع غير معرَّفٍ، فسيُستدعى التابع ?respond_to_missing وتُعاد النتيجة. إن أعطي معامل اسم التابع بشكل سلسلةٍ نصية، فستُحوَّل هذه السلسلة النصية إلى رمز. البنية العامة respond_to?(symbol, include_all=false) → true or ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد صحيح. البنية العامة getint(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد صحيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getint('topsecret.server.com', 'Port') 50022 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getfloat()‎: تابع مساعد وظيفته تحويل ...