نتائج البحث

يعيد التابع 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 في توثيق روبي الرسمي.