الفرق بين المراجعتين ل"Ruby/Module/private"

المراجعة الحالية بتاريخ 16:55، 19 نوفمبر 2018

يعين التابع private المرئية (visibility) الافتراضية للتوابع المحددة لاحقًا إلى المرئية private الخاصة إن استدعي دون تمرير أي شيء إليه. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط مرئية هذه التوابع إلى المرئية private الخاصة.

تذكر أنه لإظهار تابع خاص على RDoc، استخدم :doc:.

البنية العامة

private  → self
private(symbol, ...) → self
private(string, ...) → self‎

المعاملات

`symbol‎`

رمز يمثل التابع المراد ضبط مرئيته إلى خاصة.

`string‎`

سلسلة نصية تمثل التابع المراد ضبط مرئيته إلى خاصة. يحول هذا المعامل إلى رمز.

...

رمز أو سلسلة نصية تمثل التوابع المراد ضبط مرئيتها إلى خاصة.

القيمة المعادة

يعاد التابع ذو الاسم symbol‎ أو string‎ المحدَّد بعد ضبط مرئيته إلى خاصة.

أمثلة

مثال على استخدام التابع private‎:

module Mod
  def a()  end
  def b()  end
  private
  def c()  end
  private :a
end
Mod.private_instance_methods   #=> [:a, :c]‎

انظر أيضا

التابع private_class_method: يجعل توابع الصف الحالية خاصة (private).
التابع private_constant: ينشئ قائمة الثوابت الموجودة الخاصة.
التابع private_instance_methods: يعيد قائمة بتوابع النسخة (instance methods) الخاصة (private) المعرفة في الوحدة.
التابع protected: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى المرئية protected المحمية.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>private‎</code> الخاص بالصنف <code>Module</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Module.private‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
-[[تصنيف: Ruby Module]]
+[[تصنيف: Ruby Module Class]]
-إذا استُدعي التابع <code>private</code> دون إعطائه وسائط، فسيُعيّن المنظورية (visibility) الافتراضية للتوابع المحددة لاحقًا عند القيمة private. أما في حال تمرير وسائط، قسيضبط منظورية التوابع عند القيمة private. تُحوّل الوسائط النصية <code>String</code> إلى رموز.
+يعين التابع <code>private</code> [[Ruby/modules and classes#.D8.A7.D9.84.D9.85.D8.B1.D8.A6.D9.8A.D8.A9|المرئية]] (visibility) الافتراضية للتوابع المحددة لاحقًا إلى المرئية <code>private</code> الخاصة إن استدعي دون تمرير أي شيء إليه. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط [[Ruby/modules and classes#.D8.A7.D9.84.D9.85.D8.B1.D8.A6.D9.8A.D8.A9|مرئية]] هذه التوابع إلى المرئية <code>private</code> الخاصة.
-تذكر أنه لإظهار تابع خاص (private ) على RDoc ، استخدم <code>:doc:</code>.
+تذكر أنه لإظهار تابع خاص على RDoc، استخدم <code>:doc:</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">private  → self
@@ سطر 12: / سطر 12: @@
 ==المعاملات==
 ===<code>symbol‎</code>===
+[[Ruby/Symbol|رمز]] يمثل التابع المراد ضبط مرئيته إلى خاصة.
-===<code>...‎</code>===
 ===<code>string‎</code>===
+[[Ruby/String|سلسلة نصية]] تمثل التابع المراد ضبط مرئيته إلى خاصة. يحول هذا المعامل إلى [[Ruby/Symbol|رمز]].
+<code>...</code>
-==القيمة المُعادة==
+[[Ruby/Symbol|رمز]] أو [[Ruby/String|سلسلة نصية]] تمثل التوابع المراد ضبط مرئيتها إلى خاصة.
+==القيمة المعادة==
+يعاد التابع ذو الاسم <code>symbol‎</code> أو <code>string‎</code> المحدَّد بعد ضبط مرئيته إلى خاصة.
 ==أمثلة==
-مثال على استخدام التابع <code>private‎</code>:
+مثال على استخدام التابع <code>private‎</code>:<syntaxhighlight lang="ruby">module Mod
-<syntaxhighlight lang="ruby">module Mod
    def a()  end
    def b()  end
@@ سطر 31: / سطر 31: @@
 Mod.private_instance_methods   #=> [:a, :c]‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Module/prepended|prepended]]</code>: يكافئ <code>included</code> ، ولكنه للوحدات المُرفقة (prepended modules).
+*التابع <code>[[Ruby/Module/private class method|private_class_method]]</code>: يجعل توابع الصف الحالية خاصة (private).
-* التابع <code>[[Ruby/Module/private_class_method|private_class_method]]</code>: يجعل  توابع الصف الحالية خاصة (private). غالبًا ما يستخدم لإخفاء المُنشئ (constructor) الافتراضي <code>new</code>.
+*التابع <code>[[Ruby/Module/private constant|private_constant]]</code>: ينشئ قائمة الثوابت الموجودة الخاصة.
+*التابع <code>[[Ruby/Module/private instance methods|private_instance_methods]]</code>: يعيد قائمة بتوابع النسخة (instance methods) الخاصة (private) المعرفة في الوحدة.
+*التابع <code>[[Ruby/Module/protected|protected]]</code>: يعين [[Ruby/modules and classes#.D8.A7.D9.84.D9.85.D8.B1.D8.A6.D9.8A.D8.A9|المرئية]] (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى المرئية <code>protected</code> المحمية.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Module.html#method-i-private قسم  التابع private‎ في الصنف Module‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Module.html#method-i-private قسم التابع private‎ في الصنف Module‎ في توثيق روبي الرسمي.]