نتائج البحث

يوازن المعامل <=> بين الكائنات File::Stat من ناحية أوقات تعديل كل منها. البنية العامة stat <=> other_stat → -1, 0, 1, nil القيمة المعادة تعاد القيم 1-، أو 0، أو 1 إن كان الكائن stat أصغر من أو يساوي أو أكبر من الكائن other_stat. تعاد القيمة nil إن لم يكن الكائن other_stat من النوع File::Stat. أمثلة مثال على استعمال المعامل <=>: f1 = File.new("f1", "w") sleep 1 f2 = File.new("f2", "w") f1.stat <=> f2.stat #=> -1 انظر أيضا التابع new: ينشئ ...

يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. البنية العامة to_a → Array القيمة المعادة تُعاد مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم متغيرات البيئة. أمثلة مثال عن استخدام التابع to_a: ENV.to_a # => [["TERM", "xterm-color"], ["SHELL", "/bin/bash"], ...] انظر أيضًا التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_a في الصنف ENV في توثيق روبي الرسمي.

يشرح هذا الدليل العمل الداخلي لعملية التهيئة في ريلز. وهو دليل متعمق للغاية وموصى به لمطوري ريلز المتقدمّين. ستتعلم بعد قراءة هذا الدليل: كيفيّة استخدام خادم ريلز (rails server). التسلسل الزمني لتهيئة ريلز. أين تُطلَب الملفّات المختلفة أثناء تسلسل التمهيد. كيفيّة تعريف واجهة Rails::Server واستخدامها. يتضمّن هذا الدليل كل استدعاء لتابع مطلوب لتشغيل مكّدس Ruby on Rails (أي stack) لتطبيق ريلز افتراضي، مع شرح كل جزء بالتفصيل. بالنسبة لهذا الدليل، سنركّز على ما يحدث عند تنفيذ rails server لبدء إقلاع ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chown()‎ مالك الملف. الوصف bool chown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة ...

تجمع الدالة foldRight()‎ بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت.  البنية العامة inline fun <T, R> Array<out T>.foldRight( initial: R, operation: (T, acc: R) -> R ): R inline fun <R> ByteArray.foldRight( initial: R, operation: (Byte, acc: R) -> R ): R inline fun ...

تجمع الدالة foldIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. البنية العامة يمكن استدعاء الدالة foldIndexed()‎ مع المصفوفات: inline fun <T, R> Array<out T>.foldIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): R inline fun <R> ByteArray.foldIndexed( initial: R, operation: ...

تجمع الدالة foldRightIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.  البنية العامة يمكن استدعاء الدالة foldRightIndexed()‎ مع المصفوفات: inline fun <T, R> Array<out T>.foldRightIndexed( initial: R, operation: (index: Int, T, acc: R) -> R ): R inline fun <R> ByteArray.foldRightIndexed( initial: R, operation: (index: ...

يحجز التابع allocate مساحةً من الذاكرة لكائن جديد من الصنف class دون استدعاء التابع initialize مع النسخة (instance) الجديدة. يجب أن يكون الكائن المُعاد نسخةً من الصنف class. البنية العامة allocate() → obj القيم المعادة يعاد كائن من الصنف class. أمثلة مثال على استخدام التابع allocate: klass = Class.new do def initialize(*args) @initialized = true end def initialized? @initialized || false end end klass.allocate.initialized? #=> false انظر أيضًا التابع new: يُنشئ صنفًا جديدًا مجهولًا غير مسمى (unnamed) من ...

(PHP 4 >= 4.0.5, PHP 5, PHP 7) تختزل الدالة array_reduce()‎ المصفوفة إلى قيمة واحدة باستخدام دالة مُعرَّفة من المستخدم callback. الوصف mixed array_reduce ( array $array , callable $callback [, mixed $initial = NULL ] ) تطبق الدالة array_reduce()‎ بشكل تكراري دالة callback على عناصر array، وذلك لاختزال المصفوفة إلى قيمة واحدة. المعاملات array المصفوفة المُدخلة. callback mixed callback ( mixed $carry , mixed $item ) carry يحتفظ بالقيمة المُعادة من التكرار السابق؛ ويحمل قيمة initial في حالة التكرار الأول. ...

(PHP 4 >= 4.0.5, PHP 5, PHP 7) تختزل الدالة array_reduce()‎ المصفوفة إلى قيمة واحدة باستخدام دالة مُعرَّفة من المستخدم callback. الوصف mixed array_reduce ( array $array , callable $callback [, mixed $initial = NULL ] ) تطبق الدالة array_reduce()‎ بشكل تكراري دالة callback على عناصر array، وذلك لاختزال المصفوفة إلى قيمة واحدة. المعاملات array المصفوفة المُدخلة. callback mixed callback ( mixed $carry , mixed $item ) carry يحتفظ بالقيمة المُعادة من التكرار السابق؛ ويحمل قيمة initial في حالة التكرار الأول. ...

تُطبّق الدّالة functools.reduce()‎ دالّة تأخذ مُعاملين بتراكب لعناصر الكائن القابل للتّكرار المُعطى، من اليسار إلى اليمين لتخفيض العناصر إلى قيمة واحدة (كجمع عدّة مبالغ للحصول على مبلغ إجماليّ واحد مثلًا). البنية العامة functools.reduce(function, iterable[, initializer]) المعاملات function الدّالة المُراد تطبيقها على عناصر الكائن القابل للتّكرار. iterable الكائن القابل للتّكرار. initializer قيمة بدئيّة تُضاف إلى بداية العناصر قبل بدء الحساب، وتكون كذلك قيمة افتراضيّة عندما يكون الكائن القابل للتّكرار فارغًا. إن لم تُمرّر قيمة للمُعامل initializer واحتوى الكائن القابل للتّكرار على ...

يستدعي التابع new التابعَ allocate لإنشاء كائن جديد من الصنف class، ثم يستدعي التابع initialize مع ذلك الكائن المنشأ ويُمرِّر إليه وسائط محددة. هذا هو التابع الذي يُستدعى كلما أريد إنشاء كائن باستخدام التابع ‎.new. البنية العامة new(args, ...) → obj المعاملات args الوسيط المراد تمريره إلى التابع initialize عند استدعائه. ... الوسائط الأخرى المراد تمريرها إلى التابع initialize عند استدعائه. القيم المعادة يعاد الكائن الذي أنشئ. انظر أيضًا التابع allocate: يحجز مساحةً من الذاكرة لكائن جديد من الصنف class ...

تجمع الدالة fold()‎ تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت، ويختلف سلوكها بحسب نوع الكائنات المستدعاة معها والمعاملات المُمرّرة إليها (انظر قسم "البنية العامة"). البنية العامة تجمع الدالة fold()‎ بشكل تراكمي ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (من اليسار إلى اليمين) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت.  inline fun <T, R> Array<out ...

يضيف التابع add الخيط المُمرَّر إليه إلى مجموعة الخيوط التي استدعي معها. انتبه إلى أن الخيط سيزال من أية مجموعة خيوط أضيف إليها مسبقًا. البنية العامة add(thread) → thgrp المعاملات thread الخيط المراد إضافته إلى المجموعة المعطاة. القيمة المعادة تعاد مجموعة الخيوط المعطاة بعد إضافة الخيط thread إليها. أمثلة مثال على استعمال التابع add: puts "Initial group is #{ThreadGroup::Default.list}" tg = ThreadGroup.new t1 = Thread.new { sleep } t2 = Thread.new { sleep } puts "t1 is #{t1}" puts "t2 is #{t2}" tg.add(t1) puts "Initial group now ...

يغطّي هذا الدليل كيفيّة إرفاق ملفات بنماذج Active Record. ستتعلم بعد قراءة هذا الدليل: كيفية إرفاق ملف أو عدّة ملفّات بسجل (record). كيفيّة حذف ملف مُرفق. كيفيّة الربط بملف مُرفق. كيفيّة استخدام المتغيّرات (variants) لتحويل الصور. كيفيّة إنشاء تمثيل صُوَري (image representation) لملف غير صُوَري، مثل ملف PDF أو فيديو. كيفيّة إرسال تحميلات الملفّات مباشرةً من المتصفّحات إلى خدمة تخزين، دون المرور على خوادم تطبيقك. كيفيّة تنظيف الملفّات المخزّنة أثناء الاختبار. كيفيّة تعريف استخدام (implement) الدعم لخدمات تخزين إضافيّة. ما ...

الخاصية flex المختصرة في CSS تُحدِّد كيف سيتمدد أو يتقلص أحد عناصر flex لكي يملأ المساحة المتوافرة في حاوية flex. هذه الخاصية المختصرة تضبط الخاصيات flex-grow و flex-shrink و flex-basis. بطاقة الخاصية القيمة الابتدائية لكل قيمة مختصرة: flex-grow: 0 flex-shrink: 1 flex-basis: auto تُطبَّق على عناصر flex. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة لكل قيمة مختصرة: flex-grow: كما حُدِّدَت. flex-shrink: كما حُدِّدَت. flex-basis: كما حُدِّدَت، لكن مع تحويل الأطوال النسبية إلى مطلقة. /* القيم الأساسية */ flex: auto; flex: initial; flex: none; flex: 2; /* One ...

يجمع التابع inject جميع عناصر الكائن القابل للتعداد الذي استدعي معه عبر تطبيق عملية ثنائية تُحدَّد بوساطة كتلة أو رمز يسمي تابعًا أو معاملًا. التابعان inject و reduce هما وجهين لعملة واحدة؛ أي كل منها اسم بديل للآخر. البنية العامة inject(initial, sym) → obj inject(sym) → obj inject(initial) { |memo, obj| block } → obj inject { |memo, obj| block } → obj إن حُدَّدَت كتلة مع هذا التابع، فسيُمرَّر لكل عنصر من عناصر الكائن القابل للتعداد المعطى قيمة تراكمية (memo) والعنصر نفسه. إن حُدَّدَ رمز ...

القيمة الابتدائية (initial value) التي نضعها في صفحات جميع خاصيات CSS لها معانٍ مختلفة للخاصيات التي يمكن أن ترث القيم والتي لا يمكن أن ترث القيم. فللخاصيات التي يمكن أن ترث القيم، فستُستخدَم القيمة الابتدائية للعنصر الجذر فقط، إذ ستُورَّث قيمة الخاصية إلى أولاد ذاك العنصر، وذلك عندما لا تُحدَّد قيمة أخرى للخاصية. أما الخاصيات التي لا يمكن أن ترث القيم، فستستخدم القيمة الابتدائية لأي عنصر عند عدم تحديد قيمة للخاصية. أُضيفت الكلمة المحجوزة initial في CSS3 للسماح للمطورين بتحديد ...

التعبير البرمجي for يُنشِئ حلقة تكرار تتألف من ثلاثة تعبيرات برمجية اختيارية تحيط بها أقواس وتفصل بينها فواصل منقوطة، ويليها تعبيرٌ برمجيٌ (وعادةً يكون قسمًا كتليًا [block statement]) سيُنفَّذ في كل تكرار للحلقة. البنية العامة for ([initialization]; [condition]; [final-expression]) statement initialization تعبير (يتضمن تعابير الإسناد) أو تصريح عن متغير، ويُستخدَم عادةً لتهيئة متغير العدّاد؛ وهذا التعبير قد يُصرِّح اختياريًا عن متغيرات جديدة باستخدام الكلمة المحجوزة var؛ وهذه المتغيرات ليست محليةً وتابعةً لحلقة التكرار، وإنما ستكون موجودةً في نفس ...

 الكلمات المفتاحيّة الثابتة (Hard Keywords) تُعدُّ الكلمات الآتية كلماتٍ مفتاحيّةً في لغة Kotlin وليس ممكنًا استخدامها كمُعرِّفات (identifiers): as تُستخدَم في التحويلات ما بين الأنواع (typecasts) تُحدِّد تسميةً بديلةً (alias) عند عملية الاستيراد (import) as?‎ للتحويلات الحافظة للنوع (safe type casts) break لإنهاء تنفيذ الحلقات (loops) class للتصريح عن الأصناف continue  للاستمرار بالخطوة التالية لأقرب حلقة محيطة (enclosing) do للبدء بحلقة do/while (والتي يُختبَر الشرط فيها لاحقًا) else لتعريف فرعٍ (branch) من تعبير الشرط if والذي سيُنفَّذ عندما يكون الشرط بالقيمة false false ...

يجمع التابع reduce جميع عناصر الكائن القابل للتعداد الذي استدعي معه عبر تطبيق عملية ثنائية تُحدَّد بوساطة كتلة أو رمز يسمي تابعًا أو معاملًا. التابعان inject و reduce هما وجهين لعملة واحدة؛ أي كل منها اسم بديل للآخر. البنية العامة reduce(initial, sym) → obj reduce(sym) → obj reduce(initial) { |memo, obj| block } → obj reduce { |memo, obj| block } → obj إن حُدَّدَت كتلة مع هذا التابع، فسيُمرَّر لكل عنصر من عناصر الكائن القابل للتعداد المعطى قيمة تراكمية (memo) والعنصر نفسه. إن حُدَّدَ رمز عوضًا عن ذلك، فسيُمرَّر كل عنصر ...

المحدد ‎:file الوصف يحدد كل حقول الإدخال من النوع file التي تسمح برفع الملفات. jQuery( ":file" )‎ أُ‎ضيف مع الإصدار: 1.0. يعادل المحدد ‎:file الصيغة [type="file"‎]. وكما هو الحال مع الأصناف الزائفة الأخرى (تلك التي تبدأ بنقطتين رأسيتين :)، فمن المستحسن أن تسبقها باسم وسم أو مُحدِّد آخر؛ خلاف ذلك، يستخدم المحدد العالمي (*) كمحدد ضمني. وبعبارة أخرى ، فإن ‎$( ":file" )‎ الصريح يساوي ‎$("*:file" )‎ ، لذا يُفضَّل استخدام ‎$( "input:file" )‎ بدلاً من ذلك. ملاحظات إضافية لأن ‎:file هو ملحق تابع لمكتبة ...

العنصر الوصف ‎--*‎ أسماء الخاصيات التي تُسبَق بشرطتين --، مثل ‎--example-name، تُمثِّل الخاصيات المخصصة (custom properties) التي تُسنَد لها قيمة يمكن إعادة استخدامها في المستند عبر الدالة var()‎. attr()‎ الدالة attr()‎ في CSS تُستعمَل للحصول على قيمة إحدى خاصيات العنصر المُحدَّد واستخدامها في أنماط CSS، ويمكن استعمالها أيضًا على العناصر الزائفة (pseudo-elements) وفي هذه الحالة ستُستخدَم قيمة خاصية العنصر الأصل. calc()‎ الدالة calc()‎ في CSS تسمح بإجراء عمليات حسابية عند تحديد قيم خاصيات CSS، ويمكن استخدامها في أي موضع يُسمَح فيه باستخدام أنواع البيانات<length> و <percentage> و <angle> و <time> و <number> و<integer>. inherit الكلمة المحجوزة inherit في ...

تشغيل المفسر عادة ما يُنصَّب مفسِّر بايثون في المسار ‎/usr/local/bin/python3.6 في أنظمة يونكس، ويؤدّي وضع هذا المسار ضمن مسار البحث الخاصّ بصدفة يونكس (Unix shell) إلى إمكانية استدعاء مفسّر بايثون عن طريق كتابة الأمر التالي في الصدفة: python3.6 ملاحظة: في أنظمة يونكس، لا يستخدم الاسم python افتراضيًا لاستدعاء مفسّر بايثون في الإصدارات ‎3.x‎ من اللغة، وذلك لتجنّب حدوث أي تضارب مع مفسّر الإصدارات ‎2.x من اللغة. يمكن تحديد مسار مفسِّر بايثون أثناء عملية التثبيت، وعادة ما يُستخدم المسار التالي: ‎/usr/local/python كمسار ...

الكلمة المحجوزة unset في CSS تُعيد ضبط قيمة الخاصية إلى قيمتها المورثة إن ورثت القيمة من العنصر الأب، أو إلى قيمتها الابتدائية إن لم ترثها؛ بصياغة أخرى، ستسلك هذه الكلمة المحجوزة سلوك inherit في الحالة الأولى، وسلوك initial في الحالة الثانية، ويمكن استخدام على جميع خاصيات CSS، بما في ذلك خاصية all المختصرة. أمثلة إعادة ضبط قيمة الخاصية color للعنصر <p> الموجود داخل العنصر <div> ذو الصنف bar إلى قيمتها الموروثة، ألا وهي green؛ أي كأننا ضبطنا قيمة الخاصية color إلى الكلمة ...

المعاملات الرياضية (arithmetic operators) تأخذ قيمًا عدديةً وتُعيد قيمةً عدديةً واحدةً، والمعاملات الرياضية القياسية هي الجمع + والطرح - والضرب * والقسمة /. الجمع (+) معامل الجمع يُنتِج مجموع المدخلات الرقمية، أو يضيف سلسلتين نصيتين إلى بعضها. البنية العامة x + y أمثلة // رقم + رقم -> عملية جمع 1 + 2 // 3 // رقم + قيمة منطقية -> عملية جمع true + 1 // 2 // قيمة منطقية + قيمة منطقية -> عملية جمع false + false // 0 // رقم + سلسلة ...

هذه الصفحة هي تجميع منظم ومرتب لأمثلة بلغة بايثون الاستثناءات تحتوي هذه الفقرة على أمثلة يصدر فيها استثناءات. الاستثناء FileNotFoundError تُصدره بعض التوابع القارئة للملفات عند عدم وجود الملف >>> f=open('D:\\file.txt') Traceback (most recent call last): File "<pyshell#123>", line 1, in <module> f=open('D:\\file.txt') FileNotFoundError: [Errno 2] No such file or directory: 'D:\\file.txt' الاستثناء KeyError  يصدر عند محاولة الوصول إلى عنصر عن طريق مفتاح غير موجود في القاموس >>> a=dict() >>> a["test"]="good" >>> print(a["no key"]) Traceback ...

يفتح التابع new ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع File. البنية العامة new(filename, mode="r" [, opt]) → file new(filename [, mode [, perm]] [, opt]) → file عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. تتعلق بتات الأذونات perm والنمط mode بالمنصة المستعملة. في الأنظمة الشبهة بيونكس، اطلع على صفحة الدليل man للدالة open(2)‎ والدالة chmod(2)‎ لمزيد من التفاصيل. يكون الكائن File الجديد المعاد في وضع التخزين (buffered mode) أو الوضع غير المتزامن ...

يتحقق التابع file?‎ إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. البنية العامة file?(file) → true or false المعاملات file سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file موجودًا وكان ملفًا طبيعيًّا. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق ...

تجمِّع الدالة fold()‎ تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.fold( initial: R, operation: (acc: R, Char) -> R ): R وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول محرف من محارف السلسلة لبدء ...

تجمِّع الدالة foldRight()‎ تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldRight( initial: R, operation: (Char, acc: R) -> R ): R وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول محرف من محارف السلسلة ...

يشبه التابع open التابع new تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن File) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة. البنية العامة open(filename, mode="r" [, opt]) → file open(filename [, mode [, perm]] [, opt]) → file open(filename, mode="r" [, opt]) {|file| block } → obj open(filename [, mode [, perm]] [, opt]) {|file| block } → obj عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. اطلع على صفحة التابع new ...

يتحقق التابع fnmatch من تطابق مسار مع نمط محدَّد. هذا النمط ليس تعبيرًا نظاميًّا بل يتبع قواعد مشابهة لتعميم أسماء الملفات في الصدفة. البنية العامة fnmatch( pattern, path, [flags] ) → (true or false) fnmatch?( pattern, path, [flags] ) → (true or false) المعاملات pattern النمط المراد منه مطابقة المسار path المعطى. يمكن أن يحتوي على المحارف الخاصَّة (metacharacters، أو تدعى محارف الصدفة أيضًا) التالية: المحرف الخاص الوصف * يطابق أي ملف. يمكن أن يُقيَّد بقيم أخرى في النطاق العام (glob). هذا ...

يتحقق التابع fnmatch?‎ من تطابق مسار مع نمط محدَّد. هذا النمط ليس تعبيرًا نظاميًّا بل يتبع قواعد مشابهة لتعميم أسماء الملفات في الصدفة. البنية العامة fnmatch?( pattern, path, [flags] ) → (true or false) المعاملات pattern النمط المراد منه مطابقة المسار path المعطى. يمكن أن يحتوي على المحارف الخاصَّة (metacharacters، أو تدعى محارف الصدفة أيضًا) التالية: المحرف الخاص الوصف * يطابق أي ملف. يمكن أن يُقيَّد بقيم أخرى في النطاق العام (glob). هذا المحرف يقابل ‎/ * /x‎. في التعابير النظامية. ...

تُستخدم الكلمة المفتاحيّة class للتصريح (declaration) عن الصنف بالصيغة الآتية (اسم الصنف Invoice): class Invoice { } ويحتوي التصريح على اسم الصنف (class name) وترويسة الصنف (class header) (والتي تُحدِّد معاملات النوع والباني الأساسيّ ...إلخ.) وبُنية الصنف (class body) محاطةً بالقوسين {}، وإن كلًا من ترويسة الصنف وبُنيته اختياريتان؛ فإذا كان الصنف خاليًا لا حاجة للأقواس، مثل: class Empty الباني (Constructor) يوجد لكلّ صنف في لغة Kotlin بانٍ رئيسيّ (primary) واحدٌ وبانٍ -أو أكثر- ثانويّ (secondary)، إذ يُعدُّ الباني الرئيسيّ جزءًا من ...

يعيد التابع file الملف الحالي على شكل كائن من النوع IO أو File. البنية العامة file → IO or File object القيم المعادة يعاد كائن من النوع IO أو File يمثل الملف الحالي، أو القيمة ‎$stdin إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثال على استخدام التابع file: $ echo "foo" > foo $ echo "bar" > bar $ ruby argf.rb foo bar ARGF.file #=> #<File:foo> ARGF.read(5) #=> "foo\nb" ARGF.file ...

 التابع PurePath.relative_to في بايثون يحسب هذا التابع كيف يبدو المسار عند اعتباره منسوبًا إلى المسار المُعطى، ويرمي الاستثناء ValueError عندما لا يُمكن نسب المسار الأصلي للمسار المُعطى البنية العامة >>> p = PurePosixPath('/etc/passwd') >>> p.relative_to('/') PurePosixPath('etc/passwd') >>> p.relative_to('/etc') PurePosixPath('passwd') >>> p.relative_to('/usr') Traceback (most recent call last):  File "<stdin>", line 1, in <module>  File "pathlib.py", line 694, in relative_to    .format(str(self), str(formatted))) ValueError: '/etc/passwd' does not start with '/usr' المعاملات الوسيط other* مجموعة غير محدودة من القيم، يتم دمجها لإعطاء المسار الذي سيُنسب إليه المسار الحالي، مُعطيًا المسار المنسوب في القيمة المعادة. ...

يتحقق التابع file?‎ إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. البنية العامة file?(file) → true or false المعاملات file سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. إن كان هذا المعامل وصلةً رمزيَّةً، فستُتبَع هذه الوصلة ويُستعمَل الملف الذي تشير إليه. القيمة المعادة تعاد القيمة true إن كان الملف file موجودًا وكان ملفًا طبيعيًّا. خلا ذلك، تعاد القيمة false.  انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من ...

أمثلة يوضح المثال التالي الطريقة المُثلى للاستفادة من توابع الكشف في الصنف stat: import os, sys from stat import * def walktree(top, callback): '''recursively descend the directory tree rooted at top, calling the callback function for each regular file''' for f in os.listdir(top): pathname = os.path.join(top, f) mode = os.stat(pathname).st_mode ...

يعيد التابع stat كائنًا من النوع File::Stat للملف المحدَّد. اطلع على توثيق الصنف File::Stat لمزيد من المعلومات. البنية العامة stat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name. أمثلة مثال على استعمال التابع stat: File.stat("testfile").mtime #=> Tue Apr 08 12:58:04 CDT 2003 انظر أيضا التابع lstat: يشبه التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من ...

الكلمة المحجوزة inherit في CSS تؤدي إلى جعل العنصر يأخذ القيمة المحسوبة لهذه الخاصية من العنصر الأب، ويمكن تطبيق هذه القيمة على جميع خاصيات CSS بما في ذلك خاصية all المختصرة. إذا كانت الخاصية موروثة، فيمكن استخدام هذه القيمة للتوضيح أو لتجاوز قيمة قاعدة أخرى، أما للخاصيات غير الموروثة، فستجد أنَّ من غير المنطقي استخدام هذه القيمة وربما تضع بالحسبان استخدام الكلمة المحجوزة initial. لاحظ أنَّ الوراثة تكون من العنصر الأب في شجرة المستند دومًا، حتى لو لم يكن العنصر ...

يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. إن لم يكن هنالك ملف، فسيُطلَق الخطأ ArgumentError. البنية العامة fileno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف الرقمي (numeric file descriptor) للملف الحالي. أمثلة مثالٌ على استخدام التابع fileno: ARGF.fileno #=> 3 انظر أيضًا التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع filename: يعيد اسم الملف الحالي. التابع lineno: يجلب ...

التابع PurePath.read_text في بايثون يعيد هذا التابع المحتوى النصي للملف كسلسلة نصية تم استحداث هذا التابع في النسخة 3.5 البنية العامة >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' المعاملات تأخذ الوسطاء الاختيارية نفس المعاني الخاصة بها في التابع المضمن open القيمة المعادة يعيد هذا التابع المحتوى النصي للملف كسلسلة نصية أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' انظر أيضًا مصادر

التابع PurePath.read_bytes في بايثون يعيد هذا التابع المحتوى المرمّز للملف المُشار إليه ككائن من النوع bytes تم استحداث هذا التابع في النسخة 3.5 البنية العامة >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' المعاملات بدون معاملات القيمة المعادة يعيد هذا التابع المحتوى المرمّز للملف المُشار إليه ككائن من النوع bytes أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' انظر أيضًا مصادر

تمثّل كائنات الصنف Location إطارات المكدس (stack frames)، وتُنشأ بواسطة التابع Kernel.caller_locations. إليك مثلًا الشيفرة التالية: # caller_locations.rb def a(skip) caller_locations(skip) end def b(skip) a(skip) end def c(skip) b(skip) end c(0..2).map do |call| puts call.to_s end‎ تشغيل الأمر ruby caller_locations.rb سوف ينتج: caller_locations.rb:2:in `a' caller_locations.rb:5:in `b' caller_locations.rb:8:in `c'‎ إليك مثالًا آخر بنتيجة مختلفة بعض الشيء: # foo.rb class Foo attr_accessor :locations def initialize(skip) @locations = caller_locations(skip) end end Foo.new(0..2).locations.map do |call| puts call.to_s end‎ الآن، إن قمت بتنفيذ ruby foo.rb، فيجب أن ترى ...

يُنشئ التابع new صنفًا جديدًا مجهولًا غير مسمى (unnamed) من الصنف الأب ( superclass) المُمرَّر إليه (أو من الصنف Object إن لم يمرر إليه أي شيء). يمكن إعطاء صنف ما اسمًا عن طريق تعيين كائن الصنف (class object) وإعطائه قيمة ثابتة. إن أعطيت كتلة برمجية، فسيُمرَّر إليها كائن الصنف (class object)، وستقدَّر الكتلة في سياق ذلك الصنف كما هو الحال مع class_eval. عيِّن الصنف وأعطه قيمة ثابتة (يبدأ الاسم بأحرف كبيرة) إذا كنت تريد معاملته كصنف اعتيادي. البنية العامة new(super_class=Object) ...

المتغير PurePath.drive سلسلة نصية تمثل اسم السواقة أو الحرف الممثل لها (في حال وجوده ضمن المسار) >>> PureWindowsPath('c:/Program Files/').drive 'c:' >>> PureWindowsPath('/Program Files/').drive '' >>> PurePosixPath('/etc').drive '' كما يتم يتم اعتبار مجلدات UNC المشارَكةاسمًا للسواقة >>> PureWindowsPath('//host/share/foo.txt').drive '\\\\host\\share' ===المتغير <code>PurePath.root</code>=== سلسلة نصية تمثل مسار الجذر (المحلي أو العام) في حال وجوده ضمن المسار <syntaxhighlight lang="python3"> >>> PureWindowsPath('c:/Program Files/').root '\\' >>> PureWindowsPath('c:Program Files/').root >>> PurePosixPath('/etc').root '/' UNC shares always have a root: >>> PureWindowsPath('//host/share').root '\\'

 التابع PurePath.as_uri في بايثون يعيد تمثيل المسار بتمثيل URI، ويرمي استثناء ValueError إن لم يكن المسار بصيغته المطلقة. البنية العامة >>> p = PurePosixPath('/etc/passwd') >>> p.as_uri() 'file:///etc/passwd' >>> p = PureWindowsPath('c:/Windows') >>> p.as_uri() 'file:///c:/Windows' المعاملات بدون معاملات القيمة المعادة يعيد تمثيل المسار بتمثيل URI، ويرمي استثناء ValueError إن لم يكن المسار بصيغته المطلقة. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = PurePosixPath('/etc/passwd') >>> p.as_uri() 'file:///etc/passwd' >>> p = PureWindowsPath('c:/Windows') >>> p.as_uri() 'file:///c:/Windows' انظر أيضًا مصادر

يعيد التابع sub نسخة من السلسلة النصية التي استدعي معها مع تبديل قيمة محدَّدة مع أول تطابق للنمط المعطى. البنية العامة sub(pattern, replacement) → new_str sub(pattern, hash) → new_str sub(pattern) {|match| block } → new_str إن أعطيت كتلة block إلى التابع، فستُمرَّر السلسلة الحالية المتطابقة إليها وستعيَّن قيم متغيرات مثل ‎$1، و ‎$2، و ‎$`‎، و ‎$&‎، و ‎$'‎ بشكل مناسب. ستحل القيم التي تعيدها الكتلة مكان القيمة المتطابقة في كل استدعاء. المعاملات pattern يكون عادةً تعبيرًا نمطيًّا. إن كان سلسلة نصية، فستُفسَّر أية محارف ...

يقفل التابع flock الملف الذي استدعي معه أو يلغي القفل الذي طُبِّق عليه لحماية الملف أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. هذا التابع غير متاح على جميع المنصات. البنية العامة flock(locking_constant) → 0 or false المعاملات locking_constant قيمة هذا المعامل هي أحد العمليات التالية: العمليَّة الوصف LOCK_SH طلب الحصول على قفل مشاركة (shared lock، عند القراءة). تستطيع أكثر من عملية تطبيق هذا القفل على الملف المعطى في الوقت نفسه. LOCK_EX ...

يشبه التابع lstat التابع IO.stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat → stat القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size #=> 66 f = File.new("link2test") f.lstat.size ...

يُطلق الاستثناء LoadError عند فشل تحميل الملف المطلوب (شيفرة روبي، مكتبة ملحقة، ...إلخ.). require 'this/file/does/not/exist' الشيفرة أعلاه ستطلق الاستثناء التالي: LoadError: no such file to load -- this/file/does/not/exist تمثل الخاصية path مسار الملف الذي فشلت روبي في تحميله. مصادر قسم الصنف LoadError في توثيق روبي الرسمي.

يشبه التابع lstat التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size ...

 التابع PurePath.joinpath في بايثون يُؤدي استدعاء هذا التابع إلى دمج المسار مع كلٍّ من الوسطاء الممررة له بالترتيب. البنية العامة >>> PurePosixPath('/etc').joinpath('passwd') PurePosixPath('/etc/passwd') >>> PurePosixPath('/etc').joinpath(PurePosixPath('passwd')) PurePosixPath('/etc/passwd') >>> PurePosixPath('/etc').joinpath('init.d', 'apache2') PurePosixPath('/etc/init.d/apache2') >>> PureWindowsPath('c:').joinpath('/Program Files') PureWindowsPath('c:/Program Files') المعاملات الوسيط others* عدد غير محدود من كائنات المسار أو السلاسل النصية التي سيتم دمجها مع المسار الأساسي للكائن. القيمة المعادة يعيد كائن مسار هو ناتج دمج المسار الأساسي مع المعاملات الممررة للتابع. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> PurePosixPath('/etc').joinpath('passwd') PurePosixPath('/etc/passwd') >>> PurePosixPath('/etc').joinpath(PurePosixPath('passwd')) PurePosixPath('/etc/passwd') >>> PurePosixPath('/etc').joinpath('init.d', 'apache2') PurePosixPath('/etc/init.d/apache2') >>> PureWindowsPath('c:').joinpath('/Program Files') PureWindowsPath('c:/Program Files') انظر أيضًا مصادر

تطبع الدّالة print()‎ الكائنات المُعطاة. تُفصَل القيم المطبوعة بقيمة المُعامل sep وتُتبع بقيمة المُعامل end. البنية العامة print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False) المعاملات objects مُعامل اختياريّ يُمثّل الكائنات التّي ستُطبع. تُحوّل الكائنات إلى سلاسل نصيّة كما تفعل الدّالة ‎str‎(‎)‎ قبل كتابتها إلى التّيار file مفصولة بالفاصل sep ومتبوعة باللاحقة end. sep مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). وهو مُعامل اختياريّ. السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة ...

يعيد التابع basename آخر مكوِّن من مسار اسم الملف المعطى. البنية العامة basename(file_name [, suffix] ) → base_name المعاملات file_name مسار الملف المراد اسخراج آخر مكون منه. يمكن أن يكون الفاصل المستعمل في فصل أجزاء هذا المسار هو File::SEPARATOR و File::ALT_SEPARATOR كلاهما عندما لا تكون قيمة الفاصل File::ALT_SEPARATOR هي nil. suffix معامل اختياري يحدد لاحقة الملف المراد إزالتها من الاسم الأساسي المستخرج من المسار. إن كانت قيمة هذا المعامل هي *.، فستُزال أية لاحقة تتبع الملف. القيمة المعادة يعاد الاسم الأساسي ...

 التابع PurePath.with_name في بايثون يعيد مسارًا جديدًا مع تغيير اسم العنصر الأخير، ويرمي استثناءً ValueError إن لم يكن في المسار الأصلي اسم ملف. البنية العامة >>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz') >>> p.with_name('setup.py') PureWindowsPath('c:/Downloads/setup.py') >>> p = PureWindowsPath('c:/') >>> p.with_name('setup.py') Traceback (most recent call last):  File "<stdin>", line 1, in <module>  File "/home/antoine/cpython/default/Lib/pathlib.py", line 751, in with_name    raise ValueError("%r has an empty name" % (self,)) ValueError: PureWindowsPath('c:/') has an empty name المعاملات الوسيط name الاسم الجديد للملف. القيمة المعادة يعيد مسارًا جديدًا مع تغيير اسم العنصر الأخير، ويرمي استثناءً ValueError إن ...

يعيد التابع to_io الملف الحالي على شكل كائن من النوع IO. البنية العامة to_io → IO القيم المعادة يعاد كائن من النوع IO يمثل الملف الحالي، أو يعاد كائنٌ من النوع ‎File إلا إذا كان الملف الحالي مجرى، مثل مجرى الدخل القياسي (STDIN). أمثلة مثال على استخدام التابع to_io: ARGF.to_io #=> #<File:glark.txt> ARGF.to_io #=> #<IO:<STDIN>> انظر أيضًا التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع to_write_io: يعيد نسخةً من ...

يعيد التابع to_i عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. إن لم يكن هنالك ملف، فسيُطلَق الخطأ ArgumentError. البنية العامة to_i → integer القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف الرقمي (numeric file descriptor) للملف الحالي. أمثلة مثال على استخدام التابع to_i: ARGF.to_i #=> 3 انظر أيضًا التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. التابع lineno: يجلب رقم السطر الحالي للمجرى ARGF ككُل. التابع ...

الخاصية text-decoration-color في CSS تُحدِّد اللون المستخدم لرسم علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر؛ يمكن ضبط قيمة هذه الخاصية باستعمال الخاصية المختصرة text-emphasis. بطاقة الخاصية القيمة الابتدائية currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم الوسائط مرئية القيمة المحسوبة القيمة اللونية المحسوبة. /* القيمة الابتدائية */ text-emphasis-color: currentColor; /* <color> */ text-emphasis-color: #555; text-emphasis-color: blue; text-emphasis-color: rgba(90, 200, 160, 0.8); text-emphasis-color: transparent; /* القيم العامة */ text-emphasis-color: inherit; text-emphasis-color: initial; text-emphasis-color: unset; أمثلة مثال عن استخدام الخاصية text-emphasis-color على العنصر <strong> مع الخاصية ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewinddir()‎ مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. الوصف void rewinddir ([ resource $dir_handle ] ) ترجع هذه الدالة موقع المؤشِّر للمجلَّد الذي يشير إليه المورد dir_handle إلى بداية مجرى المجلَّد. المعاملات dir_handle مورد مقبض المجلَّد الذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل (أي لم يحدَّد المجلَّد)، فسيكون آخر مجلَّد فُتح باستعمال الدالة opendir()‎. القيم المعادة تُعاد القيمة NULL عند نجاح العمليَّة. خلا ذلك، تُعاد ...

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف ConfigParser. البنية العامة add_section(section) ‎المعاملات section سلسلة نصية تتضمن اسم القسم المراد إضافته إلى نسخة الصنف ConfigParser. القيمة المعادة إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. يجب أن يكون الاسم المعطى سلسلة نصية وإلّا فإنّ التابع يطلق الاستثناء TypeError. ملاحظة: يطلق التابع الاستثناء TypeError عند استخدام الأسماء غير النصية في الإصدار 3.2 ...

يعيد التابع to_write_io نسخةً من الصنف IO مرتبطةً بالمجرى ARGF للكتابة عليها في حال كان الوضع inplace مفعَّلًا. البنية العامة to_write_io → io القيم المعادة يعاد كائن من النوع IO مرتبط بالمجرى ARGF. انظر أيضًا التابع write: يكتب السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا. التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. التابع ...

يعرِّف التابع ftype نوع الملف المعطى. البنية العامة ftype(file_name) → string المعاملات file_name اسم الملف المراد تحديد نوعه. القيمة المعادة تعاد سلسلة نصية تحدَّد نوع الملف file_name. تكون هذه السلسلة النصية المعادة إحدى السلاسل النصية التالية: "file''، أو "directory''، أو "characterSpecial''، أو "blockSpecial''، أو "fifo''، أو "link''، أو "socket''، أو "unknown''. أمثلة مثال على استعمال التابع ftype: File.ftype("testfile") #=> "file" File.ftype("/dev/tty") ...

المتغير PurePath.anchor يجمع اسم السواقة مع مسار الجذر >>> PureWindowsPath('c:/Program Files/').anchor 'c:\\' >>> PureWindowsPath('c:Program Files/').anchor 'c:' >>> PurePosixPath('/etc').anchor '/' >>> PureWindowsPath('//host/share').anchor '\\\\host\\share\\'

التابع Path.write_text يفتح الملف المٌشار إليه بالنمط النصي، ويكتب البيانات فيه ثم يُغلقه. >>> p = Path('my_text_file') >>> p.write_text('Text file contents') 18 >>> p.read_text() 'Text file contents' <span> </span> <span> </span> تابع مُستحدث في السخة 3.5.

التصريح عن الخاصّيّات (Declaring Properties) قد تحتوي الأصناف في لغة Kotlin على الخاصّيّات المعرَّفة إما كقيمٍ متغيّرةٍ عبر الكلمة المفتاحيّة var أو كقيمٍ ثابتةٍ للقراءة فقط (read-only) عبر الكلمة المفتاحيّة val، مثل: class Address { var name: String = ... var street: String = ... var city: String = ... var state: String? = ... var zip: String = ... } إذ يُمكن الوصول للخصائص عبر اسمها ...

الخاصية tab-size في CSS تُستعمل لتخصيص عرض محرف الجدولة (tab) الذي له الرمز U+0009 في يونيكود. بطاقة الخاصية القيمة الابتدائية 8 تُطبَّق على الحاويات الكتلية. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدت. /* <integer> قيم عددية */ tab-size: 4; tab-size: 0; /* <length> قيم طولية */ tab-size: 10px; tab-size: 2em; /* قيم عامة */ tab-size: inherit; tab-size: initial; tab-size: unset; أمثلة مثال عن استخدام الخاصية tab-size على عنصر <pre> (لاحظ أنَّ الحالة الوحيدة التي سيُعرَض فيها محرف tab في مستندات HTML هي داخل العنصر <pre> أو ...

المتغير PurePath.root سلسلة نصية تمثل مسار الجذر (المحلي أو العام) إن وُجد. >>> PureWindowsPath('c:/Program Files/').root '\\' >>> PureWindowsPath('c:Program Files/').root '' >>> PurePosixPath('/etc').root '/' تملك مجلدات المشاركة UNC مسار جذر دومًا >>> PureWindowsPath('//host/share').root '\\'

تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. البنية العامة marshal.dumps(value[, version]) ‎المعاملات value القيمة المطلوبة. version يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version). القيمة المعادة تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. يجب أن تكون القيمة المعطاة مدعومة، وتطلق اللغة الاستثناء ValueError إن كانت القيمة غير مدعومة أو تتضمّن كائنًا غير مدعوم. أمثلة يبين المثال التالي آلية عمل الدالة: >>> ...

يعيد التابع path اسم الملف الحالي. البنية العامة path → String القيم المعادة تعاد سلسلة نصية تمثل اسم الملف الحالي، أو القيمة "-" إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثالٌ على استخدام التابع path: $ echo "foo" > foo $ echo "bar" > bar $ echo "glark" > glark $ ruby argf.rb foo bar glark ARGF.filename #=> "foo" ARGF.read(5) #=> "foo\nb" ARGF.filename #=> "bar" ARGF.skip ARGF.filename #=> "glark" انظر أيضًا التابع filename: يعيد اسم الملف الحالي. التابع file: يعيد ...

يعيد التابع dirname جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار؛ أي يعيد اسم المجلد الذي يتوضع الملف ضمنه. البنية العامة dirname(file_name) → dir_name المعاملات file_name مسار الملف المراد اسخراج اسم المجلد منه. يمكن أن يكون الفاصل المستعمل في فصل أجزاء هذا المسار هوFile::SEPARATOR و File::ALT_SEPARATOR كلاهما عندما لا تكون قيمة الفاصل File::ALT_SEPARATOR هي nil. القيمة المعادة يعاد اسم المجلد (أو مساره) الذي يتوضع الملف file_name ضمنه. أمثلة مثال على استعمال التابع dirname: File.dirname("/home/gumby/work/ruby.rb") #=> ...

التابع Path.write_bytes يفتح الملف المُشار إليه في نمط bytes، ويكتب البيانات فيه ثم يُغلقه. >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' إن كان المسار يشير إلى ملف موجود مسبقًا، فإن الكتابة عليه تؤدي إلى حذف المحتوى السابق. تابع مُستحدث في السخة 3.5.

يشبه التابع start التابع new بشكل أساسي إلا أنه عند اشتقاق صنف فرعي (subclassed) من Thread، فإنَّ استدعاء start في ذلك الصنف الفرعي لن يستدعي تابع الصنف الفرعي initialize. البنية العامة start([args]*) {|args| block }→ thread‎ المعاملات args‎ وسائط تُمرر إلى الكتلة. القيمة المعادة يعاد كائن من النوع Thread. انظر أيضًا التابع stop: يوقف تنفيذ المهمة الفرعية الحالية. مصادر قسم التابع start‎ في الصنف Thread‎ في توثيق روبي الرسمي.

التابع fork مكافئ للتابع new. إلا أنه في حال اشتقاق صنف فرعي من Thread، فإنَّ استدعاء التابع start  في ذلك الصنف الفرعي لن يستدعي تابع الصنف الفرعي initialize. البنية العامة fork([args]*) {|args| block } → thread‎ القيمة المعادة يعيد كائنا من النوع Thread. انظر أيضًا التابع exit: ينهي المهمة الفرعية قيد التشغيل، ويُجدول مهمة فرعية أخرى ليتم تشغيلها. مصادر قسم التابع fork‎ في الصنف Thread‎ في توثيق روبي الرسمي.

المتغير PurePath.parts يمثّل هذا المتغير tuple لعناصر المسار >>> p = PurePath('/usr/bin/python3') >>> p.parts ('/', 'usr', 'bin', 'python3') >>> p = PureWindowsPath('c:/Program Files/PSF') >>> p.parts ('c:\\', 'Program Files', 'PSF') (لاحظ في المثال السابق كيف تم دمج اسم السواقة مع مسار الجذر المحلي في جزء واحد)

تُعدُّ الأصناف كائناتٍ من الدرجة الأولى (first-class objects) في روبي، وتعدُّ جميعها نُسخٌ من الصنف Class. عادةً، يمكن عادةً إنشاء صنف جديد بالشكل التالي: class Name # تكتب هنا الشيفرة التي تعرف سلوك الصنف end عندما يُنشَأ صنف جديد، يهيَّأ كائن من النوع Class ويسند إلى ثابت عام (global constant، هو Name في المثال السابق). عند استدعاء Name.new لإنشاء كائن جديد، يُنفَّذ التابع new الخاص بالصنف Class بشكل افتراضي. يمكن إثبات ذلك من خلال إعادة تعريف التابع new: class Class alias old_new ...

يجلب التابع lineno رقم السطر الحالي للمجرى ARGF ككُل. يمكن تعيين هذه القيمة يدويًا عبر استدعاء هذا التابع بالشكل lineno = integer. البنية العامة lineno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل رقم السطر الحالي للمجرى ARGF ككل. أمثلة مثالٌ على استخدام التابع lineno: ARGF.lineno #=> 0 ARGF.readline #=> "This is line 1\n" ARGF.lineno #=> 1 انظر أيضًا التابع lineno: يعيِّن عند استدعائه بالشكل lineno = integer رقم السطر الحالي للمجرى ARGF ككُل. التابع file: يعيد ...

تكتب الدالة القيمة المعطاة في الملف المفتوح. البنية العامة marshal.dump(value, file[, version]) ‎المعاملات value القيمة المراد كتابتها إلى الملف. يجب أن تكون قيمة مدعومة من قبل الوحدة marshal. file الملف المراد كتابة القيمة فيه، ويجب أن يكون ملفًّا ثنائيًا قابلًا للكتابة. version يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version). القيمة المعادة إن كانت القيمة غير مدعومة أو تضمّنت كائنًا غير مدعوم، تطلق اللغة الاستثناء ValueError، ولكن ستُكتب بيانات غير ذات قيمة إلى الملف المفتوح، ...

يعيد التابع filename اسم الملف الحالي. البنية العامة filename → String القيمة المعادة تعاد سلسلة نصية تمثل اسم الملف الحالي، أو القيمة "-" إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثالٌ على استخدام التابع filename: $ echo "foo" > foo $ echo "bar" > bar $ echo "glark" > glark $ ruby argf.rb foo bar glark ARGF.filename #=> "foo" ARGF.read(5) #=> "foo\nb" ARGF.filename #=> "bar" ARGF.skip ARGF.filename #=> "glark" انظر أيضًا التابع path: يعيد اسم الملف الحالي. التابع file: يعيد ...

يستخدم هذا الصنف ملفًّا ثنائيًا يقرأ منه تدفق البيانات المسلسلة. يجري الكشف عن رقم البروتوكول المستخدم تلقائيًا؛ لذا لا حاجة لأي معامل لتحديده. البنية العامة class pickle.Unpickler(file, *, fix_imports=True, encoding="ASCII", errors="strict") ‎المعاملات file يجب أن يمتلك المعامل file تابعين، الأول هو تابع read()‎ والذي يأخذ معاملًا عدديًا، وتابع readline()‎ والذي لا يحتاج إلى أيّ معاملات. يجب أن يعيد كلا المعاملين كائنات bytes، ولهذا يمكن أن يكون file كائن ملف مخزّنًا على القرص الصلب ومفتوحًا للقراءة الثنائية، أو كائن io.BytesIO أو ...

مقدمة وجود ملفٍّ باسم ‎tsconfig.json‎ في مجلّدٍ ما إشارةٌ إلى أنّ المجلّد هو جذر (root) مشروع TypeScript. يُحدِّد الملفّ ‎tsconfig.json‎ الملفات الجذر (root files) وخيارات الترجمة المطلوبة لترجمة المشروع. يُترجم المشروع بإحدى الطريقتين التاليتين: عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة (input files): في هذه الحالة يبحث المترجم عن الملف ‎tsconfig.json‎ بدءًا من المجلد الحالي ثمّ الصعود للأعلى في سلسلة المجلدات الآباء (parent directory chain). عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة وخيار سطر الأوامر ‎--project‎ (أو ‎-p‎ ...

يأخذ التابع compile وسيطًا source (انظر فقرة البنية العامة)، والذي هو سلسلة نصية (String) تحتوي على أكواد برمجية لروبي ويُصرّفها (compiles) إلى كائن من النوع InstructionSequence. يأخذ التابع compile اختياريا الوسائطً file و path و line التي تمثل اسم الملف والمسار المطلق ورقم السطر الأول من كود روبي في المصدر source، والتي هي بيانات وصفية (metadata) تُربط بالكائن المُعاد iseq. يتم استخدام الوسيط options، والذي يمكن أن تكون قيمته true أو false أو قاموسًا (Hash)، لتعديل السلوك الافتراضي لمصرّف روبيRuby سلسلة التعليمات ...

يقرأ التابع readbyte البايت التالي من المجرى ARGF ثمَّ يعيده على شكل عدد صحيح (Integer). يطلق التابع الخطأ EOFError بعد قراءة البايت الأخير من الملف الأخير. البنية العامة readbyte → Integer القيم المعادة يعاد عدد صحيح يمثل قيمة البايت الذي قُرِأ من المجرى ARGF. أمثلة أمثلة لاستخدام التابع readbyte: $ echo "foo" > file $ ruby argf.rb file ARGF.readbyte #=> 102 ARGF.readbyte #=> 111 ARGF.readbyte #=> 111 ARGF.readbyte #=> 10 ARGF.readbyte #=> end of file reached (EOFError) انظر أيضًا التابع getbyte: ...

تجمِّع الدالة foldIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): R (source) وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...

تجمِّع الدالة foldRightIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. البنية العامة inline fun <R> CharSequence.foldRightIndexed( initial: R, operation: (index: Int, Char, acc: R) -> R ): R وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات initial قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول ...

يقرأ التابع readchar المحرف التالي من المجرى ARGF ثم يعيده على شكل سلسلة نصية. يُطلِق التابع الخطأ EOFError بعد قراءة المحرف الأخير من الملف الأخير. البنية العامة readchar → String or nil القيمة المعادة تعاد سلسلة نصية تحوي المحرف الذي قُرِأ من المجرى ARGF أمثلة مثال لاستخدام التابع readchar: $ echo "foo" > file $ ruby argf.rb file ARGF.readchar #=> "f" ARGF.readchar #=> "o" ARGF.readchar #=> "o" ARGF.readchar #=> "\n" ARGF.readchar #=> end of file reached (EOFError) انظر أيضًا التابع read: ...

ينشئ التابع new كائنًا جديدًا من النوع IO انطلاقًا من واصف الملف (file descriptor) ووضع الفتح الممرَّرين إليه. يُستدعَى التابع new عبر العديد من توابع الفتح الخاصة بالصنفين File و IO، مثل open و Kernel.open و File.open. البنية العامة new(fd [, mode] [, opt])→ io‎ المعاملات fd‎ واصف الملف المراد فتحه. mode‎ وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف fd. وضع الفتح (Open Mode) إن كان المعامل mode عددًا صحيحًا، فيجب أن يكون مزيجًا من الأوضاع المعرفة ...

يتحقق التابع symlink?‎ إن كان ملفٌ ما وصلةً رمزيةً. البنية العامة symlink?(file_name) → true or false المعاملات file_name اسم الملف الذي سيُتحقَّق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما وصلةً رمزيةً. خلا ذلك، تعاد القيمة false. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع symlink: ينشئ وصلةً رمزيةً باسم محدَّد لملف معيَّن موجود. التابع socket?‎: يتحقق إن كان ملفٌ ما مقبسًا. التابع sticky?‎: يتحقق إن كان ملفٌ ما قد ضُبِط فيه البت ...

يجعل Active Storage عملية رفع الملفات وإنشاء مرجع لها في أي خدمة سحابية - مثل Amazon S3، أو Google Cloud Storage، أو Microsoft Azure Storage - وربطها بنماذج Active Record عمليةً بسيطةً وسهلةً. يدعم أيضًا امتلاك خدمة تخزين أساسية في خدمة سحابية، وخدمة تخزين انعكاسية (mirror) في خدمات سحابية أخرى وذلك من أجل تحقيق التوافر الدائم. أضف إلى ذلك أنه يوفر خدمة التخزين على قرص صلب (disk service) للفحص أو النشر المحلي ولكن التركيز الأساسي ينصب على التخزين السحابي. يمكن ...

يوقف التابع stop تنفيذ المهمة الفرعية الحالية، ويضعها في حالة "نوم" (sleep)، ويُجدوٍل (schedules) تنفيذ مهمة فرعية أخرى. البنية العامة stop→ nil‎ القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع stop‎: a = Thread.new { print "a"; Thread.stop; print "c" } sleep 0.1 while a.status!='sleep' print "b" a.run a.join #=> "abc"‎ انظر أيضًا التابع start: يشبه التابع new بشكل أساسي إلا أنه عند اشتقاق صنف فرعي (subclassed) من Thread، فإنَّ استدعاء start في ذلك الصنف الفرعي لن يستدعي تابع الصنف الفرعي initialize. مصادر قسم التابع ...

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

يتحقق التابع size?‎ إن كان ملفٌ ما غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size?(file_name) → Integer or nil المعاملات file_name اسم الملف المراد التحقق من حجمه. القيمة المعادة تعاد القيمة nil إن كان الملف file_name غير موجود أو كان معدوم الحجم. خلا ذلك، يعاد عدد صحيح يمثِّل حجم ذلك الملف. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع exist?‎: يتحقق إن كان ملفٌ ما ...

يتحقق التابع socket?‎ إن كان ملفٌ ما مقبسًا. البنية العامة socket?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name مقبسًا. خلا ذلك، تعاد القيمة false. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. التابع setgid?‎: ...

يتحقق التابع setuid?‎ إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف المحدَّد. البنية العامة setuid?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف المحدَّد. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع exist?‎: يتحقق إن كان ملفٌ ما موجودًا. التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع setgid?‎: يتحقق إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف ...

يعدُّ التابع exists?‎ مهملًا. لا تستخدمه رجاءً. البنية العامة exists?(file_name) → true or false انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع exist?‎: ...

ينشئ التابع mkdir مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا. يمكن تعديل الأذونات بواسطة File::umask، ويتم تجاهلها في NT. إن لم يكن بالإمكان إنشاء المجلد، فسيُطلق الخطأ SystemCallError. راجع أيضًا مناقشة الأذونات في توثيق الصنف File. البنية العامة mkdir( string [, integer] ) → 0 المعاملات string  اسم المجلد الجديد المراد إنشاؤه. integer أذونات المجلد الجديد المراد إنشاؤه. أمثلة مثال عن استخدام التابع mkdir: Dir.mkdir(File.join(Dir.home, ".foo"), 0700) #=> 0 انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي ...

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

يغلق التابع close الملف الحالي ويتخطاه إلى الملف التالي في ARGV. إن لم تتبقَ ملفات أخرى لفتحها، فسيكتفي التابع بإغلاق الملف الحالي. انتبه إلى أنَّ مجرى الدخل القياسي (STDIN) لن يُغلَق أبدًا. البنية العامة close → ARGF أمثلة مثال على استخدام التابع close: $ ruby argf.rb foo bar ARGF.filename #=> "foo" ARGF.close ARGF.filename #=> "bar" ARGF.close انظر أيضًا التابع close?‎: يتحقق‎ إن أُغلِق الملف الحالي أم لا. التابع eof?‎: يتحقق إذا بلغ الملف الحالي نهايته في ARGF. التابع file: يعيد الملف الحالي ...

يُعيد التابع stat معلومات حالة المجرى الذي استُدعي معه على هيئة كائن من النوع File::Stat. البنية العامة stat → stat‎ القيمة المعادة يعاد كائن File::Stat يصف حالة المجرى المعطى. أمثلة مثال على استخدام التابع stat‎: f = File.new("testfile") s = f.stat "%o" % s.mode #=> "100644" s.blksize #=> 4096 s.atime #=> Wed Apr 09 08:53:54 CDT 2003‎ انظر أيضًا التابع inspect: يُعيد سلسلة نصية تصف المجرى الذي استُدعي معه. ...