نتائج البحث

تمثل كائنات الصنف Symbol أسماء وسلاسل نصية داخل مترجم (interpreter) روبي. يمكن إنشاؤها باستخدام الصياغتين الحرفيتين ‎:name و ‎:"string"‎، أو بواسطة التوابع to_sym. سيتم إنشاء نفس الرمز (نفس الكائن Symbol) لاسم أو سلسلة نصية معينة طوال مدة تنفيذ البرنامج، بغض النظر عن السياق أو معنى هذا الاسم. وبالتالي، إن كان Fred ثابتًا في سياق معيّن، وتابعًا في سياق آخر، وصنفًا في سياق ثالث، فسيكون الرمز Symbol :Fred نفس الكائن في جميع السياقات الثلاث. module One class Fred end ...

الدالة Symbol()‎ تُعيد قيمةً من النوع symbol، وتملك هذه الدالة خاصيات ساكنة (static properties) ودوال ساكنة (التي تُستخدَم للوصول إلى سجل الرموز العام، أي global symbol registry، ويسمى أيضًا بالمصطلح symbol table)؛ وهذه الدالة تحاول التشبه بالدوال البانية للكائنات، لكنها ليست دالةً بانيةً لعدم القدرة على استخدام المعامل new معها كما في new Symbol()‎. كل رمز (symbol) مُعاد من الدالة Symbol()‎ هو رمزٌ فريد؛ ويمكن أن يُستخدَم كمُعرِّف (identifier) لخاصيات الكائنات، وهذا هو الغرض الرئيسي من هذا النوع من البيانات. ...

يعيد المعامل [] ناتج التعبير sym.to_s[]‎. البنية العامة sym[idx]→ char sym[b, n] → string‎ القيمة المعادة يعاد ناتج التعبير sym.to_s[]‎. انظر أيضا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل ‎=~‎: يعيد ناتج التعبير sym.to_s =~ obj. مصادر قسم المعامل []‎ في الصنف Symbol‎ في توثيق روبي الرسمي

يتحقق المعامل === إن كان رمزان هما نفس الرمز. البنية العامة sym == obj→ true or false‎ القيمة المعادة تعاد القيمة true إن كان sym و obj نفس الرمز. خلا ذلك، تُعاد القيمة false. انظر أيضًا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل =~: يعيد ناتج التعبير sym.to_s =~ obj. مصادر قسم المعامل ===‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يقارن المعامل <=> بين رمزين ثم يعيد ‎-1 أو 0 أو ‎+1 بناءً على ما إذا كان الرمز الأول أصغر من أو يساوي أو أكبر من الرمز الثاني. ستُعاد القيمة nil إن كانت القيمتان غير قابلتين للمقارنة. راجع صفحة المعامل ‎‎String#<=>‎ لمزيد من المعلومات. البنية العامة symbol <=> other_symbol → -1, 0, +1, or nil‎ القيمة المعادة تعاد القيمة ‎-1 أو 0 أو ‎+1 أو بناءً على ما إذا كان symbol أصغر من أو يساوي أو أكبر من other_symbol، أو تُعاد ...

يعيد المعامل ‎=~‎ ناتج التعبير sym.to_s =~ obj. البنية العامة sym =~ obj→ integer or nil‎ القيمة المعادة يعاد ناتج التعبير sym.to_s =~ obj. انظر أيضًا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل []: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم المعامل =~‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يتحقق المعامل == من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. البنية العامة sym == obj→ true or false‎ القيمة المعادة تعاد القيمة true إن كان sym و obj نفس الرمز. خلا ذلك، تعاد القيمة false. انظر أيضًا المعامل <=>: يقارن بين رمزين ثم يعيد ‎-1 أو 0 أو ‎+1 بناءً على ما إذا كان الرمز الأول أصغر من أو يساوي أو أكبر من الرمز الثاني. المعامل ===: يتحقق إن كان رمزان هما نفس الرمز. مصادر قسم المعامل ==‎ في الصنف ...

يتحقق التابعlocal_variable_defined? ‎ إن كان المتغير symbol المحلي موجودًا أم لا. هذا التابع هو النسخة المختصرة للشيفرة التالية: binding.eval("defined?(#{symbol}) == 'local-variable'") البنية العامة local_variable_defined?(symbol) → obj المعاملات symbol المتغير المحلي المراد التحقق من وجوده. القيم المعادة تعاد القيمة true إن كان المتغير symbol المحلي موجودًا، أو القيمة false خلاف ذلك. أمثلة مثال على استخدام التابعlocal_variable_defined? ‎: def foo a = 1 binding.local_variable_defined?(:a) #=> true binding.local_variable_defined?(:b) #=> false end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق ...

يتحقق التابعlocal_variable_defined? ‎ إن كان المتغير symbol المحلي موجودًا أم لا. هذا التابع هو النسخة المختصرة للشيفرة التالية: binding.eval("defined?(#{symbol}) == 'local-variable'") البنية العامة local_variable_defined?(symbol) → obj المعاملات symbol المتغير المحلي المراد التحقق من وجوده. القيم المعادة تعاد القيمة true إن كان المتغير symbol المحلي موجودًا، أو القيمة false خلاف ذلك. أمثلة مثال على استخدام التابعlocal_variable_defined? ‎: def foo a = 1 binding.local_variable_defined?(:a) #=> true binding.local_variable_defined?(:b) #=> false end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق ...

يعيد التابعlocal_variable_get ‎ قيمة المتغير المحلي الممرَّر إليه. هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("#{symbol}") البنية العامة local_variable_get(symbol) → obj المعاملات symbol المتغير المحلي المراد معرفة قيمته. القيم المعادة يعاد كائن يمثل قيمة المتغير المحدد في المعامل symbol. أمثلة مثال لاستخدام التابعlocal_variable_get ‎: def foo a = 1 binding.local_variable_get(:a) #=> 1 binding.local_variable_get(:b) #=> NameError end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variables: يعيد أسماء المتغيرات المحلية المعرفة في Binding على شكل ...

يعيد التابعlocal_variable_get ‎ قيمة المتغير المحلي الممرَّر إليه. هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("#{symbol}") البنية العامة local_variable_get(symbol) → obj المعاملات symbol المتغير المحلي المراد معرفة قيمته. القيم المعادة يعاد كائن يمثل قيمة المتغير المحدد في المعامل symbol. أمثلة مثال لاستخدام التابعlocal_variable_get ‎: def foo a = 1 binding.local_variable_get(:a) #=> 1 binding.local_variable_get(:b) #=> NameError end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variables: يعيد أسماء المتغيرات المحلية المعرفة في Binding على شكل ...

يضبط التابع local_variable_set‎ قيمة المتغير المحلي الممرر إليه إلى قيمة معينة. سلوك هذا التابع مشابه للشيفرة التالية في حال كان بالإمكان إهمال الكائن obj من شيفرة روبي: binding. eval("#{symbol} = #{obj}") البنية العامة local_variable_set(symbol, obj) → obj المعاملات symbol المتغير المحلي المراد ضبط قيمته إلى قيمة المعامل obj. إن كان المتغير المحلي المعطى موجودًا، فستُستبدَل قيمته. أما إن لم يكن موجودًا، فسينشأ وتضبط قيمته أيضًا إلى قيمة المعامل obj. obj الكائن الذي ستسند قيمته إلى قيمة المتغير المحلي المحدد ...

يضبط التابع local_variable_set‎ قيمة المتغير المحلي الممرر إليه إلى قيمة معينة. سلوك هذا التابع مشابه للشيفرة التالية في حال كان بالإمكان إهمال الكائن obj من شيفرة روبي: binding. eval("#{symbol} = #{obj}") البنية العامة local_variable_set(symbol, obj) → obj المعاملات symbol المتغير المحلي المراد ضبط قيمته إلى قيمة المعامل obj. إن كان المتغير المحلي المعطى موجودًا، فستُستبدَل قيمته. أما إن لم يكن موجودًا، فسينشأ وتضبط قيمته أيضًا إلى قيمة المعامل obj. obj الكائن الذي ستسند قيمته إلى قيمة المتغير المحلي المحدد ...

يُعرِّف التابع define_singleton_method تابعًا منفردًا (singleton method) في المستقبل (receiver). البنية العامة define_singleton_method(symbol, method) → symbol define_singleton_method(symbol) { block } → symbol المعاملات symbol الرمز المُمرَّر إلى التابع والذي سيُعرِّف التابع المنفرد. method التابع المُمرَّر كمعامل. يمكن أن يكون هذا التابع كائنًا من النوع proc، أو Method، أو UnboundMethod. block وسيط اختياري يمثِّل الكتلة المُمرَّرة إلى التابع. إذا أعطي، فستُنفَّذ الكتلة المعطاة كما لو أنَّها من جسم التابع method. القيم المعادة يُعاد تابعٌ منفردٌ يمكن استدعائه في المستقبل. أمثلة مثالٌ عن ...

يشبه التابع upcase التعبير sym.to_s.upcase.intern. البنية العامة upcase → symbol upcase([options])→ symbol‎ المعاملات options‎ خيارات. القيمة المعادة يعاد كائن من النوع Symbol. انظر أيضًا التابع to_sym: يعيد الرمز Symbol المقابل لكائن ما. مصادر قسم التابع upcase‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يَستدعي التابع public_send التابع المعرَّف برمزٍ (symbol) محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. خلافًا للتابع send، يَستدعي التابع public_send التوابع العامة فقط. إن عُرِّف التابع باستخدام سلسلةٍ نصيةٍ (string)، فستُحوَّل هذه السلسلة إلى رمز. البنية العامة public_send(symbol [, args...]) → obj public_send(string [, args...]) → obj المعاملات symbol الرَّمز المُعرِّف للتابع المراد استدعاءه. string سلسلة نصية تعرِّف التابع المراد استدعاءه.  ستُحوَّل هذه السلسلة إلى رمز إن أعطيت. ...args المعاملات المراد تمريرها إلى التابع الذي يراد استداعاؤه. القيم المعادة يُعاد ...

يَحذِف التابع remove_instance_variable متغيِّر نسخةٍ باسمٍ محدَّدٍ من الكائن الذي استدعي معه ويُعيد قيمة ذلك المتغيِّر. البنية العامة remove_instance_variable(symbol) → obj المعاملات symbol الرَّمز المعرِّف لمتغير النسخة المراد حذفه. القيم المعادة تعاد قيمة متغير النسخة symbol بعد حذفه من الكائن المعطى. أمثلة مثالٌ عن استخدام التابع remove_instance_variable: class Dummy attr_reader :var def initialize @var = 99 end def remove remove_instance_variable(:@var) end end d = Dummy.new d.var #=> ...

يَستدعي التابع send التابع المعرَّف برمزٍ (symbol) ويُنفَّذه تلقائيًا ويمرِّر إليه أي معاملاتٍ معطاة. يمكنك استخدام الاسم __send__ البديل إذا تضارب الاسم مع توابع موجودةٍ في الكائن تحمل نفس الاسم. إن عُرِّف التابع عن طريق سلسلةٍ نصية، فستُحوَّل تلك السلسلة إلى رمز. البنية العامة send(symbol [, args...]) → obj __send__(symbol [, args...]) → obj send(string [, args...]) → obj __send__(string [, args...]) → obj المعاملات symbol الرَّمزُ المعرِّف للتابع المُعطى. ...args المعاملات المراد تمريرها إلى التابع. القيم المعادة يُعاد الكائن الناتج عن تنفيذ ...

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

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

يتحقَّق التابع ?instance_variable_defined إذا كان متغيِّر النسخة (instance variable) المُمرَّر إليه مُعرَّفًا في الكائن المعطى. تُحوَّل الوسائط النصية التي من النوع String إلى رموزٍ (symbols). البنية العامة instance_variable_defined?(symbol) → true or false instance_variable_defined?(string) → true or false المعاملات symbol الرمز المراد التحقُّق من تعريفه في الكائن. string سلسلةٌ نصيةٌ من النوع String تُحوَّل إلى رمزٍ ثم يُتحقق من تعريفها في الكائن. القيم المعادة تُعاد القيمة true إذا كان متغيِّر النسخة symbol أو string مُعرَّفًا في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة ...

يشبه التابع swapcase التعبير sym.to_s.swapcase.intern. البنية العامة swapcase → symbol swapcase([options])→ symbol‎ المعاملات options‎ خيارات. القيمة المعادة يعاد كائن من النوع Symbol. انظر أيضًا التابع downcase: يشبه التعبير sym.to_s.downcase.intern. مصادر قسم التابع swapcase‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يشبه التابع downcase التعبير sym.to_s.downcase.intern. البنية العامة downcase → symbol downcase([options])→ symbol‎ المعاملات options‎ خيارات. القيمة المعادة يعاد كائن من النوع Symbol. انظر أيضًا التابع swapcase‎: يكافئ التعبير sym.to_s.swapcase.intern. مصادر قسم التابع downcase‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يشبه التابع capitalize التعبير sym.to_s.capitalize.intern. البنية العامة capitalize → symbol capitalize([options])→ symbol‎ القيمة المعادة يعاد كائنٌ من النوع Symbol. انظر أيضًا التابع casecmp?‎: يقارن بين رمزين بشكل غير حساس لحالة الأحرف. التابع empty?‎: يتحقق مما إذا كان الرمز فارغًا. مصادر قسم التابع capitalize‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعرّف التابع define_method تابع نُسخة (instance method) في المُستقبِل (receiver). في حال تمرير كتلة، فستُستخدم كجسم (body) للتابع. تُقيّم هذه الكتلة باستخدام التابع instance_eval، وهو أمر قد يكون مُشكلًا على البعض، لأن define_method خاصة. (لهذا سنحتال ونستخدم التابع send في المثال التالي.) البنية العامة define_method(symbol, method) → symbol define_method(symbol) { block }→ symbol‎ المعاملات symbol‎ رمز. method‎ تابع نُسخة. يمكن أن يكون من النوع Proc أو Method أو UnboundMethod. القيمة المعادة يعاد رمزٌ. أمثلة مثال على استخدام التابع define_method‎: class A ...

يستدعي التابع __send__ (يدعى أيضًا send) التابع الممرَّر إليه مع تمرير وسائط محددة إليه. يُستعمَل الاسم __send__ الخاص بهذا التابع إذا تعارض الاسم send مع اسم تابع موجود مسبقًا في obj. البنية العامة send(symbol [, args...]) → obj __send__(symbol [, args...]) → obj send(string [, args...]) → obj __send__(string [, args...]) → obj المعاملات symbol اسم التابع المُعرَّف المراد استدعاؤه. ...args الوسائط المراد تمريرها إلى التابع المحدد في المعامل symbol. string سلسلة نصية تمثل اسم التابع المراد استدعاؤه. عندما يُعرّف التابع بواسطة سلسلة ...

ينشئ التابع module_function دوال وحدة (module functions) للتوابع المعطاة. يمكن استدعاء هذه الدوال مع الوحدة كمُستقبِلات (receiver)، كما يمكن أن تصبح متاحةً كتوابع نسخة (instance methods) للأصناف التي تُمزج (mix) في الوحدة. دوال النوع Module هي نسخ من الدوال الأصلية، وبالتالي يمكن تغييرها بشكل مستقل. توابع النسخة (instance-method) ستتحول إلى خاصة. وإذا تم استدعاء التابع module_function دون معاملات، فستصبح التوابع التي ستُعرَّف لاحقًا دوال وحدة (module functions). تُحوّل الوسائط النصية إلى رموز. البنية العامة module_function(symbol, ...) → self module_function(string, ...) → self‎ المعاملات ...

يعيد التابع local_variables أسماء المتغيرات المحلية المعرفة في Binding على شكل رموز (symbols). هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("local_variables") البنية العامة local_variables → Array القيم المعادة تعاد مصفوفة تحوي أسماء المتغيرات المحلية المعرفة في Binding. أمثلة مثال على استخدام التابع local_variables‎: def foo a = 1 2.times do |n| binding.local_variables #=> [:a, :n] end end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variable_set‎: يضبط قيمة المتغير المحلي الممرر ...

يعيد التابع local_variables أسماء المتغيرات المحلية المعرفة في Binding على شكل رموز (symbols). هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("local_variables") البنية العامة local_variables → Array القيم المعادة تعاد مصفوفة تحوي أسماء المتغيرات المحلية المعرفة في Binding. أمثلة مثال على استخدام التابع local_variables‎: def foo a = 1 2.times do |n| binding.local_variables #=> [:a, :n] end end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variable_set‎: يضبط قيمة المتغير المحلي الممرر ...

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

يضبط (Controls) التابع trace_var تعقّبات (tracing) تعيين المتغيرات العامة. البنية العامة trace_var(symbol, cmd ) → nil trace_var(symbol) {|val| block } → nil‎ يحدد الوسيط المعطى symbol المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر cmd (الذي قد يكون سلسلةً نصيةً أو كائن من النوع Proc أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط. المعاملات symbol‎ يحدد المتغير. cmd‎ التعليمة المراد تنفيذها كلما تم تعيين المتغير. القيمة المعادة ...

يعيد التابع __callee__ اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __callee__→ symbol‎ القيمة المعادة يعاد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __dir__: يعيد المسار المطلق القانوني لمجلد الملف الذي استُدعي هذا التابع منه. التابع __method__: يعيد  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). مصادر قسم التابع ‎__callee__‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع __method__  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __method__→ symbol‎ القيمة المعادة يعاد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. التابع __dir__: يعيد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. مصادر ...

يعيد التابع instance_method كائنًا من النوع UnboundMethod يمثل تابع النسخة (instance method) المعطى في الوحدة التي استُدعي معها. البنية العامة instance_method(symbol)→ unbound_method‎ المعاملات symbol‎ كائن من النوع Symbol. القيمة المعادة يعاد كائنٌ من النوع UnboundMethod يمثل تابع النسخة المعطى في الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع instance_method‎: class Interpreter def do_a() print "there, "; end def do_d() print "Hello "; end def do_e() print "!\n"; end def do_v() print ...

تُغلِّف كائنات الصنف Binding سياق التنفيذ (execution context) في مكان معين في الشيفرة البرمجية، وتحتفظ بذلك السياق لاستخدامه مستقبلًا. يُحتفَظ بالمتغيرات، والتوابع، وقيمة self، وربما كتلة المكرر (iterator block) وكل ما يمكن الوصول إليه في هذا السياق. يمكن إنشاء كائنات الصنف Binding باستخدام التابع Kernel.binding، واستدعاؤها بوساطة التابع Kernel.set_trace_func. يمكن تمرير كائنات الربط (binding objects) هذه كوسيط ثانٍ للتابع Kernel.eval لإنشاء بيئة للتقييم (evaluation). class Demo def initialize(n) @secret = n end def get_binding ...

تُغلِّف كائنات الصنف Binding سياق التنفيذ (execution context) في مكان معين في الشيفرة البرمجية، وتحتفظ بذلك السياق لاستخدامه مستقبلًا. يُحتفَظ بالمتغيرات، والتوابع، وقيمة self، وربما كتلة المكرر (iterator block) وكل ما يمكن الوصول إليه في هذا السياق. يمكن إنشاء كائنات الصنف Binding باستخدام التابع Kernel.binding، واستدعاؤها بوساطة التابع Kernel.set_trace_func. يمكن تمرير كائنات الربط (binding objects) هذه كوسيط ثانٍ للتابع Kernel.eval لإنشاء بيئة للتقييم (evaluation). class Demo def initialize(n) @secret = n end def get_binding ...

تحذير: لا تستخدم هذا التابع مباشرةً!. يُصنَّف التابع ?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 (افتراضيًا)، أو القيمة ...

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

يحوّل التابع primitive_convert ترميز جميع المحتويات المخزَّنة مؤقتًا (buffer) في مخزن معين أو مجال محدد منها -من ترميز المصدر إلى ترميز الوجهة- ثم يضع الناتج في مخزَّن محدَّد. يحذف التّابع primitive_convert الجزء المحوّل من المخزن source_buffer المصدر، ويضعه في المخزن destination_buffer الوجهة أو يخزنِّه مؤقتًا في كائن من الصنفEncoding::Converter بعد تحويله بالتأكيد. يوقف التّابع primitive_convert عملية التحويل عند تحقّق أحد الشّروط التالية: وجود سلسلة بايت غير صالحة (invalid_byte_sequence:) في المخزن source_buffer المصدر . يُعيد التابعان primitive_errinfo و last_error تفاصيل الخطأ. ...

يعيد التابع reason سبب إنهاء الكتلة البرمجية: ‎ :breakأو ‎:redo أو ‎:retry أو ‎:next أو :return أو ‎:noreason. البنية العامة reason → symbol القيمة المعادة يعاد رمزٌ يمثل سبب إنهاء الكتلة البرمجية. انظر أيضا التابع exit_value: يعيد قيمة الخروج المرتبطة بالاستثناء LocalJumpError. مصادر قسم التابع reason في الصنف LocalJumpError في توثيق روبي الرسمي.

يعيد التابع __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 كائن من النوع ...