نتائج البحث

ينفِّذ التابع instance_exec الكتلة البرمجية المُمرَّرة ضمن سياق الكائن المستقبل (obj). لتعيين السياق، يُضبَط المتغير self إلى obj أثناء تنفيذ الشيفرة، مما يعطي الشيفرة إمكانية الوصول لمتغيرات النسخة obj. البنية العامة instance_exec(arg...) {|var...| block } → obj المعاملات arg الوسائط المراد تمريرها كمعاملات إلى الكتلة block. القيم المعادة يعاد كائن يحوي ناتج تنفيذ الكتلة البرمجية block. أمثلة مثال على استخدام التابع instance_exec: class KlassWithSecret def initialize @secret = 99 end end k = KlassWithSecret.new k.instance_exec(5) {|x| @secret+x } #=> ...

يغيِّر التابع chmod بتات الأذونات لملف أو عدة ملفات محدَّدة. تعتمد التأثيرات الفعلية لاستدعاء هذا التابع على المنصة المستعملة (راجع شرح بتات الأذونات في بداية شرح الصنف File). في الأنظمة الشبيهة بيونكس، اطلع على الدالة chmod(2)‎ لمزيد من التفاصيل. البنية العامة chmod(mode_int, file_name, ... ) → integer المعاملات mode_int نمط الأذونات الجديدة المراد تعيينها إلى الملفات المحدَّدة. file_name اسم الملف المراد تغيير أذوناته. ... أسماء الملفات الأخرى المراد تغيير أذوناتها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي غُيِّرت أذوناتها. ...

يفسّر التابع الإعدادات من سلسلة نصية. ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون. البنية العامة read_string(string, source='<string>') المعاملات ‎string السلسلة النصية المراد تفسير الإعدادات فيها. source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للسلسلة النصية الممرّرة. تُستخدم القيمة '<string>' في حال عدم استخدام هذا المعامل. عادة ما تكون قيمة هذا المعامل مسارًا في ملفات النظام أو عنوان URL. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> sample_config = """ ... [mysqld] ... user = mysql ... ...

الخاصية text-decoration في CSS تُحدِّد علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر باستثناء الفراغات ومحارف التحكم (control chars، مثل محرف السطر الجديد، ومحرف العودة إلى بداية السطر)؛ وهي خاصيةٌ مختصرة لضبط قيمة أكثر من خاصية عن ضبط علامات التوكيد معًا، وهي تتضمن text-emphasis-style و text-emphasis-color. بطاقة الخاصية القيمة الابتدائية لكل قيمة مختصرة: text-emphasis-style: none text-emphasis-color: currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا، باستثناء قيمة الخاصية text-emphasis-color. الوسائط مرئية القيمة المحسوبة لكل قيمة مختصرة: text-emphasis-style: كما حُدِّدَت. ...

يجلب التابع getc المحرف التالي من المجرى ARGF. يعامل المجرى ARGF الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع getc مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا. البنية العامة getc → String or nil القيم المعادة تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى ARGF، أو تعاد القيمة ...

تحذف الدّالة delattr()‎ الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name) المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A: ... def __init__(self, a=1, b=2): ... ...

يُعيد التابع to_s سلسلةً نصيةً تُمثِّل الكائن الذي استدعي معه. يطبع التابع افتراضيًا صنفَ الكائن وترميز معرِّفه.في حالات خاصة، يُعيد كائنٌ ذو المستوى الأعلى الذي يشكل سياق التنفيذ الأولي (initial execution context) لبرامج روبي السلسلة النصية "main". البنية العامة to_s → string القيم المعادة تُعاد سلسلةٌ نصيةٌ تحتوي صنف ورمز معرِّف الكائن المعطى. أو تُعاد، في حالاتٍ خاصة، السلسلة النصية "main" من قبل كائن ذي المستوى الأعلى الذي يشكل سياق التنفيذ الداخلي لبرامج روبي. انظر أيضًا التابع itself: يُعيد الكائن ...

يَحذِف التابع 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 #=> ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تقرأ الدالة file_get_contents()‎ الملف ثمَّ تضع كلَّ محتوياته في سلسلة نصيَّة. الوصف string file_get_contents ( string $filename [, bool $use_include_path= FALSE [, resource $context [, int $offset = 0 [, int $maxlen ]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة file()‎ باستثناء أنَّها تعيد محتوى الملف في سلسلة نصيَّة. يبدأ ذلك المحتوى عند الموقع offset ويكون بطول maxlen بايت. تعيد هذه الدالة عندما تفشل القيمة FALSE. تعدُّ الدالة file_get_contents()‎ وسيلة مفضَّلة لقراءة ...

يمكن الوصول إلى البيانات المرسلة إلى المخدّم عن طريق الصنف FieldStorage، وإن كان النموذج يتضمّن حروفًا بترميز غير ترميز ASCII فيمكن استخدام المعامل المفتاحي encoding لتعيين قيمة الترميز المستخدم في الملف الحاوي على النموذج، ويمكن الوصول إلى الترميز المستخدم عادة في الوسم META في قسم HEAD من ملف HTML أو عن طريق الترويسة Content-Type). يقرأ الصنف محتويات النموذج من المدخلات القياسية أو من البيئة (بالاعتماد على قيمة عدد من متغيرات البيئة والمعيّنة حسب معايير CGI). قد يستهلك الصنف المدخلات القياسية؛ ...

يقرأ التابع read عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه عندما يُستدعى التابع read في نهاية الملف، فسيعيد إما nil أو ""، بناءً على الطول المُمرَّر إليه، مثلا، ستعيد التعبيرات read و read(nil)‎ و read(0)‎ القيمة ""، فيما سيعيد التعبير read( positive_integer )‎ القيمة nil. لاحظ أنَّ هذا التابع يتصرف بطريقة مشابهة للدالة fread()‎ في لغة C. وهذا يعني أنَّه سيحاول إجراء استدعاءات النظام read(2)‎ لقراءة البيانات بالطول المحدَّد (أو حتى يصادف محرف نهاية الملف EOF). يستمر هذا السلوك ...

الاستقرار: 2 - مستقر توفِّر الوحدة fs‎ واجهةً برمجيةً للتعامل مع نظام الملفات بطريقة قريبة جدًا من دوال POSIX القياسية. يمكن الوصول إلى هذه الوحدة باستعمال الأمر التالي: const fs = require('fs'); جميع عمليات نظام الملفات لها أشكال متزامنة وغير متزامنة. تأخذ الأشكال المتزامنة دالة رد نداء مكملة دومًا وتُمرَّر إليها كآخر وسيط. تعتمد الوسائط المُمرَّرة إلى دالة رد النداء المكملة تلك على التابع نفسه، ولكن الوسيط الأول فيها محجوزٌ دومًا للاستثناء. إن اكتملت العملية بنجاح، فستكون قيمة هذا الوسيط null‎ ...

تجري الوحدة FileTest عمليات تحقق على الملف بشكل مشابه لتلك الموجودة في الوحدة File::Stat. هذه الوحدة موجودة على أنَّها وحدةٌ مستقلةٌ، وتوبعها تُعدُّ مرجعًا إلى الصنف File. (انتبه إلى أنَّ هذا لا ينفَّذ عبر التضمين [inclusion]، إذ هي إحدى خدع المفسِّر.) توابع النسخة العامة blockdev?‎ يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). chardev?‎ يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). directory?‎ يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. executable?‎ ...

يأخذ التابع new سلسلة نصية تحوي شيفرات برمجية بلغة روبي، ويُصرّفها (compile) إلى كائن من النوع InstructionSequence. البنية العامة new(source[, file[, path[, line[, options]]]]) → iseq‎ اختياريًّا، يأخذ التابع new المعاملات file و path و line التي تمثل اسم الملف، والمسار المطلق، ورقم السطر الأول لشيفرة روبي الموجودة في المصدر source؛ هذه المعاملات تمثل بيانات وصفية (metadata) مُرتبطة بالكائن iseq المعاد. يُستخدَم المعامل options، الذي يمكن أن تكون قيمته true أو false أو جدول Hash، لتعديل السلوك الافتراضي لمصرف iseq روبي. لمزيد من ...

يُستدعَى التابع const_missing عند محاولة استخدام ثابت غير مُعرَّف في الوحدة. المعامل الوحيد المُمرَّر إليه يمثل الثابت غير المعرفة. ويعيد التابع قيمة ليتم استخدامها بدل ذلك الثابت كما يوضح المثال التالي: def Foo.const_missing(name) name # يعاد اسم الثابت كرمز end Foo::UNDEFINED_CONST #=> :UNDEFINED_CONST: أعيد الرمز البنية العامة const_missing(sym) → obj‎ المعاملات sym‎ رمز يمثل الثابتة. القيمة المعادة تعاد قيمةٌ ليتم استخدامها بدل الثابت. أمثلة في المثال التالي، عند محاولة الدخول إلى ثابت غير معرَّف، سيحاول التابع const_missing تحميل ملفٍ اسمه ...

يُعيد التّابع default_internal:: قيمة التّرميز الداخلي الافتراضية. يُغيَّر ترميز السّلاسل النصّية في الحالات التّالية إذا لم تكن قيمة التّرميز الداخلي الافتراضية مضبوطةً إلى القيمة nil: الملفات ذات الصيغة CSV. التابع Etc.systmpdir و التابع Etc.sysconfdir. بيانات الصنف File المقروءة من القرص. أسماء الملفات الموجودة في الصنف File المقروءة من مجرى أحد المجلدات Dir. التابع Integer.chr. التابع Regexp.inspect والتابع String.inspect. السلاسل النصية المعادة أثناء قراءة الأسطر. السلاسل المعادة من الصنف SBDM. التابع Time.zone. القيم المعادة من الصنف ENV. القيم التابعة للصنف ARGV ...

يعين التابع close_on_exec عند استدعائه بالشكل close_on_exec = bool قيمة الراية close-on-exec إلى القيمة bool المنطقية. تعيّن روبي الرايات close-on-exec لكل واصفات الملفات (file descriptors) افتراضيًا منذ الإصدار 2.0.0. لذلك، لا تحتاج إلى تعيينها بنفسك. أضف إلى ذلك أنَّه قد يؤدي عدم ضبط الراية close-on-exec إلى حدوث تسرب لواصف الملف إن استخدمت مهمة فرعية أخرى التابعين ‎fork()‎ و exec()‎ (عبر التابع system()‎ على سبيل المثال). إن كنت بحاجة إلى توريث واصف الملفات في عملية فرعية (child process)، فاستخدم وسيط التابع spawn()‎ ...

يضبط التابع abort_on_exception عند استدعائه بالشكل abort_on_exception= boolean حالة الشرط العام "المقاطعة عند حدوث استثناء؟" (abort on exception) إلى القيمة المنطقية boolean. عندما تكون القيمة المنطقية هي true، إذا تم إيقاف هذه المهمة الفرعية بواسطة استثناء، فسيطلق ذلك الاستثناء مجددًا في المهمة الفرعية الرئيسية. وستعاد الحالة الجديدة. يوجد أيضًا تابع نسخة (instance method) لتعيين هذا الخيار لمهمة فرعية معينة، راجع الصفحة abort_on_exception=‎. البنية العامة abort_on_exception= boolean→ true or false‎ القيمة المعادة تعاد القيمة المنطقية boolean بعد ضبطها للشرط العام "المقاطعة ...

تفتح الدّالة open()‎ ملفّا وتعيد كائن ملفّ (file object) مرتبط به. إن لم يُمكِن فتح الملفّ، فسيُطلَق الاستثناء OSError‎. البنية العامة open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) المعاملات file كائن مُشابه للمسارات (path-like object) يُمثّل مسار الملفّ (سواء أكان مُطلقا أو نسبيًّا) المرغوب فتحه. يُمكن كذلك أن يكون واصف ملفّ عدديّ (integer file descriptor) للملفّ لتغطيّته (wrap). إن مُرّر واصف ملفّات، فسيُغلَق عندما يُغلَق كائن I/O المُعاد، إلّا في حالة كانت قيمة المُعامل closefd تساوي False. mode مُعامل ...

يكتب التابع صفًّا مع أسماء الحقول (كما هو محدّد في الدالة البانية). ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة writeheader() ‎مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

التابع Path.mkdir في بايثون يُنشئ هذا التابع مجلّدًا في المسار المُعطى بالخصائص التي يتم تحديدها في باقي الوسطاء. Create a new directory at this given path. If mode is given, it is combined with the process’ umask value to determine the file mode and access flags. If the path already exists, FileExistsError is raised. If parents is true, any missing parents of this path are created as needed; they are created with the default permissions without taking mode into account ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

يرتِّب التابع sort_by عناصر الكائن القابل للتعداد الذي استدعي معه باستعمال مجموعة من المفاتيح المولدة عبر تمرير قيم العناصر إلى الكتلة المعطاة. لا يُضمَن بأن تكون النتيجة مستقرة. عندما تعيد عملية الموازنة بين مفتاحين القيمة 0، إذ لن يُتوقَع كيفية ترتيب هذين العنصرين ومن منهما سيسبق الآخر. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة sort_by { |obj| block } → array sort_by → an_enumerator التنفيذ الحالي للتابع sort_by يولد مصفوفةً من الصفوف (tuples) تحوي مجموعة العناصر الأصلية ...

القيمة المحسوبة (computed value) لإحدى خاصيات CSS تُحسَب من القيمة المُحدَّدة كما يلي: التعامل مع القيم الخاصة inherit و initial. إجراء الحسابات اللازمة للوصول إلى القيمة الموصوفة في الجدول الموجود في صفحة الخاصيات بعنوان «القيمة المحسوبة» (والمأخوذ من المواصفة). العمليات الحسابية المطلوبة للوصول إلى القيمة المحسوبة للخاصية قد تتضمن تحويل الواحدات النسبية (مثل em أو النسبة المئوية <percentage>) إلى أطوال مطلقة. على سبيل المثال، إذا كان للعنصر القيمة 16px للخاصية font-size، والقيمة 2em للخاصية padding-top، فإنَّ القيمة المحسوبة للخاصية padding-top ...

الخاصية orphans في CSS تُحدِّد العدد الأدنى للأسطر النصية الموجودة في حاوية كتلية التي يجب أن تظهر في أسفل الصفحة أو العمود. بطاقة الخاصية القيمة الابتدائية 2 تُطبَّق على جميع الحاويات الكتلية (block containers). قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. في التنسيق الطباعي، تكون اليتامى (orphans) هي أول سطر من الفقرة الذي يظهر بمفرده في أسفل الصفحة أو العمود. /* <integer> أعداد صحيحة */ orphans: 2; orphans: 3; /* القيم العامة */ orphans: inherit; orphans: initial; orphans: unset; دعم المتصفحات الميزة Chrome ...

مقدمة تعليمات الشرطات المائلة الثلاث (Triple-slash directives) هي تعليقات تكتب في سطر واحد تحتوي على وسم XML واحد. تُستخدَم محتويات التعليق كتعليمات (إرشادات) للمترجم. تكون تعليمات الشرطات المائلة الثلاث صالحةً فقط في أعلى الملفّ الذي تكون هذه التعليمات موجودة داخله. ويُمكن لهذه التعليمات أن تُسبَق فقط بتعليق في سطر واحد أو تعليق متعدّد الأسطر (multi-line comment)، ما يشمل تعليمات شرطات مائلة ثلاث أخرى. إذا وُجِدَت بعد جملة أو تصريح فستُعامَل على أنها تعليقات عادية في سطر واحد (regular single-line comments)، ...

الخاصية transform-style في CSS تُحدِّد إن كانت العناصر الأبناء للعنصر الحالي موجودة في الفضاء ثلاثي الأبعاد أو كانت مسطحةً (flattened) في مستوى العنصر الأب؛ وإذا كانت مسطحةً فهذا يعني أنها لن تكون موجودة في فضاءٍ ثلاثي الأبعاد خاصٍ بها. بطاقة الخاصية القيمة الابتدائية flat تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ transform-style: preserve-3d; transform-style: flat; /* القيم العامة */ transform-style: inherit; transform-style: initial; transform-style: unset; دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم ...

ملاحظة قبل البدء: تختلف هذه التقنية عن تقنية تغليف الحقول (Encapsulate Field) من حيث أنّها تُستخدَم لتغليف الحقول الخاصّة (أي المُحدَّدة بالكلمة المفتاحيّة private). المشكلة الوصول المباشر إلى الحقول الخاصّة (private fields) داخل الصنف (class). الحل إنشاء تابعي الوصول getter و setter للحقل الخاصّ ومنع الوصول إليه إلا عبرهما. مثال قبل إعادة التصميم يحتوي الصنف Range على الحقلين low و high من النوع الخاص (private) ونلاحظ الوصول إليهما مباشرةً داخل التابع includes في الشيفرة الآتية: في لغة Java: class Range ...

يُعيِّن التابع 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 الرمزُ المراد جلب قيمته في ...

الخاصية widows في CSS تُحدِّد العدد الأدنى للأسطر النصية الموجودة في حاوية كتلية التي يجب أن تظهر في أعلى الصفحة أو العمود. بطاقة الخاصية القيمة الابتدائية 2 تُطبَّق على جميع الحاويات الكتلية (block containers). قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. في التنسيق الطباعي، تكون الأرامل (widows) هي آخر سطر من الفقرة الذي يظهر بمفرده في أعلى الصفحة أو العمود. /* <integer> أعداد صحيحة */ widows: 2; widows: 3; /* القيم العامة */ widows: inherit; widows: initial; widows: unset; دعم المتصفحات الميزة Chrome ...

هذا التابع مشابه للتابع dict.update()‎ ولكنّه يضيف التعدادات بدلًا من استبدالها. البنية العامة c.update([iterable-or-mapping]) المعاملات iterable أو mapping الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُضاف منه العناصر. n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة عند استخدام هذا التابع يجري حساب العناصر من كائن مكرِّر أو تضاف من كائن ربط آخر ...

يشبه التابع bytes.rfind()‎ في أنّه يحدّد أعلى قيمة للفهرس تجد فيه التسلسل الفرعي ضمن التسلسل الأصلي، ويختلف عنه في أنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي. البنية العامة str.rindex(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه. يمكن أن يكون هذا المعامل أي كائن شبيه بالبايتات (bytes-like object) أو عددًا صحيحًا يبدأ من 0 وينتهي بالعدد 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن التسلسل الأصلي. end الموقع الذي ينهي فيه التابع عملية البحث ...

يشبه التابع bytes.rfind()‎ في أنّه يحدّد أعلى قيمة للفهرس تجد فيه التسلسل الفرعي ضمن التسلسل الأصلي، ويختلف عنه في أنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي. البنية العامة str.rindex(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه. يمكن أن يكون هذا المعامل أي كائن شبيه بالبايتات (bytes-like object) أو عددًا صحيحًا يبدأ من 0 وينتهي بالعدد 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن التسلسل الأصلي. end الموقع الذي ينهي فيه التابع عملية البحث ...

يحلّل التابع النموذج النصي المعطى (والذي يُفترض أن يكون بصيغة CSV) ويعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. البنية العامة has_header(sample) القيمة المعادة يعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يعيد التابع size حجم الملف المحدَّد. البنية العامة size(file_name) → integer المعاملات file_name اسم الملف المراد معرفة حجمه. القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف file_name. انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

يعيد التابع size حجم الملف الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف المعطى. أمثلة مثال على استعمال التابع size: File.new("testfile").size #=> 66 انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo. البنية العامة TarInfo.tobuf(format=DEFAULT_FORMAT, encoding=ENCODING, errors='surrogateescape') ‎المعاملات ‎لمزيد من المعلومات حول معاملات هذا التابع راجع الدالة البانية للصنف TarFile. ملاحظة: في الإصدار 3.2 من بايثون تستخدم القيمة 'surrogateescape' كقيمة افتراضية للمعامل errors. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

يغلق التابع كائن TarFile. في وضع الكتابة، يلحق التابع بالأرشيف كتلتين من أصفار الإنهاء finishing zero block. البنية العامة TarFile.close() ‎أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'w') >>> tar.close() انظر أيضًا التابع TarFile.open()‎: دالة بانية بديلة لكائنات TarFile. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

معظم أخطاء الأنواع تنحدر من الصنف StandardError؛ ستُعالج الكتلة rescue التي لا تحدد الصنف Exception بشكل صريح كل الأخطاء StandardError (دون غيرها). def foo raise "Oups" end foo rescue "Hello" #=> "Hello" الشيفرة التالية: require 'does/not/exist' rescue "Hi" ستطلق استثناء بالشكل التالي: LoadError: no such file to load -- does/not/exist مصادر صفحة الصنف StandardError في توثيق روبي الرسمي.

توفر هذه الوحدة آلية محمولة لاستخدام الوظائف والأدوات التي تعتمد على نوع نظام التشغيل. ‎‎>>> import os >>> os.getcwd() '/home/username' ملاحظات تستخدم وظائِف جميع الوحدات المبنيّة في بايثون، والمعتمدة على نوع نظام التشغيل، في جميع الأنظمة المتوافرة فيها نفس الواجهة (interface). فعلى سبيل المثال، تُعيد الدالة os.stat(path)‎‎ معلومات حول المسار المُدخَل بنفس التنسيق على جميع الأنظمة التي تتوافر فيها الدالة (الواجهة المُستخدمة هنا مماثلة لتلك المُستخدمة في واجهة POSIX). تتوفر أيضًا إمكانيّة إضافة إضافات خاصة لنظام تشغيل مُعين عبر الوحدة os، ولكن ...

يوسّع التابع glob الوسيطَ pattern الممرّر (انظر فقرة البنية العامة)، الذي هو سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المُطابقة لذلك النمط. في حال تم إعطاء كتلة (block)، فسيستدعي التابع glob الكتلة مرة واحدة على كل اسم ملف مطابق، إذ سيمرّر اسم الملف كوسيط إلى الكتلة. يحدِّد الوسيط base الاختياري المجلد الأساسي (base directory) لتفسير أسماء المسارات النسبية بدلاً من مجلد العمل الحالي. وبما أنّ النتائج لا تكون مسبوقة باسم المجلد ...

تعيد الدّالة iter()‎ مُكرّرًا حسب المُعاملات المُعطاة. البنية العامة iter(object[, sentinel]) المعاملات object إن لم يكن المُعامل الثّاني sentinel حاضرًا، فلا بدّ لهذا المُعامل أن يكون كائنًا يدعم بروتوكول التّكرار (أي أنّ صنفه يُعرّف التّابع الخاصّ ‎_‎_‎iter‎_‎_‎(‎)‎)، أو يجب أن يدعم بروتوكول التّسلسلات (sequence protocol) الذي يُعرّف صنفه التّابع الخاصّ ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات تكون أعدادًا صحيحةً وتبدأ من الصّفر. وإن لم يدعم الكائن أيًّا من هذين البروتوكولين، فسيُطلق الاستثناء TypeError. sentinel مُعامل اختيّاريّ. إن مُرّرت قيمة لهذا المُعامل، فلا بدّ ...

يفتح التابع write ملفًا محدَّدًا ويكتب فيه السلسلة النصية المُمرَّرة إليه ثم يغلقه ويعيد عدد البايتات التي كتبها. يضمن التابع write أن يُغلق الملف قبل إعادة أية قيمة. إن كان المعامل الأخير عبارة عن جدول Hash، فسيحدد الخيارات الداخلية للتابع open()‎. البنية العامة write(name, string [, offset]) → integer write(name, string [, offset] [, opt])→ integer‎ المعاملات name‎ اسم الملف المراد كتابة السلسلة النصية string فيه. string‎ سلسلة نصية يراد كتابتها ضمن الملف. offset‎ عدد صحيح يمثل إزاحة موضع المؤشر في ...

يمكن استخدام Sass بثلاث طرائق هي: كأداة سطر أوامر، أو كوحدةٍ مستقلة لروبي، أو كمُلحقة في أيّ بيئة عمل تدعم Rack، بما في ذلك Ruby on Rails و Merb. تثبيت Sass الخطوة الأولى لاستخدام Sass هي تثبيت الجوهرة (gem)‏ Sass: gem install sass إن كنت تستخدم نظام ويندوز، فقد تحتاج إلى تثبيت روبي أولاً. لتشغيل Sass من سطر الأوامر، يكفي أن تكتب الأمر الآتي: sass input.scss output.css يمكنك أيضًا إخبار Sass بمراقبة الملف وتحديث ملف CSS الناتج عند كلِّ تغيُّرٍ في ملف ...

يعيد التابع inspect سلسلة نصية تصف الكائن Dir الذي استُدعي معه. البنية العامة inspect → string القيم المعادة تُعاد سلسلة نصية تصف الكائن Dir الذي استُدعي معه. انظر أيضًا التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن Dir الذي استُدعي معه. مصادر قسم التابع inspect في الصنف Dir في توثيق روبي الرسمي.

تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. البنية العامة TarInfo.fromtarfile(tarfile) المعاملات tarfile كائن TarFile. القيمة المعادة يعيد التابع كائن TarInfo. انظر أيضًا التابع TarInfo.frombuf()‎: تابع صنف ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

يتوافر العديد من خيارات سطر الأوامر التي يمكن استعمالها مع Node.js. تُستعمَل هذه الخيارات في تنقيح أخطاء الشيفرة، والتحكم في كيفيَّة تنفيذ الشيفرة، وغيرها من الأمور المفيدة. يمكن عرض هذا التوثيق في الطرفيَّة عبر استعمال الأمر man node. البنية العامة node [options] [V8 options] [script.js | -e "script" | -] [--] [arguments] node debug [script.js | -e "script" | <host>:<port>] … node --v8-options إنَّ تنفيذ node دون أيَّة وسائط يؤدي إلى بدئها مع الوحدة REPL. لمزيدٍ من المعلومات حول node debug، راجع رجاءً ...

يُعيد التابع inspect سلسلة نصية تصف المجرى الذي استُدعي معه. البنية العامة inspect→ string‎ القيمة المعادة تعاد سلسلة نصية تصف المجرى المعطى. انظر أيضًا التابع fcntl: يوفر آلية لإصدار أوامر منخفضة المستوى للتحكم في أو الاستعلام عن مجاري د/خالموجهة بالملفات (file-oriented I/O). التابع gets: يجلب السطر التالي من المجرى الذي استدعي معه.  مصادر قسم التابع inspect‎ في الصنف IO‎ في توثيق روبي الرسمي.

تعيد الدالة الحجم الأقصى للحقل والذي يسمح المحلّل parser باستخدامه. البنية العامة csv.field_size_limit([new_limit]) المعاملات new_limit معامل اختياري يحدّد الحجم الجديد. القيمة المعادة تعيد الدالة الحجم الأقصى للحقل والذي يسمح المحلّل parser باستخدامه. أمثلة يبين المثال التالي آلية عمل الدالّة: >>> csv.field_size_limit() 131072 >>> csv.field_size_limit(160000) 131072 >>> csv.field_size_limit() 160000 مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز محرفي. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف File في توثيق روبي الرسمي.

يٌطلَق الخطأ EOFError من طرف بعض عمليات الصنف IO عندما تصل إلى نهاية الملف. تنقسم أغلب توابع الصنف IO -فيما يتعلق بالوصول إلى نهاية الملف- إلى قسمين: الأول يعيد القيمة nil عند الوصول إلى نهاية الملف، والآخر يطلق الخطأ EOFError عند الوصول إلى نهاية الملف. الصنف EOFError هو صنف فرعي من الصنف IOError. file = File.open("/etc/hosts") file.read file.gets #=> nil file.readline #=> EOFError: الوصول إلى نهاية الملف مصادر الصنف EOFError في توثيق روبي الرسمي.

تتحقق الدالة ممّا إذا كان بمقدور الوحدة tarfile قراءة ملف الأرشيف المعطى. البنية العامة tarfile.is_tarfile(name) ‎المعاملات ‎ name أرشيف tar الذي ستتحقّق الدالة من إمكانية فتحه بواسطة الوحدة tarfile. القيمة المعادة تعيد الدالة القيمة True إن كانت قيمة name هي ملف أرشيف من نوع tar يمكن للوحدة tarfile أن تقرأه، وتعيد القيمة False فيما عدا ذلك. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. البنية العامة gzip.decompress(data) المعاملات ‎data البيانات المراد ضغطها. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات غير المضغوطة. انظر أيضًا الدالة gzip.compress()‎: تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. مصادر صفحة Support for gzip files في توثيق بايثون الرسمي.

الخاصية empty-cells في CSS تُحدِّد كيف يجب أن يعرض المتصفح خلفية وإطار خلايا الجداول <table> التي ليس فيها محتوى ظاهر. لن يكون لهذه الخاصية أثرٌ إلا إذا كانت الخاصية border-collapse مضبوطةً إلى separate. بطاقة الخاصية القيمة الابتدائية show تُطبَّق على خلايا الجداول. قابلة للوراثة نعم قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ empty-cells: show; empty-cells: hide; /* القيم العامة */ empty-cells: inherit; empty-cells: initial; empty-cells: unset; أمثلة سنستخدم في المثال الآتي جدولين <table> فيهما خلايا ليس فيها محتوى، واستعملنا القيمة show ...

تُغلِّف كائنات الصنف 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 ...

الخاصية animation-play-state في CSS تُحدِّد إذا كانت الحركة تعمل أو متوقفة مؤقتًا، ويمكن الحصول على قيمة هذه الخاصية عبر JavaScript لمعرفة حالة الحركة، ويمكن أيضًا استعمال JavaScript لضبط قيمتها لتوقيف الحركة مؤقتًا أو استئنافها. بطاقة الخاصية القيمة الابتدائية running تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* قيمة واحدة */ animation-play-state: running; animation-play-state: paused; /* عدِّة قيم */ animation-play-state: paused, running, running; /* القيم العامة */ animation-play-state: inherit; animation-play-state: initial; animation-play-state: unset; استئناف الحركات المتوقفة مؤقتًا سيسمح بإكمالها من مكان توقفها، بدلًا ...

الخاصية line-break في CSS تُحدِّد سلوك المتصفح في الانتقال إلى سطرٍ جديد عند التعامل مع علامات الترقيم والرموز. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. لاحظ أنَّ هذه الخاصية ما تزال غير مدعومة دعمًا جيدًا في المتصفحات، راجع قسم «دعم المتصفحات» لمزيدٍ من المعلومات. /* كلمات محجوزة */ line-break: auto; line-break: loose; line-break: normal; line-break: strict; /* قيم عامة */ line-break: inherit; line-break: initial; line-break: unset; دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم ...

الخاصية outline-color في CSS تضبط لون حدود outline العنصر، التي هي الخطوط التي تُرسَم خارج إطار العنصر border. من المستحسن استخدام الخاصية المختصرة outline عند ضبط مظهر حدود العنصر، لأنها تضبط عدِّة خاصيات في آنٍ واحد. بطاقة الخاصية القيمة الابتدائية currentColor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للحركة نعم القيمة المحسوبة قيمة لونية <color>. /* <color> القيم اللونية */ outline-color: #f92525; outline-color: rgb(30,222,121); outline-color: blue; /* القيم العامة */ outline-color: inherit; outline-color: initial; outline-color: unset; أمثلة سنجعل لون حدود الفقرة <p> الآتية أزرق: <p>لون حدود ...

يُعيد التابع inspect سلسلةً نصيةً تحتوي تمثيلًا  يفهمه البشر للكائن الذي استدعي معه. يُظهر التابع افتراضيًا اسم الصنف، وترميزًا معبِّرًا عن رقم تعريف الكائن، وقائمةً من متغيرات النسخة وقيمها (عبر استدعاء التابع inspect على كلِّ واحدةٍ منها). يجب على الأصناف المعرَّفة من قبل المستخدم أن تُهمِل هذا التابع لتوفر تمثيلًا أفضل للكائن. عند تجاوز هذا التابع، يجب أن تُعاد سلسلةٌ نصيةٌ مرمزةٌ وفقًا للترميز الخارجي الافتراضي. البنية العامة inspect → string القيم المعادة تُعاد سلسلةً نصيةً تمثِّل الكائن المعطى بصيغة ...

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

الخاصية animation-duration في CSS تُحدِّد الزمن اللازم لإكمال دورة كاملة من الحركة. بطاقة الخاصية القيمة الابتدائية 0s تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. من الشائع استخدام الخاصية المختصرة animation لضبط جميع خاصيات الحركات بآنٍ واحد. /* حركة واحدة */ animation-duration: 6s; animation-duration: 120ms; /* عدِّة حركات */ animation-duration: 1.64s, 15.22s; animation-duration: 10s, 35s, 230ms; /* القيم العامة */ animation-name: initial animation-name: inherit animation-name: unset دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي 4.0 (مع السابقة -webkit-) 43.0 5.0 ...

يُعيد التابع fileno عددًا صحيحًا يمثل واصف الملف الرقمي (numeric file descriptor) للمجرى الذي استدعي معه. البنية العامة fileno → integer to_i→ integer‎ القيمة المعادة يعاد عددٌ صحيحٌ يمثل واصف الملف الرقمي للمجرى المعطى. أمثلة مثال على استخدام التابع fileno‎: $stdin.fileno #=> 0 $stdout.fileno #=> 1‎ انظر أيضًا التابع fdatasync: يكتب مباشرةً جميع البيانات المخزنة في مجرى د/خ على القرص. مصادر قسم التابع fileno‎ في الصنف IO‎ في توثيق روبي الرسمي.

يُطلق الاستثناء IOError عند فشل عملية إدخال/إخراج (IO operation) في روبي. File.open("/etc/hosts") {|f| f << "example"} #=> IOError: not opened for writing File.open("/etc/hosts") {|f| f.close; f.read } #=> IOError: closed stream تذكر أنَّ فشل بعض عمليات الإدخال/الإخراج قد يؤدي إلى إطلاق الاستثناء SystemCallError، وهذا الاستثناء ليس متفرع من الصنف IOError. File.open("does/not/exist") #=> Errno::ENOENT: No such file or directory - does/not/exist مصادر صفحة الصنف IOError في توثيق روبي الرسمي.

يعيد التابع السطر التالي في كائن المكرّر iterable object الخاص بكائن القراءة. البنية العامة csvreader.__next__() القيمة المعادة يعيد التابع السطر التالي في كائن المكرّر الخاص بكائن القراءة على هيئة قائمة (إن كان الكائن معادًا من الدالة reader()‎) أو قاموس (إن كان الكائن نسخة من الصنف DictReader) وتكون القيمة المعادة مفسّرة بحسب اللهجة المستخدمة. يُستدعى هذا التابع عادة بهذه الطريقة next(reader)‎. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

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

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

يستخدم هذا الصنف لتخمين الصيغة المستخدمة في ملف CSV. توابع الصنف Sniffer التابع Sniffer.sniff()‎ يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. التابع Sniffer.has_header()‎ يتحقق التابع من كون السطر الأول في ملف csv عبارة عن سلسلة من ترويسات الأعمدة. انظر أيضًا الوحدة csv في بايثون: تقدّم وحدة csv عددًا من الأصناف التي تساعد في قراءة البيانات المجدولة وكتابتها بصيغة CSV. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

تعرِض هذه الصفحة أنماط كتابة الشيفرات المُتعارَف عليها (conventions) من قِبل مبرمجي لغة Kotlin. تطبيق دليل التنسيق (Applying the Style Guide) لضبط المُنسِّق IntelliJ formatter بما يتوافق مع هذا الدليل يُنصَح بتثبيت إضافة Kotlin بالإصدار 1.2.20 (أو أي إصدارٍ أحدث) وضبط المّحرِّر بالانتقال إلى الإعدادات (Settings) ثمّ المُحرِّر (Editor) ثم نمط الشيفرة (Code Style) ثم Kotlin واختر "ضبط من..." Set from…"‎" في الزاوية اليمنى العُلويَّة ومن القائمة اختر الخيار Predefined style/Kotlin style guide. وللتأكد من تنسيق الشيفرة وفقًا لدليل Kotlin ...

تعرِض هذه الصفحة أنماط كتابة الشيفرات المُتعارَف عليها (conventions) من قِبل مبرمجي لغة Kotlin. تطبيق دليل التنسيق (Applying the Style Guide) لضبط المُنسِّق IntelliJ formatter بما يتوافق مع هذا الدليل يُنصَح بتثبيت إضافة Kotlin بالإصدار 1.2.20 (أو أي إصدارٍ أحدث) وضبط المّحرِّر بالانتقال إلى الإعدادات (Settings) ثمّ المُحرِّر (Editor) ثم نمط الشيفرة (Code Style) ثم Kotlin واختر "ضبط من..." Set from…"‎" في الزاوية اليمنى العُلويَّة ومن القائمة اختر الخيار Predefined style/Kotlin style guide. وللتأكد من تنسيق الشيفرة وفقًا لدليل Kotlin ...

يقدّم هذا الدليل التقنيات اللازمة لتنقيح تطبيقات ريلز. بعد قراءة هذا الدليل، ستتعلّم: الغرض من التنقيح. كيفة تتبّع العلل والأخطاء التي لا تتعرّف عليها الاختبارات في تطبيقك. طرقًا مختلفة للتنقيح. كيفيّة تحليل أثر المكدس. مساعدي العرض للتنقيح احدى المهام الشائعة في التنقيح هي فحص محتويات متغيّر معيّن، لذا يوفر ريلز ثلاثة طرائق لفعل ذلك: Debug To_yaml Inspect debug سيعيد المساعد debug الوسم <pre> الذي يصدّر الكائن باستخدام تنسيق YAML، وسيؤدي هذا إلى توليد بيانات يمكن للإنسان قراءتها من أي كائن. ...

الخاصية text-decoration-style في CSS تُحدِّد نوع علامة التوكيد (emphasis mark) المستخدمة على كل محرف نصي في العنصر باستثناء الفراغات ومحارف التحكم (control chars، مثل محرف السطر الجديد، ومحرف العودة إلى بداية السطر)؛ يمكن ضبط قيمة هذه الخاصية باستعمال الخاصية المختصرة text-emphasis. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا الوسائط مرئية القيمة المحسوبة كما حُدِّدَت. /* القيمة الابتدائية */ text-emphasis: none; /* <string> سلاسل نصية */ text-emphasis-style: 'x'; text-emphasis-style: '点'; text-emphasis-style: '\25B2'; text-emphasis-style: '*'; text-emphasis-style: 'foo'; /* لا تستخدم هذه القيمة، ...

تعيد الدالة قائمة باللهجات المسجّلة. البنية العامة csv.list_dialects()‎ ‎ القيمة المعادة تعيد الدالة قائمة باللهجات المسجّلة. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import csv >>> csv.list_dialects() ['excel', 'excel-tab', 'unix'] انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.unregister_dialect()‎: تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الصنف Dialect. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يحذف التابع القسم المحدّد من ملف الإعدادات. البنية العامة remove_section(section) ‎المعاملات ‎section القسم المراد حذفه من ملف الإعدادات. القيمة المعادة يعيد التابع القيمة True إن كان القسم موجودًا، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.remove_section('bitbucket.org') True >>> config.remove_section('github.com') False انظر أيضًا التابع remove_option()‎: يحذف التابع الخيار المعطى من القسم المحدّد من ملف الإعدادات. مصادر صفحة Configuration file parser في توثيق بايثون الرسمي.

يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo، وتأخذ القائمة نفس ترتيب الأعضاء في الأرشيف. البنية العامة TarFile.getmembers() ‎القيمة المعادة يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar') >>> tar.getmembers() [<TarInfo 'file1.txt' at 0x7f486610b2a0>, <TarInfo 'file2.html' at 0x7f486610b048>, <TarInfo 'file3.py' at 0x7f486610b1d8>] انظر أيضًا التابع TarFile.getmember()‎: يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. التابع TarFile.getnames()‎: يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. مصادر صفحة ...

يتحقَّق التابع ?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 مُعرَّفًا في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة ...

الخاصية animation-name في CSS تستعمل لتحديد أسماء الحركات التي ستُطبَّق على العنصر، وكل اسم يجب أن يُشير إلى قاعدة ‎@keyframes التي تُعرِّف قيم الخاصيات اللازمة للحركة. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. من الشائع استخدام الخاصية المختصرة animation لضبط جميع خاصيات الحركات بآنٍ واحد. /* حركة واحدة */ animation-name: none; animation-name: test_05; animation-name: -specific; animation-name: sliding-vertically; /* عدِّة حركات */ animation-name: test1, animation4; animation-name: none, -moz-specific, sliding; /* القيم العامة */ animation-name: initial animation-name: inherit animation-name: unset دعم ...

الخاصية caption-side في CSS تُحدِّد موضع لافتة الجدول المُعرَّفة عبر العنصر <caption>. بطاقة الخاصية القيمة الابتدائية top تُطبَّق على العنصر <caption>. قابلة للوراثة نعم قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ caption-side: top; caption-side: bottom; /* القيم العامة */ caption-side: inherit; caption-side: initial; caption-side: unset; أمثلة سنستخدم في المثال الآتي جدولين <table> مع لافتةٍ <caption> لكل واحدٍ منهما، ثم سنستعمل الخاصية caption-side لضبط موضع اللافتة: <table class="top"> <caption>اللافتة فوق الجدول</caption> <tr> ...

الخاصية transition-property في CSS تستعمل لتحديد أسماء خاصيات CSS التي ستخضع لتأثير الانتقال. بطاقة الخاصية القيمة الابتدائية all تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ transition-property: none; transition-property: all; transition-property: test_05; transition-property: sliding-vertically; transition-property: test1; transition-property: test1, animation4; transition-property: all, height, all; /* القيم العامة */ transition-property: inherit; transition-property: initial; transition-property: unset; ملاحظة: قائمة الخاصيات القابلة للتحريك عرضةٌ للتغيير، وبالتالي يجدر بك تفادي استخدام أيّة خاصيات لا تقبل التحريك حاليًا، فقد يؤدي ذلك إلى نتائج غير متوقعة. إذا استخدمتَ خاصية مختصرة ...

تُقرأ شيفرات بايثون بواسطة المحلّل parser. مدخلات المحلّل هي تدفّق من العلامات tokens التي ينشئها محلل المفردات lexical analyzer. يصف هذا القسم طريقة تقسيم ملفات بايثون إلى علامات بواسطة محلل المفردات. بنية السطر تقسم شيفرة بايثون إلى نوعين من الأسطر هما الأسطر المنطقية والأسطر الفيزيائية. الأسطر المنطقية Logical lines ينتهي السطر المنطقي بعلامة السطر الجديد NEWLINE، ولا يمكن للعبارات أن تتجاوز حدود السطر المنطقي إلا إذا كانت صيغتها تسمح بذلك. ويتألف السطر المنطقي من سطر فيزيائي واحد أو أكثر وبالاعتماد ...

الصنف pathlib.Path في بايثون هو الصنف العام للأصناف التي تتعامل مع المسارات مع السماح بالقيام بعمليات الإدخال والإخراج، وتُسمّى بأصناف المسارات الصلبة Concrete Paths. البنية العامة pathlib.Path(*args,**kwargs)‎ المعاملات args* يمكن تمرير عدد غير محدود من السلاسل النصية أو من كائنات من النوع Path حيث تمثل السلاسل النصية أسماء المجلدات والملفات بالترتيب من المستوى الأعلى للأدنى. kwargs** معامل غير مستخدم. يمكنك مراجعة المقال التالي بخصوص هذا النوع من المعاملات. الاستخدام الأساسي يمكن إنشاء كائن من الصنف Path بثلاث طرق مختلفة: 1- ...

مؤشر الاستقرار: 2 - مستقر. توفر وحدة المسار path أدوات للعمل مع مسارات الملفات والمجلدات. ويمكن الوصول إليها باستخدام: const path = require('path'); ويندوز في مقابل POSIX يختلف التشغيل الإفتراضي لوحدة path استنادًا إلى نظام التشغيل الذي يعمل عليه أحد تطبيقات Node.js. على وجه التحديد، عند تشغيل نظام تشغيل ويندوز، ستفترض وحدة path استخدام نمط ويندوز للمسارات. على سبيل المثال، استخدام الدالة path.basename()‎ مع مسار ويندوز للملف C:\temp\myfile.html، وسيُسفر ذلك عن نتائج مختلفة عند تشغيله على نظام يتبع معايير POSIX ...

يقرأ التابع العدد المحدد من البيانات المضغوطة دون تقديم موقع الملف. البنية العامة peek(n) المعاملات ‎n عدد البيانات المضغوطة المراد قرائتها. يُجري التابع عند استدعائه قراءة واحدة على الأكثر على تدفق البيانات المضغوطة، ويمكن لعدد البايتات المعادة أن يكون أقل أو أكثر من المطلوب. ملاحظات: صحيح أن استدعاء التابع peek()‎ لا يؤدي إلى تغيير في موقع الملف في كائن GzipFile، ولكنّه قد يؤدي إلى إحداث تغيير في كائن الملف الداخلي (إذا كان كائن GzipFile قد بُني مع استخدام المعامل fileobj ...

تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. البنية العامة TarInfo.frombuf(buf, encoding, errors) المعاملات buf سلسلة ذاكرة نصية string buffer يستخدمها التابع لإنشاء كائن TarInfo. القيمة المعادة يعيد التابع كائن TarInfo. يطلق التابع الاستثناء HeaderError إن كان ملف الذاكرة غير صالح للاستخدام. انظر أيضًا التابع TarInfo.fromtarfile()‎: تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. مصادر صفحة Read and write tar archive files في توثيق ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز كتلي (block device). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع blockdev?‎: File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003 انظر أيضا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character ...

يعيد التابع mtime وقت التعديل للملف الذي استدعي معه. البنية العامة mtime → time القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت تعديل الملف المعطى. أمثلة مثال على استعمال التابع mtime: File.new("testfile").mtime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ. التابع ctime: يعيد وقت آخر تغيير أجري على ملف محدَّد. التابع lutime: يعين وقتي الوصول والتعديل لملف أو ملفات محدَّدة. مصادر قسم التابع mtime في الصنف File في ...

مقدمة يوفّر لك Laravel Dusk أتمتة للمتصفّح واختبار للواجهات البرمجيّة بطريقة سهلة الاستخدام. بشكلٍ افتراضي، لا يتطلّب Dusk تنصيب JDK أو Selenium على جهازك، حيث يستعمل تثبيت مستقل (standalone) لبرمجية ChromeDriver. بأي حال، يمكنك استخدام أي برنامج تشغيل متوافق مع Selenium إذا أردت. التثبيت للبدء، أضف الاعتمادية laravel/dusk إلى مشروعك: composer require --dev laravel/dusk بعد تثبيت Dusk، سجّل مزوّد الخدمة الذي يتبع إلى Dusk، وهو Laravel\Dusk\DuskServiceProvider. بشكل عام، يكون هذا تلقائيًّا باستخدام التسجيل التلقائي لمزوّدات خدمة Laravel. تنبيه: إذا قمت بتسجيل ...

يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. البنية العامة TarFile.getnames() القيمة المعادة يعيد التابع قائمة بأسماء الأعضاء في الأرشيف، وتأخذ القائمة المعادة نفس ترتيب القائمة المعادة من التابع getmembers()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar') >>> tar.getnames() ['file1.txt', 'file2.html', 'file3.py'] انظر أيضًا التابع TarFile.getmember()‎: يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. التابع TarFile.getmembers()‎: يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo. مصادر صفحة Read and write tar archive files في توثيق بايثون ...

يعيد التابع atime زمن آخر وصول إلى ملفٍ محدَّدٍ، أو وقت الإنشاء للملف إن لم يتم الوصول إليه. البنية العامة atime → time القيمة المعادة يعاد كائن من النوع Time يمثِّل زمن آخر وصول للملف file_name، أو وقت الإنشاء للملف file_name إن لم يتم الوصول إليه. أمثلة مثال على استعمال التابع atime: File.atime("testfile") #=> Wed Apr 09 08:51:48 CDT 2003 انظر أيضا التابع birthtime: يعيد وقت إنشاء ملف محدَّد. التابع ctime: يعيد وقت آخر تغيير أجري على ملف محدَّد. ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب التقاط جميع عناوين URL. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.default_open(req) القيمة المعادة يجب أن يعيد التابع كائنًا شبيهًا بالملفات file-like object كما هو موصوف في القمية المعادة من التابع open()‎ في كائنات OpenerDirector، أو يعيد القيمة None. يجب أن يطلق التابع الخطأ URLError ...

يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. البنية العامة sniff(sample, delimiters=None) المعاملات ‎delimiters معامل اختياري، تُفسّر قيمته كسلسلة نصية تحتوي على المحارف التي يحتمل استخدامها كفواصل في ملف CSV. القيمة المعادة يعيد التابع صنفًا متفرعًا من الصنف Dialect. أمثلة يبين المثال التالي طريقة عمل التابع: with open('example.csv', newline='') as csvfile: dialect = csv.Sniffer().sniff(csvfile.read(1024)) csvfile.seek(0) reader = csv.reader(csvfile, dialect) ...

يعيد التابع path سلسلة نصية تمثِّل المسار المعطى. البنية العامة path(path) → string المعاملات path المسار المراد تمثيله بسلسلة نصية. القيمة المعادة تعاد سلسلة نصية تمثِّل المسار path المعطى. أمثلة مثال على استعمال التابع path: File.path("/dev/null") #=> "/dev/null" File.path(Pathname.new("/tmp")) #=> "/tmp" انظر أيضا التابع absolute_path: يحول اسم مسار محدَّد إلى مسار مطلق. التابع dirname: يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار. مصادر قسم ...

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

تحوّل المكتبة Marshal مجموعات من كائنات روبي إلى مجرى من البايتات (byte stream)، مما يسمح بتخزينها خارج البرنامج النصي النشط حاليًا. يمكن بعد ذلك قراءة تلك البيانات وإعادة إنشاء الكائنات الأصلية أنشئت منها. تحتوي البيانات المرصوفة (Marshaled data) على أرقام الإصدار الرئيسية والثانوية مخزنةً مع معلومات الكائن. في الاستخدام العادي، تُحمّل فقط البيانات التي لها نفس رقم الإصدار الرئيسي، ورقم الإصدار الثانوي المساوي أو الأقل منه. وفي حال ضبط قيمة الراية "verbose" (عادةً باستخادم ‎-d أو ‎-v أو ‎-w أو ...

يحذف التابع الخيار المحدّد من القسم المحدّد. البنية العامة remove_option(section, option) ‎المعاملات section القسم الذي يحتوي على الخيار المراد حذفه. option الخيار المراد حذفه. القيمة المعادة إن لم يكن القسم المحدّد موجودًا، سيطلق التابع الاستثناء NoSectionError. يعيد التابع القيمة True إن كان الخيار المراد حذفه موجودًا، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.remove_option('topsecret.server.com', 'php_version') True انظر أيضًا التابع remove_section()‎: يحذف التابع القسم المعطى من ملف الإعدادات. مصادر ...

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

يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. البنية العامة defaults() ‎القيمة المعادة يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 = yes [bitbucket.org] User = hg [topsecret.server.com] Port = 50022 ForwardX11 = no يؤدي استدعاء التابع defaults()‎ إلى الحصول على المخرجات التالية: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.defaults() OrderedDict([('serveraliveinterval', '45'), ('compression', 'yes'), ('compressionlevel', '9'), ('forwardx11', 'yes')]) مصادر صفحة Configuration file parser في ...