نتائج البحث

يعيد التابع __dir__ المسار المطلق الأساسي (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. هذا يعني أنه سيتم استبيان الوصلات الرمزية في المسار. إذا كان __FILE__ يساوي nil، فسيعيد التابع __dir__ القيمة nil أيضًا. القيمة المعادة تساوي File.dirname(File.realpath(__FILE__))‎. البنية العامة __dir__→ string‎ القيمة المعادة يعاد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. إذا كان __FILE__ يساوي nil، فستُعاد القيمة nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). التابع __method__: يعيد الاسم الذي ...

يُستدعى التابع method_missing من قِبل روبي عندما تُرسَل رسالةٌ إلى كائن لا يستطيع التعامل معها. بشكل افتراضي، يُطلق المفسِّر (interpreter) خطأً عندما يُستدعى هذا التابع. على أي حال، يمكن إعادة تعريف (override) هذا التابع للحصول على سلوك أكثر ديناميكية. إذا تقرر أنه لا يجب التعامل مع تابع معيّن، فيجب حينئذٍ استدعاء super حتى يتسنَّى للأصناف الأجداد (ancestors) الوصول إلى التابع المنشود. البنية العامة method_missing(symbol [, *args] ) → result المعاملات symbol رمزٌ للتابع المُستدعى. args الوسائط التي ستُمرَّر إلى التابع ...

ينشئ التابع deprecate_constant قائمة بالثوابت الموجودة المهملة. البنية العامة deprecate_constant(symbol, ...) => mod‎ المعاملات symbol‎ رمز يمثل الثابت. القيمة المعادة تعاد قائمة بالثوابت الموجودة المُتجاوزة. انظر أيضا التابع define_method: يعرف تابع نُسخة (instance method) في المُستقبِل (receiver). التابع extend_object: يوسع الكائن المعطى بإضافة ثوابت و توابع. مصادر قسم التابع deprecate_constant‎ في الصنف Module‎ في توثيق روبي الرسمي.

يعيد التابع inspect تمثيلًا نصيًا للرمز التي استُدعي معه على هيئة رمز حرفي (symbol literal). البنية العامة inspect → string‎ القيمة المعادة يعاد تمثيلٌ نصيُّ للرمز التي استُدعي معه. أمثلة مثال على استخدام التابع inspect‎: :fred.inspect #=> ":fred"‎ انظر أيضًا التابع id2name: يعيد الاسم أو السلسلة نصية التي تمثل الرمز. مصادر قسم التابع inspect‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع to_s الاسم أو السلسلة نصية التي تمثل الرمز البنية العامة to_s→ string‎ القيمة المعادة تعاد سلسلة نصية تمثِّل الاسم أو السلسلة نصية التي تمثل الرمز. أمثلة مثال على استخدام التابع to_s‎: :fred.id2name #=> "fred" :ginger.to_s #=> "ginger"‎ انظر أيضًا التابع to_sym: يعيد بشكل عام الرمز Symbol المقابل لكائن ما. مصادر قسم التابع to_s‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

ينشئ التابع private_constant قائمة بالثوابت الخاصة الموجودة. البنية العامة private_constant(symbol, ...) => mod‎ المعاملات symbol‎ رمز يمثِّل الثابت. القيمة المعادة تعاد وحدة. انظر أيضا التابع private_class_method: يجعل توابع الصنف الحالية خاصة (private). التابع private_instance_methods: يعيد قائمة بتوابع النسخة الخاصة المعرفة في الوحدة. التابع private: يعين المرئية (visibility) الافتراضية للتوابع المحددة لاحقًا إلى المرئية private الخاصة. مصادر قسم التابع private_constant‎ في الصنف Module‎ في توثيق روبي الرسمي.

ينشئ التابع public_constant قائمةً بالثوابت العامة الموجودة. البنية العامة public_constant(symbol, ...) => mod‎ المعاملات symbol‎ رمز يمثل الثابت. القيمة المعادة تعاد قائمة بالثوابت العامة الموجودة. انظر أيضا التابع public: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة. التابع public_class_method: ينشئ قائمة بتوابع الصنف العامة (public) الحالية. التابع public_instance_method: يبحث عن التوابع العامة (public) وحسب على غرار التابع instance_method. التابع public_instance_methods: يعيد قائمة بتوابع النسخة العامة (public instance methods) المعرفة في الوحدة.  مصادر قسم التابع public_constant‎ في الصنف Module‎ في توثيق روبي الرسمي.

يزيل التابع remove_method تابعًا ذا اسم محدَّد من الصنف الحالي. للاطلاع على مثال، انتقل إلى صفحة التابع undef_method. البنية العامة remove_method(symbol)→ self remove_method(string)→ self‎ المعاملات symbol‎ رمز يمثل التابع المراد حذفه. string‎ سلسلة نصية تمثل التابع المراد حذفه. يحوَّل هذا المعامل إن أعطي إلى رمز. القيمة المعادة يعاد الكائن المعطى نفسه. انظر أيضا التابع remove_const: يزيل تعريف ثابت محدَّد، ويعيد القيمة السابقة له. التابع remove_class_variable: يزيل تعريف متغير محدَّد من صنفٍ ثم يعيد قيمة ذلك الثابت. مصادر قسم التابع remove_method‎ في الصنف Module‎ ...

يجعل التابع compare_by_identity الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. البنية العامة compare_by_identity → hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد يقارن مفاتيحه بواسطة مُعرِّفاتها. أمثلة مثال على استعمال التابع compare_by_identity: h1 = { "a" => 100, "b" => 200, :c => "c" } h1["a"] #=> 100 h1.compare_by_identity h1.compare_by_identity? #=> true h1["a".dup] #=> nil # different objects. h1[:c] ...

يبحث التابع public_instance_method عن التوابع العامة (public) وحسب على غرار التابع instance_method. البنية العامة public_instance_method(symbol)→ unbound_method‎ المعاملات symbol‎ رمز يمثل الثابت. القيمة المعادة يعاد كائنٌ من النوع Unboundmethod. انظر أيضا التابع public: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة. التابع public_constant: ينشئ قائمة بالثوابت العامة (public) الموجودة. التابع public_instance_methods: يعيد قائمة بتوابع النسخة العامة (public instance methods) المعرفة في الوحدة.  التابع public_method_defined?‎: يتحقق إن كان التابع العام المعطى معرفًا في الوحدة/الصنف (أو الوحدات المتضمنة فيه، أو أسلافه إن كان صنفا). مصادر قسم التابع public_instance_method‎ ...

ينشئ التابع attr_writer تابع وصول (accessor method) للسماح بتعيين قيمة للخاصية symbol.id2name. تحول الوسائط النصية إلى رموز. البنية العامة attr_writer(symbol, ...) → nil attr_writer(string, ...) → nil‎ المعاملات symbol‎ رمز لتحديد الخاصية. string‎ سلسلة نصية لتحديد الخاصية. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr: الشكل الأول لهذا التابع مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ التابع attr_accessor(name)‎. التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه الوحدة. التابع attr_reader: ينشئ متغيرات نسخ (instance variables) والتوابع المقابلة التي تعيد قيمة متغيرات النسخ هذه. مصادر قسم التابع ...

يعيد التابع stat كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). يتضمن الكائن Hash معلومات حول تسلسلات ذاكرة التخزين المؤقت (cache serials) الخاصة بالتوابع والثوابت مثل: { :global_method_state=>251, :global_constant_state=>481, :class_serial=>9029 }‎ تقديم (implementation) محتويات الكائن Hash مخصوصة، ويمكن أن تتغير مع مرور الوقت. لا يُتوقّع أن يعمل هذا التابع إلا على على C Ruby. البنية العامة stat → Hash stat(hsh) → hsh stat(Symbol) → Numeric‎ القيمة المعادة يعاد كائن من النوع Hash يحوي عدادات مُخصصة داخل ...

يعيد التابع receiver المستقبِل المرتبط (bound receiver) لكائن الربط (binding object). البنية العامة receiver → object القيم المعادة يعاد كائن يمثل المستقبِل المرتبط (bound receiver) لكائن الربط المعطى. أمثلة مثال على استخدام التابع receiver: def initialize @a = 1 end def get_binding binding end end b = BindingTest.new.get_binding b.receiver # => #<BindingTest:0x007ff5fa285c10 @a=1> انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variables: يعيد أسماء ...

يُعيد التابع singleton_class صنف الكائن المُنفرد (singleton class) للكائن الذي استدعي معه. يُنشئ هذا التابع صنفًا منفردًا جديدًا إذا كان هذا الكائن لا يملك واحدًا. البنية العامة singleton_class → class القيم المعادة إذا كان الكائن المعطى هو nil، أو true، أو false، فسيُعاد الصنف NilClass، أو TrueClass، أو FalseClass على التوالي. إذا كان الكائن عددًا صحيحًا (integer)، أو عشريًا (Float)، أو رمزًا (Symbol)، فسيُرمَى الاستثناء TypeError. أمثلة مثالٌ عن استخدام التابع singleton_class: Object.new.singleton_class #=> #<Class:#<Object:0xb7ce1e24>> String.singleton_class ...

يعيد التابع receiver المستقبِل المرتبط (bound receiver) لكائن الربط (binding object). البنية العامة receiver → object القيم المعادة يعاد كائن يمثل المستقبِل المرتبط (bound receiver) لكائن الربط المعطى. أمثلة مثال على استخدام التابع receiver: def initialize @a = 1 end def get_binding binding end end b = BindingTest.new.get_binding b.receiver # => #<BindingTest:0x007ff5fa285c10 @a=1> انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variables: يعيد أسماء ...

يبحث التابع public_method عن التوابع العامة فقط بشكل مشابه لعمل التابع method. البنية العامة public_method(sym) → method المعاملات sym رمزٌ يشير إلى اسم التابع المراد البحث عنه. القيم المعادة يُعاد التابع الموافق للاسم sym من الكائن المُعطى، أو يُرمى الاستثناء NameError إذا لم توجد توابع موافقة لهذا الاسم. انظر أيضًا التابع method: يبحث عن تابعٍ باسمٍ محدَّد في الكائن المعطى بوصفه مستقبلًا. التابع public_send: يَستدعي التابع المعرَّف برمزٍ محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. التابع send: يَستدعي التابع ...

يجعل التابع private_class_method توابع صنفٍ محدَّدٍ خاصة (private). غالبًا ما يستخدم هذا التابع لإخفاء الباني new الافتراضي. البنية العامة private_class_method(symbol, ...)→ mod private_class_method(string, ...)→ mod‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة تعاد وحدة. أمثلة مثال على استخدام التابع private_class_method‎: class SimpleSingleton # Not thread safe private_class_method :new def SimpleSingleton.create(*args, &block) @me = new(*args, &block) if ! @me @me end end‎ ...

يستخلص التابع dig القيمة المتشعبة (nested) المحددة بواسطة سلسلة من الكائنات عن طريق استدعاء التابع dig في كل خطوة، ويُعيد القيمة nil إن كانت قيمة أي خطوة وسطية تساوي nil. البنية العامة dig(key, ...) → object‎ المعاملات key‎ كائن. القيمة المعادة تعاد القيمة المتشعبة (nested) المحددة بواسطة سلسلة الكائنات key، أو تعاد القيمة nil إن كانت قيمة أي خطوة وسطية تساوي nil. أمثلة مثال على استخدام التابع dig‎: Foo = Struct.new(:a) f = Foo.new(Foo.new({b: [1, 2, 3]})) f.dig(:a, :a, :b, 0) ...

ينشئ التابع public_class_method قائمةً بتوابع الصنف العامة الحالية. البنية العامة public_class_method(symbol, ...) → mod public_class_method(string, ...) → mod‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة تعاد وحدة. انظر أيضا التابع public: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة. التابع public_constant: ينشئ قائمة بالثوابت العامة (public) الموجودة. التابع public_instance_method: يبحث عن التوابع العامة (public) وحسب على غرار التابع instance_method. التابع public_instance_methods: يعيد قائمة بتوابع النسخة العامة (public instance methods) المعرفة في الوحدة.  التابع public_method_defined?‎: يتحقق إن كان ...

الدالة Symbol.prototype.toString()‎ تعيد سلسلةً نصيّةً تُمثِّل الكائن Symbol. البنية العامة Symbol().toString(); القيمة المعادة سلسلة نصية تمثل الكائن Symbol. الوصف يُعيد الكائن Symbol تعريف الدالة toString الموجود في الكائن Object، فهو لا يرث الدالة Object.prototype.toString()‎؛ وستُعيد الدالة toString تمثيلًا نصيًا للرمز. لا يسمح بإضافة الرموز إلى سلاسل نصية صحيحٌ أنَّ بإمكاننا استدعاء الدالة toString على الرموز، لكن لا يُسمَح بإضافة سلسلة نصية إلى رمز، وسيرمى الخطأ TypeError كما في المثال الآتي: Symbol('foo') + 'bar'; // TypeError: Can't convert symbol to string ...

يمنع التابع freeze إجراء تعديلاتٍ إضافيةٍ على الكائن الذي استدعي معه. سيُرمَى الخطأ RuntimeError عند محاولة إجراء أي تعديلٍ مع هذا الكائن بعد استدعاء التابع freeze معه. ليس هناك أيُّ طريقةٍ لتحرير الكائن من حالة التجميد (frozen) بعد تطبيقها. انتبه إلى أن الأصناف التالية تكون في حالة تجميد دائمة وهي: Integer، و Float، و Symbol. البنية العامة freeze → obj القيم المعادة يُعاد الكائن المعطى نفسه بعد تجميده. أمثلة مثالٌ عن استخدام التابع freeze: a = [ "a", "b", "c" ...

يقدِّر التابع eval تعابير لغة روبي الممررة إليه في السياق Binding. في حال تمرير الوسيطين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن وجود أخطاء في الصياغة (syntax errors). البنية العامة eval(string [, filename [,lineno]]) → obj المعاملات string سلسلة نصية تحوي تعابير روبي المراد تقديرها في السياق Binding. filename سلسلة نصية تمثل اسم الملف. إن أعطي هذا المعامل الاختياري، فسيُستعمَل عند الإبلاغ عن وجود أخطاء في الصياغة. lineno سلسلة نصية تمثل رقم السطر. إن أعطي هذا المعامل الاختياري، فسيُستعمَل ...

يعيد التابع class_variable_get قيمة متغير الصنف المعطى (أو يطلق الاستثناء NameError). يجب تضمين الجزء @@ من اسم المتغير بالنسبة لمتغيرات الصنف العادية. تُحوّل المعاملات النصية إلى رموز. البنية العامة class_variable_get(symbol) → obj class_variable_get(string) → obj‎ المعاملات symbol‎ رمز يمثل متغير الصنف. string‎ سلسلة نصية تمثل متغير الصنف. القيمة المعادة تعاد قيمة متغير الصنف المعطى. أمثلة مثال على استخدام التابع class_variable_get‎: class Fred @@foo = 99 end Fred.class_variable_get(:@@foo) #=> 99‎ انظر أيضا التابع class_variable_defined?‎: يتحقق إن كان متغير الصنف (class variable) ...

يتحقق التابع 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 انظر ...

يستخرج التابع dig القيمة المتداخلة المحددة بواسطة تسلسل كائنات تمثِّل المفاتيح عن طريق استدعاء dig في كل خطوة، ويعيد القيمة nil إذا كانت أي خطوة متوسطة هي nil. البنية العامة dig(key, ...) → object المعاملات key المفتاح المتشعب المراد استخراج قيمته. ... سلسلة من المفاتيح المتشعبة. القيمة المعادة تعاد القيمة المرتبطة بالمفتاح key أو سلسلة المفاتيح ... المتشعبة. أمثلة مثال على استعمال التابع dig: h = { foo: {bar: {baz: 1}}} h.dig(:foo, :bar, :baz) #=> 1 h.dig(:foo, :zot, :xyz) ...

يحدد التابع attr_accessor خاصية مسماة (named attribute) لهذه الوحدة، إذ يكون الاسم هو نتيجة التعبير symbol.id2name، وينشئ متغير نسخة (@name) وتابع وصول مقابل له (access method) لقراءته. ينشئ أيضًا تابعًا يُسمى ‎name=‎ لتعيين الخاصية. تحول الوسائط النصية إلى رموز. البنية العامة attr_accessor(symbol, ...) → nil attr_accessor(string, ...) → nil‎ المعاملات symbol‎ رمز لتحديد الخاصية. string‎ سلسلة نصية لتحديد الخاصية. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع attr_accessor‎: module Mod attr_accessor(:one, :two) end Mod.instance_methods.sort #=> [:one, :one=, :two, :two=]‎ ...

يضبط التابع class_variable_set قيمة متغير الصنف المحدد بالمعامل المُمرَّر ويحيل إليه قيمة محدَّدة. إذا تم تمرير اسم متغير الصنف كسلسلة نصية، فستُحوّل تلك السلسلة إلى رمز. البنية العامة class_variable_set(symbol, obj) → obj class_variable_set(string, obj) → obj‎ المعاملات symbol‎ رمز يمثل متغير الصنف. obj‎ قيمة الكائن المراد تعيينها إلى متغير الصنف. string‎ سلسلة نصية تمثل متغير الصنف. القيمة المعادة يعاد الكائن obj‎ المعطى. أمثلة مثال على استخدام التابع class_variable_set‎: class Fred @@foo = 99 def foo @@foo ...

يُعيد التابع intern الرمز المقابل للسلسلة النصية التي استدعي معها، أو يُنشىء ذلك الرمز إذا لم يكن مُوجودًا مُسبقًا. يمكن الاستفادة من هذا التابع في إنشاء الرموز التي لا يمكن إنشاؤها باستعمال الصيغة xxx:. البنية العامة intern → symbol القيمة المعادة يُعاد الرمز المقابل للسلسلة النصية المعطاة إن كان موجودًا، أو يُنشَأ ذلك الرمز إذا لم يكن موجودًا مُسبقًا ثم يعاد. أمثلة مثال على استعمال التابع intern: "Koala".intern #=> :Koala s = 'cat'.to_sym ...

يتحقق التابع method_defined?‎ إن كان التابع المعطى مُعرّفًا في الوحدة أو الصنف (أو في الوحدات المُتضمنة فيه، وإن كان صنفًا في أسلافه). تتم مطابقة التوابع العامة والمحمية. تٌحوّل الوسائط النصية إلى رموز. البنية العامة method_defined?(symbol) → true or false method_defined?(string) → true or false‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. القيمة المعادة تعاد القيمة true إن كان التابع المعطى مُعرّفًا في الوحدة أو الصنف. أمثلة مثال على استخدام التابع method_defined?‎: module A def method1() end ...

يمنع التابع undef_method الصنف الحالي من الاستجابة للاستدعاءات الموجهة إلى التابع المعطى. سلوك هذا التابع مخالف لسلوك التابع remove_method الذي يحذف التابع من الصنف المعين؛ ستبحث روبي في الأصناف العليا (superclasses) وفي الوحدات المختلطة (mixed-in modules) عن مُستقبِل (receiver) محتمل. البنية العامة undef_method(symbol) → self undef_method(string) → self‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة يعاد الكائن المعطى نفسه. أمثلة مثال على استخدام التابع undef_method‎: class Parent def hello ...

يتحقق التابع private_method_defined?‎ إن كان التابع الخاص (private) المعطى معرَّفًا من قِبَل _ mod_ (أو الوحدات المتضمنة فيه، وأسلافه [ancestors] إن كان صنفًا). البنية العامة private_method_defined?(symbol) → true or false private_method_defined?(string) → true or false‎ المعاملات symbol‎ رمز يمثل التابع الخاص. string‎ سلسلة نصية تمثل التابع الخاص. يحول هذا المعامل - إن أعطي - إلى رمز. القيمة المعادة تعاد القيمة true إن كان التابع الخاص (private) المعطى معرفًا من طرف _ mod_ (أو الوحدات المتضمنة فيه، وأسلافه [ancestors] إن كان صنفًا). خلا ...

الدالة Symbol.prototype[@@toPrimitive]‎ تحوّل كائن Symbol إلى قيمة أوليّة. البنية العامة Symbol()[Symbol.toPrimitive](hint); القيمة المعادة القيمة الأولية لكائن Symbol المُحدَّد. الوصف الدالة ‎[@@toPrimitive]()‎‎ التابعة للكائن Symbol تُعيد القيمة الأولية للكائن Symbol. لا يُستخدَم الوسيط hint. تستدعي JavaScript الدالة ‎[@@toPrimitive]()‎‎ لتحويل كائن ما إلى قيمة أوليّة، ومن النادر أن تحتاج إلى استدعاء الدالة ‎[@@toPrimitive]()‎‎ يدويًا، إذ تستدعيها JavaScript تلقائيًا عندما تصادف كائنًا في مكانٍ تتوقع فيه قيمةً أوليةً. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي ؟ 44 غير مدعومة ؟ ؟ مصادر ومواصفات ...

الدالة Symbol.prototype.valueOf()‎ تعيد القيمة الأوليّة (primitive value) لكائن Symbol. البنية العامة Symbol().valueOf(); القيمة المعادة القيمة الأولية للكائن Symbol. الوصف الدالة valueOf التابعة للكائن Symbol تُعيد القيمة الأولية للكائن Symbol. تستدعي JavaScript الدالة valueOf لتحويل كائن ما إلى قيمة أوليّة، ومن النادر أن تحتاج إلى استدعاء الدالة valueOf يدويًا، إذ تستدعيها JavaScript تلقائيًا عندما تصادف كائنًا في مكانٍ تتوقع فيه قيمةً أوليةً. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي 38 36 غير مدعومة 25 9 على النقيض من متصفح IE، يدعم ...

يعين التابع public المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة إن لم يمُرَّر إليه أي شيء. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط مرئية هذه التوابع المرئية public العامة.  تُحول الوسائط النصية String إلى رموز. البنية العامة public → self public(symbol, ...) → self public(string, ...) → self‎ المعاملات symbol‎ رمز يمثل التابع المراد ضبط مرئيته إلى عامة. string‎ سلسلة نصية تمثل التابع المراد ضبط مرئيته إلى عامة. يحول هذا المعامل إن أعطي إلى رمز. ... رمز أو سلسلة نصية تمثل التوابع المراد ضبط مرئيتها إلى عامة. القيمة المعادة ...

يتحقق التابع public_method_defined?‎ إن كان التابع العام (public method) المعطى معرفًا في الوحدة/الصنف (أو الوحدات المتضمنة فيه، أو أسلافه إن كان صنفا). البنية العامة public_method_defined?(symbol)→ true or false public_method_defined?(string)→ true or false‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المُعادة يعيد التابع public_method_defined?‎ القيمة true إن كان التابع العام المعطى معرفًا بواسطة في الوحدة/الصنف (أو الوحدات المتضمنة فيه، أو أسلافه إن كان صنفا)، وإلا فسيعيد false. أمثلة مثال على استخدام التابع public_method_defined?‎: module A ...

يتحقق التابع protected_method_defined?‎ إن كان التابع المحمي (protected) المعطى معرفًا في الوحدة (أو الوحدات المُتضمنة فيه، أو أسلافه إن كان صنفًا). البنية العامة protected_method_defined?(symbol)→ true or false protected_method_defined?(string)→ true or false‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة تعاد القيمة true إن كان التابع المحمي المعطى معرفًا في الوحدة (أو الوحدات المُتضمنة فيه، أو أسلافه إن كان صنفًا). خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع protected_method_defined?‎: module ...

يحول التابع to_sym السلسلة النصية التي استدعيت معه إلى رمز، إذ يُنشىء ذلك الرمز إذا لم يكن الرمز المقابل للسلسلة النصية تلك مُوجودًا مُسبقًا. يمكن الاستفادة من هذا التابع في إنشاء الرموز التي لا يمكن إنشاؤها باستعمال الصيغة xxx:. البنية العامة to_sym → symbol القيمة المعادة يُعاد الرمز المقابل للسلسلة النصية النصية المعطاة، أو يُنشأ ذلك الرمز إذا لم يكن موجودًا مُسبقًا. أمثلة مثال على استعمال التابع to_sym: "Koala".intern #=> :Koala s = ...

الدالة Object.getOwnPropertySymbols()‎ تُعيد مصفوفةً فيها جميع الخاصيات الرمزية (symbol properties) الموجودة مباشرةً في الكائن المعطي. البنية العامة Object.getOwnPropertySymbols(obj) obj الكائن الذي نريد الحصول على جميع خاصياته الرمزية. القيمة المعادة مصفوفة فيها جميع الخاصيات الرمزية (symbol properties) التابعة مباشرةً للكائن المعطي. الوصف بما يشبه الدالة Object.getOwnPropertyNames()‎، يمكن الحصول على جميع الخاصيات الرمزية لكائنٍ ما باستخدام هذه الدالة؛ لكن لاحظ أنَّ الدالة Object.getOwnPropertyNames()‎ لا تُعيد الخاصيات الرمزية وإنما ستعيد الخاصيات النصية فقط. ولمّا كانت جميع الكائنات لا تحتوي على خاصيات رمزية عند ...

يُستدعى التابع singleton_method_undefined كرد نداءٍ (callback) في كل مرة يكون فيها تابع منفرد (singleton method) غير مُعرَّف (undefined) في المُستقبِل (receiver). البنية العامة singleton_method_undefined(symbol) أمثلة مثال على استخدام التابع singleton_method_undefined: module Chatty def Chatty.singleton_method_undefined(id) puts "Undefining #{id.id2name}" end def Chatty.one() end class << self undef_method(:one) end end يظهر هذا المثال عند تنفيذه المخرجات التالية: Undefining one انظر أيضًا التابع singleton_method_added: يُستَدعى هذا التابع كرد نداءٍ (callback) في كلِّ مرة يُضاف فيها تابع منفرد (singleton method) ...

يعيد التابع ‎__id__‎‎ (يدعى أيضًا object_id) مُعرِّفا عدديًا للكائن الذي استُدعي معه. سيُعاد نفس المعرِّف في كل مرة يُستدعى فيها التابع object_id مع الكائن نفسه، ولن يتشارك أي كائنين نشطين نفس المعرِّف. ملاحظة: يُعاد استخدام بعض كائنات الأصناف المٌضمّنة (built-in classes) وذلك لتحسين الأداء. هذا هو الحال بالنسبة للقيم المباشرة (immediate values) والسلاسل النصية الحرفية المجمدة (frozen string literals). لا تُمرَّر القيم المباشرة بالمرجع (reference) ولكنَّها تُمرَّر بالقيمة، مثل nil، وtrue، وfalse، وFixnums، وSymbols، وFloats. البنية العامة object_id → integer ...

يعين التابع protected المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى المرئية protected المحمية إن لم يمُرَّر إليه أي شيء. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط مرئية هذه التوابع المرئية protected المحمية.  إن كانت مرئية تابعٍ محمية، فلن يكون قابلًا للاستدعاء إلا عندما يكون المتغير self الخاص بالسياق هو التابع نفسه. (في تعريف التابع أو instance_eval). يختلف هذا السلوك عن الأسلوب المحمي في Java. وعادة ما يجب استخدام private. لاحظ أن التوابع المحمية بطيئة لأنه لا يمكنها ...

يعين التابع private المرئية (visibility) الافتراضية للتوابع المحددة لاحقًا إلى المرئية private الخاصة إن استدعي دون تمرير أي شيء إليه. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط مرئية هذه التوابع إلى المرئية private الخاصة. تذكر أنه لإظهار تابع خاص على RDoc، استخدم :doc:. البنية العامة private → self private(symbol, ...) → self private(string, ...) → self‎ المعاملات symbol‎ رمز يمثل التابع المراد ضبط مرئيته إلى خاصة. string‎ سلسلة نصية تمثل التابع المراد ضبط مرئيته إلى خاصة. يحول هذا ...

مقدمة أضافت النسخة ECMAScript 2015 من لغة JavaScript نوع بيانات أوليّ (primitive data type) جديد يُسمّى ‎symbol‎، وهو نوعٌ أوليّ مثل النوع ‎number‎ والنوع ‎string‎. انظر توثيق ‎Symbol‎ لتفصيل دقيق عن هذه الرموز. تنشأ القيم من النوع ‎symbol‎ عبر استدعاء الدالة البانية ‎‎Symbol()‎‎: let sym1 = Symbol(); let sym2 = Symbol("key"); // مفتاح نصيّ اختياريّ الرموز فريدة (unique) وغير قابلة للتعديل (immutable): let sym2 = Symbol("key"); let sym3 = Symbol("key"); sym2 === sym3; // false, الرموز فريدة ولو أُنشِأت بنفس المفتاح يُمكن استخدام ...

يعيد المعامل `` مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell). تُستخدَم الصياغة المضمَّنة ‎%x{...}‎‎ هذا المعامل. تُضبَط حالة العملية (process status) إلى القيمة ‎$?‎‎. البنية العامة `cmd` → string‎ المعاملات cmd يمثل التعليمة المراد تنفيذها. القيمة المعادة يعاد مجرى المخرجات القياسي لتنفيذ تعليمة cmd في صدفة فرعية (subshell). أمثلة مثال على استخدام المعامل ``‎: `date` #=> "Wed Apr ...

يُستَدعى التابع singleton_method_removed كرد نداءٍ (callback) في كل مرة يُحذف فيها تابع منفرد (singleton method) من المُستقبِل (receiver). البنية العامة singleton_method_removed(symbol) أمثلة مثال على استخدام التابع singleton_method_removed: module Chatty def Chatty.singleton_method_removed(id) puts "Removing #{id.id2name}" end def self.one() end def two() end def Chatty.three() end class << self remove_method :three remove_method :one end end يظهر هذا المثال عند تنفيذه المخرجات التالية: Removing three Removing one ...

يُستَدعى التابع singleton_method_added كرد نداءٍ (callback) في كلِّ مرة يُضاف فيها تابع منفرد (singleton method) جديد إلى المُستقبِل (receiver). البنية العامة singleton_method_added(symbol) أمثلة مثال على استخدام التابع singleton_method_added: module Chatty def Chatty.singleton_method_added(id) puts "Adding #{id.id2name}" end def self.one() end def two() end def Chatty.three() end end يظهر هذا المثال عند تنفيذه المخرجات التالية: Adding singleton_method_added Adding one Adding three انظر أيضًا التابع singleton_method_removed: يُستَدعى هذا التابع كرد نداءٍ ...

الدالة Symbol.for(key)‎ تبحث عن رمزٍ موجودٍ مسبقًا في سجل الرموز العام الذي له مفتاحٌ معيّن وستُعيده عند وجوده؛ وإن لم يكن موجودًا فسيُنشَأ رمزٌ جديدٌ في سجل الرموز العام له هذا المفتاح. البنية العامة Symbol.for(key); key سلسلة نصيّة تُمثِّل مفتاح الرمز الذي سنبحث عنه (وستُستخدَم أيضًا لوصف الرمز). القيمة المعادة الرمز المرتبط بالمفتاح إن كان موجودًا؛ وإلا فسيُنشَأ ويُعاد رمزٌ جديد. الوصف بخلاف الدالة Symbol()‎، تُنشِئ الدالة Symbol.for()‎ رمزًا في سجل الرموز العام (global symbol registry)؛ ليس من الضروري أن ...

يزيل التابع untrace_var التعقب (tracing) للأمر cmd المعطى على المتغير العام المحدد ثم يعيد القيمة nil. في حال عدم تحديد الأمر cmd، فسيزيل التعقب نهائيًا لهذا المتغير، ثم يعيد مصفوفة تحتوي على التعليمات المٌزالة فعلًا. البنية العامة untrace_var(symbol [, cmd] )→ array or nil‎ المعاملات symbol‎ يمثل المتغير. cmd‎ الأمر الذي سيُزال عنه التعقب. القيمة المعادة تعاد القيمة nil في حال تمرير المعامل cmd، وإلا فستُعاد مصفوفة تحتوي على التعليمات المٌزالة فعلًا. انظر أيضا التابع trace_var: يضبط تعقّبات (tracing) تعيين المتغيرات ...

يبحث التابع method عن تابعٍ باسمٍ محدَّد في الكائن المعطى بوصفه مستقبلًا (receiver)، ثمَّ يعيد كائنًا من النوع Method لذلك التابع (أو يرمي الاستثناء NameError). يتصرَّف الكائن Method كتعبيرٍ مغلق (closure) في نسخ الكائن الخاصة بالكائن الذي يبحث فيه؛ لذلك، تبقى متغيِّرات النسخة (instance variables) وقيمة self متاحةً. البنية العامة method(sym) → method المعاملات sym رمزٌ يشير إلى اسم التابع المراد البحث عنه. القيم المعادة يُعاد كائنًا من النوع Method يمثِّل التابع الموافق للاسم sym الموجود في الكائن المعطى، أو ...

يسجل التابع autoload اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة. البنية العامة autoload(module, filename)→ nil‎ المعاملات module سلسلةٌ نصيةٌ أو رمزٌ (symbol) يمثِّل اسم الوحدة. filename اسم الملف. المراد تحميله عن الوصول إلى الوحدة module. القيمة المعادة تعاد القيمة nil عند نجاح العملية. أمثلة مثال على استخدام التابع autoload‎: autoload(:MyModule, "/usr/local/lib/modules/my_module.rb") ‎ انظر أيضا التابع autoload?‎: يعيد اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. ...

المشكلة تستخدم الشيفرة البرمجية عددًا له معنىً معين له. الحل استبدال هذا العدد بثابت له اسم يمكن قراءته ويشرح معنى العدد. مثال قبل إعادة التصميم تستخدم الشيفرة التالية العدد 9.81 بالشكل المجرَّد الذي يمثِّل ثابت الجاذبية الأرضية: في لغة Java: double potentialEnergy(double mass, double height) { return mass * height * 9.81; } في لغة C#‎: double PotentialEnergy(double mass, double height) { return mass * height * 9.81; } في لغة PHP: function potentialEnergy($mass, $height) { return $mass * $height * ...

يعدُّ الصنف Object الجذر الافتراضي لكل كائنات روبي. يَرِث الصنف Object من الصنف BasicObject ما يسمح بإنشاء تسلسلات هرمية بديلة للكائن. تُتاح توابع الكائن لكل الأصناف ما لم يتم تجاهلها (overridden) صراحةً. تندمج الوحدة Kernel ضمن الصنف Object ما يعطي الوصول العام (global) للدّوال المبنية ضمنيًّا في الوحدة. رغم أنَّ توابع النسخة المنشأة من الصنف Object معرَّفةٌ عن طريق الوحدة Kernel، رأينا أن نوثّقهم هنا لمزيد من الوضوح. عند الإشارة (referencing) إلى الثوابت في الأصناف الوارثة من الصنف Object، لا ...

يعيد التابع ‎__id__‎‎ (يدعى أيضًا object_id) مُعرِّفا عدديًا للكائن الذي استُدعي معه. سيُعاد نفس المعرِّف في كل مرة يُستدعى فيها التابع object_id مع الكائن نفسه، ولن يتشارك أي كائنين نشطين نفس المعرِّف. ملاحظة: يعاد استخدام بعض كائنات الأصناف المٌضمّنة (builtin classes) وذلك لتحسين الأداء. هذا هو الحال بالنسبة للقيم المباشرة (immediate values) والسلاسل النصية الحرفية المجمدة (frozen string literals). لا تُمرَّر القيم المباشرة بالمرجع (reference) ولكنَّها تُمرَّر بالقيمة، مثل nil، و true، و false، و Fixnums، و Symbols، و Floats. ...

يستدعي التابع each_object كتلةً محدَّدةً مرةً لكل كائنٍ نشطٍ (living object) أو غير مباشرٍ (nonimmediate object) في هذه العملية الحالية في روبي. إذا حُدِّدت الوحدة (module) المراد تنفيذ الكتلة عليها، فسيستدعي التابع الكتلة للأصناف أو الوحدات المماثلة لهذه الوحدة (أو لتلك التي تكون صنفًا فرعيًا منها). يُعيد التابع each_object عدد الكائنات التي عُثر عليها. لا تُعاد الكائنات المباشرة (مثل Fixnums، و Symbols، و true، و false، و nil) أبدًا. إذا لم تُعطَ أي كتلة إلى التابع each_object، فستُعاد نسخةٌ من ...

jQuery.type( obj )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه. jQuery.type( obj )‎ أُضيفت مع الإصدار: 1.4.3 obj أي شيء، ويمثل الكائن المُراد معرفة نوعه الداخلي في JavaScript. يستعمل هذا التابع عددًا من التقنيات لتحديد نوع الكائن الذي سنحصل عليه بدقة، إذ يُحدَّد نوع الكائن كما يلي: إن كان الكائن غير مُعرَّف أو ذي قيمة عدميَّة، فستعاد حينئذٍ القيمة "undefined" أو القيمة "null" وفقًا لذلك: jQuery.type( undefined ) === "undefined"‎ jQuery.type() ...

jQuery.type( obj )‎ القيم المعادة يعيد سلسلة نصية (String). الوصف يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه. jQuery.type( obj )‎ أُضيفت مع الإصدار: 1.4.3 obj أي شيء، ويمثل الكائن المُراد معرفة نوعه الداخلي في JavaScript. يستعمل هذا التابع عددًا من التقنيات لتحديد نوع الكائن الذي سنحصل عليه بدقة، إذ يُحدَّد نوع الكائن كما يلي: إن كان الكائن غير مُعرَّف أو ذي قيمة عدميَّة، فستعاد حينئذٍ القيمة "undefined" أو القيمة "null" وفقًا لذلك: jQuery.type( undefined ) === "undefined"‎ jQuery.type() ...

يستدعي هذا التابعُ التابعَ Cursor.execute()‎ مع تمرير المعاملات المعطاة. البنية العامة execute(sql[, parameters]) ‎ المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. القيمة المعادة هذا التابع طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع execute()‎ في كائن المؤشر مع تمرير المعاملات المعطاة، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() symbol = 'RHAT' c.execute("SELECT * FROM stocks WHERE symbol = '%s'" % symbol) انظر أيضًا التابع Connection.excutemany()‎: ...

المعامل typeof يُعيد سلسلةً نصية تُشير إلى نوع القيمة التي تليه. البنية العامة typeof operand operand تعبير يُمثِّل كائنًا أو نوع بيانات أوليّ الذي نريد إعادة نوعه. الوصف الجدول الآتي يُلخِّص القيم التي يمكن أن يُعيدها المعامل typeof: النوع النتيجة undefined "undefined" null "object" (انظر الأمثلة) Boolean "boolean" Number "number" String "string" Symbol (جديد في ECMAScript 2015) "symbol" Function "function" أي كائن آخر "object" أمثلة // الأعداد typeof 37 === 'number'; typeof 3.14 === 'number'; typeof(42) === 'number'; typeof Math.LN2 === 'number'; typeof Infinity === ...

التابع PurePath.is_symlink في بايثون يعيد هذا التابع القيمة المنطقية True إذا كان المسار يشير إلى رابط دلالي (symbolic link)، وFalse فيما عدا ذلك. كما أنه يعيد False إذا كان المسار غير موجود أو أن الاختصار بشير إلى مسار غير موجود، كما يمكن لأخطاء أخرى (مثل عدم وجود صلاحيات) أن تظهر. البنية العامة المعاملات بدون معاملات القيمة المعادة يعيد هذا التابع القيمة المنطقية True إذا كان المسار يشير إلى رابط دلالي (symbolic link)، وFalse فيما عدا ذلك. كما أنه يعيد False ...

الدالة JSON.stringify()‎ تحوِّل قيمةً في JavaScript إلى سلسلة نصية بصيغة JSON، وتستطيع -اختياريًّا- استبدال القيم إذا حُدِّدَت دالة استبدال (replacer)، أو تضمين خاصيات مُعيّنة إذا حُدِّدة مصفوفة استبدال (replacer). البنية العامة JSON.stringify(value[, replacer[, space]]) value القيمة التي نريد تحويلها إلى صيغة JSON. replacer الدالة التي ستُغيّر من سلوك عملية التحويل، أو مصفوفة من كائنات String و Number التي تعمل كقائمة بالخاصيات المسموحُ تضمينها في الكائن؛ إذا كانت هذه القيمة null أو لم تضبَط فستضمَّن جميع الخاصيات. space كائن من النوع ...

تُضمَّن الوحدة Kernel من طرف الصنف Object، لذلك فتوابعها متاحة في كل كائنات روبي. توابع نسخ الصنف Kernel مُوثّقة في صفحة الصنف Object، أما توابع الوحدة Kernel فهي مُوثقة هنا. تستدعى هذه التوابع بدون مستقبل (receiver)، وبالتالي يمكن استدعاؤها وفق الشكل الدالي: sprintf "%.1f", 1.234 #=> "1.2" توابع الصنف العامة (Public Class Methods) Array يعيد المعامل الممرَّر إليه على شكل مصفوفة (Array). Complex يعيد ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. Float Hash يعيد ناتج التعبير x + ...

الدالة Symbol.keyFor(key)‎ تحصل على مفتاحٍ للرمز المعطي من سجل الرموز العام. البنية العامة Symbol.keyFor(sym); sym الرمز الذي سنبحث عنه. القيمة المعادة سلسلة نصية تمثل الرمز المرتبط بالرمز المعطي إن كان موجودًا في السجل العام؛ وإلا فستعاد القيمة undefined. أمثلة سنستخدم الدالة Symbol.for()‎ لإنشاء رمز عام جديد ثم سنحصل على قيمة مفتاحه عبر الدالة Symbol.KeyFor()‎ في المثال الآتي: var globalSym = Symbol.for('foo'); // إنشاء رمز عام جديد Symbol.keyFor(globalSym); // "foo" لاحظ أنَّ الدالة Symbol.KeyFor()‎ لن تُعيد قيمة رمز المفتاح المحلي، لأنَّه ليس موجودًا ...

يعيد التابع قائمة بأسماء الأعمدة. البنية العامة keys() القيمة المعادة يعيد التابع قائمة بأسماء الأعمدة، وتكون هذه القائمة العنصر الأول في كلّ صفّ tuple في قيمة الخاصية Cursor.description بعد إجراء الاستعلام مباشرة. ملاحظة: أضيف دعم عملية التقطيع في الإصدار 3.5 من اللغة. أمثلة لنفترض أنّنا هيّأنا جدولًا على النحو التالي: conn = sqlite3.connect(":memory:") c = conn.cursor() c.execute('''create table stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("""insert into stocks values ('2006-01-05','BUY','RHAT',100,35.14)""") conn.commit() c.close() يمكننا ...

يُمرِّر التابع chunk كل عنصر من عناصر المجموعة التي استدعيت معه إلى الكتلة المعطاة ثمَّ يُقطِّعها إلى أجزاء (قطع صغيرة) بحسب القيمة المعادة من الكتلة. العناصر المتتالية التي يكون لها نفس القيمة المعادة من الكتلة هي التي تُجمَّع سويةً. القيم المفتاحية التالية لها معنًى خاص: nil و ‎:_separator: يحدِّدان بأنَّه يجب على العناصر أن تُحذَف. يمكن استعمالهما لتجاهل بعض العناصر. ‎:_alone: يحدِّد بأنه يجب على العنصر أن يُجمَّع لوحده. أية رموز أخرى تبدأ بخط سفلي (underscore) سيؤدي استعمالها إلى رمي خطأ. البنية ...

تمثل كائنات الصنف Regexp التعابير النمطية التي تُستخدم لمطابقة نمط (pattern) معيّن في سلسلة نصية. تُنشَأ التعابير النمطية باستخدام الصياغتين /.../ و ‎%r{...}‎، أو باستعمال الباني new. التعابير النمطية هي أنماط تصف محتويات السلسلة النصية. يمكن استخدامها للتحقق من أنّ سلسلة نصية تحتوي على نمط معين، أو لاستخراج الأجزاء المُطابقة منها. عادةً ما يتم تحديد التعبير النمطي بخط مائل (/) كما يوضح المثال التالي: /hay/ =~ 'haystack' #=> 0 /y/.match('haystack') #=> #<MatchData "y"> ‎ إذا احتوت سلسلة نصية على النمط، فسيقال ...

الخاصية Function.name تُعيد اسم الدالة. سمات الخاصية Function.name قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم لاحظ أنَّ المتصفحات التي كانت تدعم هذه الخاصية قبل أن تصبح معياريةً (في ECMAScript 2015) كانت تضبط السمة configurable إلى false (أي أنَّ هذه الخاصية غير قابلة للضبط). أمثلة اسم دالة مُصرَّح عنها الخاصية name تُعيد اسم الدالة المستخدم في تعبير التصريح عن الدوال: function doSomething() {} doSomething.name; // "doSomething" اسم دالة مُعرَّفة عبر الدالة البانية Function الدوال المُنشَأة عبر البنية new Function(...)‎ أو ...

يغلق التابع الاتصال بقاعدة البيانات. يجدر الانتباه إلى أنّ إغلاق الاتصال لا يستدعي التابع commit()‎ على نحو تلقائي. فإن أغلقت الاتصال بقاعدة البيانات دون استدعاء التابع commit()‎ أولًا، ستفقد جميع التعديلات التي أجريتها على قاعدة البيانات. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") conn.commit() conn.close() مصادر صفحة ...

يحفظ التابع التعديلات التي أجريت على قاعدة البيانات. البنية العامة commit() ‎في حال عدم استدعاء هذا التابع ستكون جميع التعديلات التي أجريت بعد آخر استدعاء للتابع commit()‎ غير مرئية بالنسبة إلى الاتصالات الأخرى المفتوحة مع قاعدة البيانات؛ لذا إن لم تتمكن من رؤية البيانات التي أضفتها إلى قاعدة البيانات، فتأكّد من أنّك لم تنس استدعاء هذا التابع. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks ...

يجري التابع test عدة اختبارات على ملف واحد أو على ملفين. البنية العامة test(cmd, file1 [, file2] ) → obj‎ المعاملات cmd‎ يحدد الاختبار المراد تطبيقه. اختبارات File التي تطبَّق على ملف واحد هي: المعامل cmd نوع القيمة المعادة وصف "A" Time توقيت آخر دخول إلى الملف file1. "b" قيمة منطقية يعيد True إن كان الملف file1 جهازًا كتليًّا (block device). "c" قيمة منطقية يعيد True إن كان file1 من النوع جهازًا محرفيًّا (character device). "C" Time توقيت آخر تغيير ...

تُحدّث الدّالة locals()‎ قاموسًا يُمثّل جدول الرموز المحليّ (local symbol table) وتُعيده. البنية العامة locals() المعاملات لا توجد مُعاملات. القيمة المعادة قاموس يُمثّل المتغيّرات المحليّة. ملاحظات تُعاد المُتغيّرات الحرّة (free variables) من طرف الدّالة عند استدعائها داخل الدّوال وليس داخل الأصناف. لا يجب تعديل مُحتويات القاموس المُعاد، إذ أنّ التّعديلات قد لا تُؤثّر على المتغيّرات المحليّة والحرّة المُستخدمة من طرف المُفسّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> y = 1 # هذا المتغيّر لن يكون محليّا نسبة ...

يغلق التابع المؤشر فورًا (عوضًا عن إغلاقه عند استدعاء التابع ‎__del__‎)، وبعدها لن يكون بالإمكان استخدام المؤشر، وستطلق اللغة الاستثناء ProgrammingError عند تنفيذ أي عملية باستخدام المؤشر. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import sqlite3 >>> conn = sqlite3.connect('example.db') >>> c = conn.cursor() >>> c.execute('''CREATE TABLE stocks ... (date text, trans text, symbol text, qty real, price real)''') <sqlite3.Cursor object at 0x7f0ea62989d0> >>> c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") <sqlite3.Cursor ...

تعيد الدّالة globals()‎ قاموسًا يحتوي على الكائنات العامّة الحاليّة. البنية العامة globals() المعاملات لا توجد مُعاملات لهذه الدالة. القيمة المعادة قاموس يُمثّل جدول الرّموز العامّ (global symbol table) ويكون دائمًا قاموسَ الوحدة الحاليّة، وفي داخل دالّة أو تابع، فإنّ القاموس يُمثّل الكائنات العامّة في الوحدة التي عُرّفت فيها الدّالة أو التّابع وليس الوحدة التي استُدعيَت منها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّ المُتغيّر x الذي نُعرّفه داخل الدّالة hello‎‎(‎)‎ لا يظهر في القاموس لأنّه كائن محليّ ...

الدالة Object.assign()‎ تُستخدَم لنسخ قيمة جميع الخاصيات القابلة للإحصاء التابعة للكائن مباشرة (enumerable own properties) من كائنٍ مصدريٍ (source object) أو أكثر، وستُعيد الكائن الهدف (target object). البنية العامة Object.assign(target, ...sources) target الكائن الهدف. sources الكائنات المصدرية. القيمة المعادة الكائن الهدف. الوصف سيستعاض عن الخاصيات في الكائن الهدف بالخاصيات الموجودة في الكائنات المصدرية إن كانت تحمل المفتاح نفسه؛ وستُستخدَم قيمة الخاصيات الموجودة الكائنات المصدرية الأخيرة إذا وجدت خاصيات لها نفس المفتاح في الكائنات المصدرية الأولى. لا تنسخ الدالة Object.assign()‎ إلا ...

يعيد التابع intern بشكل عام الرمز المقابل لكائن ما. لذلك، عند استدعائه مع رمز، فسيعيد الرمز نفسه. البنية العامة intern→ sym‎ القيمة المعادة يعاد الرمز المعطى نفسه (self). انظر أيضًا التابع inspect: يعيد سلسلة نصية تمثل الرمز التي استُدعي معه. التابع size: يشبه التعبير sym.to_s.length. مصادر قسم التابع intern‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع id2name الاسم أو السلسلة نصية التي تمثل الرمز. البنية العامة id2name→ string‎ القيمة المعادة تعاد سلسلة نصية تمثِّل الاسم أو السلسلة نصية التي تمثل الرمز. أمثلة مثال على استخدام التابع id2name‎: :fred.id2name #=> "fred" :ginger.to_s #=> "ginger"‎ انظر أيضا التابع encoding: يُعيد الترميز الذي يمثل ترميز الرمز التي استُدعي معه. التابع inspect: يعيد سلسلة نصية تمثِّل الرمز التي استُدعي معه. التابع intern: يُعيد الرمز المقابل للسلسلة النصية التي استدعي معها، أو يُنشىء ذلك الرمز إذا لم يكن ...

يشبه التابع size التعبير sym.to_s.length. البنية العامة size → integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل حجم الرمز المعطى. انظر أيضًا التابع next: يشبه التعبير sym.to_s.succ.intern. التابع slice: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم التابع size‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يشبه التابع next التعبير sym.to_s.succ.intern. البنية العامة succ‎ انظر أيضًا التابع size: يشبه التعبير sym.to_s.length. مصادر قسم التابع next‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع match?‎ ناتج التعبير sym.to_s.match?‎. البنية العامة match?(pattern) → true or false match?(pattern, pos)→ true or false‎ المعاملات pattern النمط المراد التحقق من مطابقته للرمز المعطى. القيمة المعادة تعاد القيمة true إن طابق النمط pattern الرمز المعطى. خلا ذلك، تعاد القيمة false. انظر أيضا التابع match: يعيد ناتج التعبير sym.to_s.match. مصادر قسم التابع match?‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يُعيد التابع encoding كائنُا من النوع Encoding يمثل ترميز الرمز التي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنُ من النوع Encoding يمثل ترميز الرمز التي استُدعي معه. انظر أيضا التابع id2name: يعيد الاسم أو السلسلة نصية التي تمثل الرمز. مصادر قسم التابع encoding‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يتحقق التابع casecmp?‎ إن كان الرمز الذي استُدعي معه والرمز المُمرَّر إليه متساويين بشكل غير حساس لحالة الأحرف. البنية العامة casecmp?(other_symbol)→ true, false, or nil‎ المعاملات other_symbol‎ الرمز الآخر المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الرمز الذي استُدعي معه والرمز other_symbol المعطى متساويين بعد طي حالة الترميز الموحد (Unicode case folding)، أو تعاد القيمة false إذا لم يكونا متساويين، أو تُعاد القيمة nil إذا كان للرمزين ترميزين غير متوافقين، أو إن لم يكن other_symbol رمزًا. أمثلة ...

يعيد التابع to_sym بشكل عام الرمز المقابل لكائن. لذلك، عند استدعائه مع رمز، فسيعيد هذا الرمز نفسه (يعيد الكائن self). البنية العامة to_sym→ sym‎ القيمة المعادة يعاد الرمز المعطى نفسه (self). انظر أيضًا التابع to_s: يعيد الاسم أو السلسلة نصية التي تمثل الرمز مصادر قسم التابع to_sym‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع slice ناتج التعبير sym.to_s[]‎. البنية العامة slice(idx)→ char slice(b, n) → string‎ المعاملات idx فهرس المحرف المراد اقتطاعه وجلبه من الرمز المعطى. b فهرس بداية الجزء المراد اقتطاعه وجلبه من الرمز المعطى. n طول الجزء المراد اقتطاعه من الرمز المعطى. القيمة المعادة يعاد المحرف الواقع عند الفهرس idx أو تعاد السلسلة النصية التي تبدأ عند المحرف ذي الفهرس b وتمتد حتى الطول n من المحارف. انظر أيضًا المعامل []: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم التابع slice‎ في الصنف Symbol‎ ...

يشبه التابع length التعبير sym.to_s.length. البنية العامة length→ integer‎ القيمة المعادة يعاد عددٌ صحيحٌ يمثِّل طول الرمز المعطى. انظر أيضًا التابع size: يشبه التعبير sym.to_s.length. التابع slice: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم التابع length‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يشبه التابع succ التعبير sym.to_s.succ.intern. البنية العامة succ‎ انظر أيضًا التابع slice: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم التابع succ‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يتحقق التابع empty?‎ مما إذا كان الرمز الذي استُدعي معه يساوي "" أم لا. البنية العامة empty?→ true or false‎ القيمة المعادة تعاد القيمة true إن كان الرمز الذي استُدعي معه يساوي ""، وإلا فستعاد القيمة false. انظر أيضًا التابع encoding: يُعيد الترميز الذي يمثل ترميز الرمز التي استُدعي معه. مصادر قسم التابع empty?‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع to_proc كائنًا من النوع Proc، والذي يستجيب للتابع المعطى من قبل الرمز. البنية العامة to_proc‎ القيمة المعادة يعاد كائنٌ من النوع Proc. أمثلة مثال على استخدام التابع to_proc‎: (1..3).collect(&:to_s) #=> ["1", "2", "3"]‎ انظر أيضًا التابع to_s: يعيد الاسم أو السلسلة نصية التي تمثل الرمز مصادر قسم التابع to_proc‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يقارن التابع casecmp بين رمزين بشكل غير حساس لحالة الأحرف. هذا التابع هو نسخة غير حساسة لحالة الأحرف (Case-insensitive) من المعامل <=>‎. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف A-Z/a-z، وليس على كل محارف اليونيكود. هذا السلوك مختلف عن التابع casecmp?‎. البنية العامة casecmp(other_symbol)→ -1, 0, +1, or nil‎ المعاملات other_symbol‎ الرمز المراد التحقق من مقارنته مع الرمز المعطى. القيمة المعادة تعاد القيمة ‎-1 أو 0 أو ‎+1 أو بناءً على ما إذا كان الرمز أصغر من أو يساوي أو أكبر من other_symbol. أو ...

يعيد التابع match ناتج التعبير sym.to_s.match. البنية العامة match(pattern) → matchdata or nil match(pattern, pos)→ matchdata or nil‎ المعاملات pattern‎ نمط يراد به مطابقة الرمز المعطى. pos‎ موضع بدء عملية المطابقة. القيمة المعادة يعاد كائنٌ من النوع Matchdata يحوي نتائج التطابق. انظر أيضًا التابع match?‎: يعيد ناتج التعبير sym.to_s.match?‎. مصادر قسم التابع match‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يُعيد التابع all_symbols مصفوفة تضم جميع الرموز الموجودة حاليًا في جدول رموز روبي. البنية العامة all_symbols => array‎ القيمة المعادة تعاد مصفوفة تضم جميع الرموز الموجودة حاليًا في جدول رموز روبي. أمثلة مثال على استعمال التابع all_symbols: Symbol.all_symbols.size #=> 903 Symbol.all_symbols[1,20] #=> [:floor, :ARGV, :Binding, :symlink, ...

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

يجلب التابع جميع الصفوف (المتبقّية) في نتيجة الاستعلام، ويعيد النتيجة على هيئة قائمة. البنية العامة fetchall() ‎القيمة المعادة يجلب التابع جميع الصفوف (المتبقّية) في نتيجة الاستعلام، ويعيد النتيجة على هيئة قائمة. يجدر التنبيه هنا إلى إمكانية تأثير خاصية arraysize في كائن المؤشر على أداء هذا التابع. يعيد التابع قائمة فارغة في حال عدم توفر الصفوف المطلوبة. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import sqlite3 >>> conn = sqlite3.connect(":memory:") >>> cur = conn.cursor() >>> cur.execute("CREATE TABLE stocks (date text, trans text, symbol ...

الصنف Module هو مجموعة من التوابع والثوابت. التوابع الموجودة في الوحدات Module قد تكون إما توابع نسخة (instance methods)، أو توابع وحدة (module methods). توابع النسخة تظهر كتوابع في صنفٍ عند تضمين الوحدة، وذلك على خلاف توابع الوحدة. وعلى النقيض، يمكن استدعاء توابع الوحدة دون إنشاء كائن يُغلفها، بينما قد لا يمكن فعل ذلك مع توابع النسخة. انظر صفحة module_function. في الأمثلة الموجودة في صفحات التوابع، يشير المعامل sym إلى رمز، والذي قد يكون إما سلسلة نصية، أو كائنًا من النوع ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة compact()‎ مصفوفة تحتوي على متغيرات وقيمها. الوصف array compact ( mixed $varname1 [, mixed $... ] ) تنشئ هذه الدالة مصفوفةً تحتوي على متغيرات وقيمها. لكل من هذه المعاملات، تبحث الدالة compact()‎ عن متغير بهذا الاسم في جدول الرموز (symbol table) الحالي وتضيفه إلى المصفوفة المُخرَجة بحيث يصبح اسم المتغير هو المفتاح وتصبح محتويات المتغير قيمة ذلك المفتاح. باختصار، تعمل هذه الدالة بعكس الدالة extract()‎. وتتخطى الدالة أية سلاسل نصية (string) لم تُضبَط ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة compact()‎ مصفوفة تحتوي على متغيرات وقيمها. الوصف array compact ( mixed $varname1 [, mixed $... ] ) تنشئ هذه الدالة مصفوفةً تحتوي على متغيرات وقيمها. لكل من هذه المعاملات، تبحث الدالة compact()‎ عن متغير بهذا الاسم في جدول الرموز (symbol table) الحالي وتضيفه إلى المصفوفة المُخرَجة بحيث يصبح اسم المتغير هو المفتاح وتصبح محتويات المتغير قيمة ذلك المفتاح. باختصار، تعمل هذه الدالة بعكس الدالة extract()‎. وتتخطى الدالة أية سلاسل نصية (string) لم تُضبَط ...

الثبات: مستقر الكثير من أساس الواجهة البرمجية Node.js مبني حول بنية توجهها أحداث متميزة غير متزامنة حيث تطلق أنواع معينة من الكائنات (تُسمى "مطلقات" [emitters]) أحداث معينة تستدعي كائنات Function ("منصتات" [listeners]). على سبيل المثال: يطلق كائن net.server حدثًا كلما اتصل نظير بالخادم مثال آخر لكائن fs.ReadStream يطلق حدثًا عندما يُفتح ملف ما؛ ويطلق كائن stream حدثًا كلما أتيحت بيانات للقراءة. كل الكائنات التي تطلق أحداثًا هي من صنف مطلق الحدث EventEmitter. حيث تكشف عن الدالة eventEmitter.on()‎ التي تتيح إلحاق ...

يجلب التابع المجموعة اللاحقة من الصفوف rows في نتيجة الاستعلام، ويعيد النتيجة كقائمة. البنية العامة fetchmany(size=cursor.arraysize) المعاملات size يمكن تحديد عدد الصفوف التي يجلبها التابع مع كل استدعاء عن طريق المعامل size. وفي حال عدم تحديد قيمة لهذا المعامل فإنّ قيمة خاصية arraysize في كائن المؤشر ستحدّد عدد الصفوف التي سيجلبها التابع (القيمة الافتراضية لهذه الخاصية هي 1 وهذا يعني أنّ التابع سيجلب صفًّا واحدًا فقط). سيحاول التابع جلب الصفوف المحدّدة في معامل size، وإن كان ذلك غير ممكنًا بسبب ...

الدالة Object.prototype.hasOwnProperty()‎ تُعيد قيمةً منطقيةً تبيّن إن كان الكائن يمتلك خاصيةً ما مباشرةً (أي أنها لم يرثها). البنية العامة obj.hasOwnProperty(prop) prop سلسلة نصية String أو رمز Symbol للخاصية التي نريد اختبار وجودها في الكائن. القيمة المعادة قيمة منطقية Boolean تُشير إذا كانت الخاصية تابعةً للكائن مباشرةً أم لا. الوصف كل كائن ينحدر من الكائن Object يرث الدالة hasOwnProperty، ويمكن أن تُستخدَم هذه الدالة لتحديد إن كان يملك أحد الكائنات الخاصية المعنية مباشرةً؛ وعلى النقيض من المعامل in، هذه الدالة لا ...

يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. تعيد التوابع getmember()‎ و getmembers()‎ و gettarinfo()‎ كائنات TarInfo. البنية العامة الدالة البانية للصنف TarInfo: class tarfile.TarInfo(name="") خصائص كائنات TarInfo يمتلك كائن TarInfo الخصائص العامة التالية: TarInfo.name اسم عضو الأرشيف. TarInfo.size الحجم بالبايتات. TarInfo.mtime وقت آخر تعديل. ...

SQLite هي مكتبة مكتوبة بلغة C تتيح إنشاء قواعد بيانات على القرص الصلب ولا تحتاج إلى خادوم خاص لمعالجتها، وتتيح الوصول إلى قاعدة البيانات باستخدام نسخة غير قياسية من لغة الاستعلام SQL. تستخدم بعض التطبيقات والبرامج قاعدة بيانات SQLite لتخزين بياناتها الداخلية، ويمكن إنشاء نماذج أولية من التطبيق باستخدام SQLite ثم نقل الشيفرة إلى قواعد بيانات أكبر مثل PostgreSQL أو Oracle. كُتبت وحدة sqlite3 من قبل Gerhard Häring، وتقدّم واجهة SQL متوافقة مع معايير DB-API 2.0 الموصوفة في PEP 249. ...

قد تحتاج في بعض الأحيان إلى استخدام أسماء متغيّرة للمتغيرات، بمعنى أن تعيين اسم المتغيّر واستخدامه يكون بصورة ديناميكية. لتعريف المتغيرات العادية نستخدم الصيغة التالية: <?php $a = 'hello'; ?> أما المتغيّر المتغير (variable variable) فيأخذ قيمة متغيّر معين ويستخدمه كاسم لمتغير آخر. في المثال السابق يمكن استخدام الكلمة hello كاسم لمتغير آخر وذلك باستخدام علامتي $ عند التعبير عن المتغير: <?php $$a = 'world'; ?> في هذه النقطة هناك متغيّران معرّفان ومخزنان في شجرة رموز PHP (أي PHP symbol tree): الأول هو ‎$a ...