نتائج البحث

تنشئ الدالة new‎‎ مصفوفةً جديدةً. البنية العامة new(size=0, default=nil) new(array) new(size) {|index| block } إن لم تمرَّر أيَّة وسائط إلى الدالة new()‎، فستنشئ مصفوفة جديدة فارغة. إن مُرِّر الوسيطان size و default اللذان يمثلان حجم المصفوفة والقيم الأولية لعناصرها، فستُنشَأ مصفوفة جديدة حجمها size ومكونة من القيم default المعطاة. لاحظ أنَّ جميع العناصر تشير إلى الكائن default نفسه. first_array = ["Matz", "Guido"] تنشئ الدالة new()‎ أيضًا نسخة من مصفوفة أخرى عبر تمريرها كوسيط (تنشئ تلك المصفوفة عبر استدعاء التابع ‎ to_ary‎ مع الوسيط المعطى). ...

تحدِّد الدالة ()signature التوقيع (signature) الصحيح لعدد الوسائط المُمرّرة إلى دالة معيَّنة. في حالة عدم التطابق مع أيٍّ من التواقيع، فسيُعاد التوقيع الأول في رسالة الخطأ. البنية العامة .signature(method_name, arg_arity, kwarg_arity) المعاملات ‎method_name اسم دالة روبي التي ستُستدعى. ‎arg_arity عدد الوسائط غير المسماة (unnamed arguments) التي مُمرِّت إلى الدالة. ‎kwarg_arity عدد الوسائط المسماة (keyword arguments) التي مُمرِّت إلى الدالة. القيم المعادة تعاد خيارات التوقيع للتوقيع المطابق، أو القيمة nil إن لم يُصرّح بأي توقيع لتلك الدالة. انظر أيضًا الدالة declare()‎: تصرّح بتوقيع ...

تُصرّح بتوقيع (signature) خاص بلغة Sass لأجل دوال روبي. يتضمن التوقيع أسماءَ الوسائط، وهل ستأخذ الدالة عددًا متغيرًا من الوسائط، وما إن كانت الدالة ستقبل مجموعة عشوائيةً من الوسائط المُسمّاة (keyword arguments). التصريح بالتوقيع ليس ضروريًا ولكن لن تدعم الدالةُ بدونه الوسائط المُسمّاة. يمكن أن يكون لدالةٍ واحدةٍ أكثر من توقيع واحدٍ طالما أنّ كلَّ توقيع يأخذ عددًا مختلفًا من الوسائط. من الممكن أيضًا التصريح بعدة تواقيع تقبل جميعُها نفس العدد من الوسائط، ولكن لن يُستخدم في تلك الحالة سوى ...

يستخدم هذا الأمر لحذف دالة (أو إجراء) أو أكثر مُعرَّفة مسبقًا عبر الأمر CREATE FUNCTION، وله البنية العامّة الآتية: DROP {FUNCTION | PROCEDURE} [ IF EXISTS ] name [ ( [argtype [, ...] ] ) ] [, ...] [ CASCADE | RESTRICT ] إذ تُحذف الدالة المحدد باسم name، وتمنع IF EXISTS حدوث أي خطأ في حال عدم وجود دالة بهذا الاسم في قاعدة البيانات، ويُحدد نوع البيانات لمتغيرات الدالة ما بين قوسين لاحتمال تكرار نفس اسم الدالة بلائحة مختلفة ...

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

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

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

يعيد التابع clock_getres دقة الوقت المعادة عبر الدالة clock_getres()‎ التي تخص POSIX. البنية العامة clock_getres(clock_id [, unit]) → number المعاملات clock_id يحدِّد نوع النبضات (clock). اطلع على توثيق التابع clock_gettime لمزيد من التفاصيل. يمكن لهذا المعامل أن يكون رمزًا كما هو مذكور في clock_gettime. مع ذلك، قد لا تكون النتيجة دقيقة. على سبيل المثال، يعيد clock_getres(:GETTIMEOFDAY_BASED_CLOCK_REALTIME)‎ القيمة 1.0e-06 التي تعني 1 ميكروثانية لكنَّ الدقة الحقيقية أكبر من ذلك. إن كانت القيمة المعطاة للمعامل clock_id غير مدعومة، فسيُطلَق الخطأ Errno::EINVAL. unit يحدِّد نوع ...

تستعمل الوحدة Process للتعامل والتحكم بجميع العمليات في روبي. الثوابت CLOCK_BOOTTIME اطلع على توثيق التابع clock_gettime. CLOCK_BOOTTIME_ALARM اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_COARSE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_FAST اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_PRECISE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW_APPROX اطلع على توثيق التابع clock_gettime. CLOCK_PROCESS_CPUTIME_ID اطلع على توثيق التابع clock_gettime. CLOCK_PROF اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME_ALARM اطلع على توثيق ...

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

تحوي الوحدة Math الدوال المثلثية والمتسامية (transcendental functions، وتدعى أيضًا الدوال اللاجبرية) الأساسية. راجع صفحة الصنف Float للحصول على قائمة الثوابت التي تحدد دقة الأعداد العشرية (floating point) في روبي. مجالات التعريف (Domains) والمجالات المقابلة (codomains) تعطى فقط للأعداد الحقيقية (وليس للأعداد العقدية). الثوابت E يمثل القيمة e الرياضية، وهو العدد الذي يحقق log(e) = 1. PI يمثل ثابت الدائرة PI (يرمز له رياضيًّا بالرمز π). توابع الصنف العامة (Public Class Methods) acos يحسب معكوس جيب التمام (arc cosine) للعدد المعطى. ...

يحذف التابع unlink ملفًا محدَّدًا. يرمي هذا التابع استثناءً عند حصول أي خطأ. لمَّا كان التنفيذ الضمني لهذا التابع يعتمد على استدعاء النظام للدالة unlink(2)‎، فسيعتمد نوع الخطأ المرمي على أنواع الأخطاء الخاصة بها (اطلع على صفحة الدليل man لهذه الدالة لمزيد من التفاصيل) التي تأخذ شكلًا محدَّدًا مثل Errno::ENOENT. البنية العامة unlink(file_name, ...) → integer القيمة المعادة يعاد انظر أيضا التابع delete: يحذف ملفًا محدَّدًا. التابع new: يفتح ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع File. مصادر قسم التابع ...

يقرأ التابع read عددًا محددًا من البايتات من المجرى ARGF. البنية العامة read([length [, outbuf]]) → string, outbuf, or nil يعالج هذا التابع جميع الملفات الممرَّرة في سطر الأوامر وكأنَّها ملفٌ واحدٌ، لذلك يعيد جميع محتويات هذا الملف الزائف (pseudo file) عند استدعائه دون تمرير أي وسائط. إذا كانت قيمة الوسيط length عددًا صحيحًا موجبًا، فسيحاول التابع read قراءة عددٍ من البايتات يساوي length دون إجراء أي تحويل (الوضع الثنائي [binary mode]). في حال كان length عددًا صحيحًا (integer)، تكون السلسلة ...

يحذف التابع delete ملفًا محدَّدًا. يرمي هذا التابع استثناءً عند حصول أي خطأ. لمَّا كان التنفيذ الضمني لهذا التابع يعتمد على استدعاء النظام للدالة unlink(2)‎، فسيعتمد نوع الخطأ المرمي على أنواع الأخطاء الخاصة بها (اطلع على صفحة الدليل man لهذه الدالة لمزيد من التفاصيل) التي تأخذ شكلًا محدَّدًا مثل Errno::ENOENT. البنية العامة delete(file_name, ...) → integer المعاملات file_name اسم الملف المراد حذفه. ... أسماء الملفات الأخرى المراد حذفها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي أعطيت والتي يراد حذفها. انظر ...

يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن Dir الذي استُدعي معه. يستخدم هذا التابع الدالة dirfd()‎ المُعرّفة في المعيار POSIX 2008. وبالتالي، سيُطلق الخطأ NotImplementedError في أنظمة التشغيل التي لا توفّر هذه الدالة، مثل ويندوز. البنية العامة fileno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن Dir المعطى. أمثلة مثالٌ على استخدام التابع fileno: d = Dir.new("..") d.fileno #=> ...

يعيد التابع frexp مصفوفة بعنصرين تحتوي على الكسر القياسي (normalized fraction، عدد كسري) وأس (عدد صحيح) العدد المعطى. البنية العامة frexp(x) → [fraction, exponent]‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة تعاد مصفوفة بعنصرين تحتوي على الكسر القياسي وأس العدد x المعطى. أمثلة مثال على استخدام التابع frexp‎: fraction, exponent = Math.frexp(1234) #=> [0.6025390625, 11] fraction * 2**exponent #=> 1234.0‎ انظر ...

يعيد التابع clock_gettime الوقت المعاد عبر الدالة clock_gettime()‎ الذي يخص POSIX. البنية العامة clock_gettime(clock_id [, unit]) → number تعيد الدالة الضمنية، التي هي clock_gettime()‎، عدد النانو ثواني. الكائن Float (العدد العشري المضاعف وفق المعيار IEEE 754) ليس كافيًا لتمثيل القيمة المعادة من أجل CLOCK_REALTIME. إن كان عدد النانو ثواني الدقيق نفسه مطلوب، فاستعمل القيمة ‎:nanoseconds مع المعامل unit. يختلف أصل (نقطة الصفر) القيمة المعادة. على سبيل المثال، يمكن أن يكون نقطة بدء تشغيل النظام، أو بدء تشغيل العملية، أو وقت بدء توقيت يونكس ...

يبدأ التابع exit عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. هذا الاستثناء قد يُلتقَط. البنية العامة exit(status=true) Kernel::exit(status=true) Process::exit(status=true) المعاملات status معامل اختياري يُستعمَل لإعادة حالة الشيفرة للبيئة المستدعية. القيمة true والقيمة false للحالة المعادة تشيران إلى النجاح والفشل على التوالي. تفسير القيم العددية الأخرى المعطاة يعتمد على نظام التشغيل آنذاك. القيمة الافتراضية هي: true. أمثلة مثال على استعمال التابع exit: begin exit puts "never get here" rescue SystemExit puts "rescued a SystemExit exception" end puts "after begin block" ينتج عن تنفيذ ...

يشفِّر التابع crypt بناءً على القيمة Hash السلسلة النصية التي استدعي معها بطريقة غير قابلة للعكس (one-way cryptographic hash) عبر استدعاء دالة المكتبة القياسية crypt(3)‎ مع السلسلة النصية الإضافية المُمرَّرة إليه. لمَّا كان نمط التشفير والنتيجة تعتمدان على نظام التشغيل المستعمل، فإن استعمال سلسلةُ نصيةً إضافيةً (salt string) تطابق التعبير النمطي ‎\A[a-zA-Z0-9./]{2} ‎ يجب أن يكون صالحًا وآمنًا مهما كان نظام التشغيل المستعمل، إذ أول محرفين فيها مهمَّان لدرجة كبيرة. يعدُّ هذا التابع مخصَّصًا للاستعمال مع شيفرات مخصصة لنظام محدَّد، ...

ينشئ التابع fork عملية فرعية. إن أعطيت كتلةٌ، فستُنفَّذ هذه الكتلة في العملية الفرعية ثم تُنهَى العملية الفرعية مع حالة خروج تساوي إلى الصفر. خلاف ذلك، يعيد استدعاء التابع fork قيمتين، الأولى يعيدها في العملية الأب وهي مُعرِّف العملية الأبن، والثانية في العملية الابن وهي القيمة nil. تستطيع العملية الابن الخروج باستعمال التابع !Kernel.exit لتجنب تنفيذ أي دالة خروج مرتبطة عبر التابع at_exit. يجب أن تستعمل العملية الأب التابع Process.wait لجمع حالات الإنهاء (termination statuses) لعملياتهم الأبناء أو أن تستعمل Process.detach ...