نتائج البحث

كائنات الصنف Dir هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف File لمزيد من المعلومات. يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: config.h و main.rb، بالإضافة إلى المجلد الأب (..) ، والمجلد نفسه (.). توابع الصنف العامة (Public Class Methods) المعامل [] يكافئ استدعاء Dir.glob([string,...], 0)‎.  chdir‎ يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. children ...

(PHP 4, PHP 5, PHP 7) تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة. يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال ...

(PHP 4, PHP 5, PHP 7) تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة. يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال ...

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). البنية العامة str.join(iterable) المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والمجموعات. القيمة المعادة يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية. أمثلة يبين المثال التالي القيم المعادة من تطبيق ...

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). البنية العامة str.join(iterable) المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والمجموعات. القيمة المعادة يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية. أمثلة يبين المثال التالي القيم المعادة من تطبيق ...

يضيف التابع الملف المعطى إلى ملف الأرشيف. البنية العامة TarFile.add(name, arcname=None, recursive=True, *, filter=None) ‎المعاملات ‎name يمكن لهذا المعامل أن يكون أي نوع من الملفات (مجلد، fifo، وصلة رمزية، الخ). arcname يحدّد هذا المعامل اسمًا بديلًا للملف المضاف إلى الأرشيف. recursive تضاف المجلّدات بصورة تعاودية recursively افتراضيًا، ويمكن تجنّب ذلك بتعيين القيمة False للمعامل recursive. يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب. ملاحظة: يؤدي التعاود Recursion إلى إضافة المدخلات بالترتيب في الإصدار 3.7 من بايثون. filter في حال تحديد قيمة ...

(PHP 4, PHP 5, PHP 7) تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة. يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال ...

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

ينقل التابع pos عند استدعائه بالشكل pos = position المؤشِّر إلى المكان position (المعطى بالبايت) في المجرى ARGF. البنية العامة pos = position → Integer القيمة المعادة يعاد عددٌ صحيحٌ (integer) يمثِّل الموضع position الذي انتقل إليه الموشِّر في المجرى ARGF. أمثلة مثالٌ على استخدام التعبير pos = position: ARGF.pos = 17 ARGF.gets #=> "This is line two\n" انظر أيضًا التابع pos: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى ARGF. التابع fileno: يعيد عددًا صحيحًا يمثل واصف ...

يغير التابع chown المالك والمجموعة المالكة للملف الذي استدعي معه إلى مالك ومجموعة مالكة أخرى. إذا كان الملف وصلةً رمزيَّةً، فيتبع التابع هذه الوصلة ويطبق العملية على الملف الذي تشير إليه. لا يستطيع استعمال هذا التابع إلا المستخدم الذي يملك صلاحيات المستخدم الجذر (أو المستخدم المسؤول). مع ذلك، يستطيع المستخدم المالك لملف أن يغير المجموعة المالكة إلى أية مجموعة أخرى يريدها شرط أن يكون عضوًا فيها. البنية العامة chown(owner_int, group_int ) → 0 المعاملات owner_int معرِّف المستخدم الذي سيصبح المالك الجديد ...

الخاصية font-kerning في CSS تتحكم باستخدام معلومات تآلف الأحرف (kerning information) المُخزّنة في الخط المستخدم. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ font-kerning: auto; font-kerning: normal; font-kerning: none; /* القيم العامة */ font-kerning: inherit; font-kerning: initial; font-kerning: unset; تآلف الأحرف يُعرِّف كيف يجب أن تكون الأحرف متباعدةً عن بعضها، ففي الخطوط التي تدعم ميزة تآلف الأحرف، ستؤدي هذه الميزة إلى تحسين اختيار المسافة التي تفصل بين الأحرف لجعلها أسهل قراءةً. لاحظ تأثير ...

الخاصية border-left-style في CSS تُحدِّد شكل خط الإطار الأيسر الخاص بالعنصر. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ border-left-style: none; border-left-style: hidden; border-left-style: dotted; border-left-style: dashed; border-left-style: solid; border-left-style: double; border-left-style: groove; border-left-style: ridge; border-left-style: inset; border-left-style: outset; /* القيم العامة */ border-left-style: inherit; border-left-style: initial; border-left-style: unset; ملاحظة: لا تُعرِّف المواصفة كيف ستلتقي الإطارات التي لها أشكال مختلفة في الزوايا. أمثلة هذا مثال عن جدول <table> يُبيّن مختلف أشكال الإطارات عبر الخاصية border-left-style. شيفرة HTML: <table> <tr> ...

الخاصية overflow-wrap في CSS تُحدِّد إذا كان على المتصفح الانتقال إلى سطر جديد ضمن الكلمات نفسها لمنع النص من تجاوز حدود صندوق المحتوى للعنصر الحاوي عليه. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. وعلى النقيض من الخاصية word-break، ستنتقل الخاصية overflow-wrap إلى سطرٍ جديد إذا لم يتمكن المتصفح من وضع الكلمة في سطرٍ بمفردها دون تجاوز حدود صندوق المحتوى. /* كلمات محجوزة */ overflow-wrap: normal; overflow-wrap: break-word; /* قيم عامة */ overflow-wrap: ...

الخاصية border-top-width في CSS تضبط عرض الإطار العلوي للعنصر. بطاقة الخاصية القيمة الابتدائية medium تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة الطول المطلق، أو 0 إذا ضُبِطَت الخاصية border-top-style إلى none أو hidden. /* كلمات مفتاحية */ border-top-width: thin; border-top-width: medium; border-top-width: thick; /* <length> أطوال */ border-top-width: 10em; border-top-width: 3vmax; border-top-width: 6px; /* قيم عامة */ border-top-width: inherit; border-top-width: initial; border-top-width: unset; أمثلة سنضبط في المثال الآتي إطارًا علويًا لعناصر <div> لونه (border-top-color) أخضر، وعرضه (border-top-width) يساوي 4px وشكله (border-top-style) منقط. شيفرة HTML: <div>لهذا العنصر ...

الخاصية margin-top في CSS تضبط الهامش في الطرف العلوي من العنصر، والقيم الموجبة ستؤدي إلى إبعاد العنصر عمّا جاوره، والقيم السالبة ستقربه منها. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر، ما عدا عناصر الجداول التي لا تساوي فيها قيمة الخاصية display إحدى الكلمات المحجوزة table-caption و table و inline-table. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق. /* <length> أطوال */ margin-top: 10px; /* طول مطلق */ margin-top: 1em; /* طول نسبي ...

الخاصية z-index في CSS تُحدِّد ترتيب العناصر التي يمكن أن يتغير مكانها (positioned elements) على المحور Z، فعندما تتداخل العناصر فستُحدِّد قيمة هذه الخاصية ما هو العنصر الذي سيظهر أعلى بقية العناصر، والعنصر الذي له قيمة z-index أكبر ما يمكن سيظهر في الأعلى. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على العناصر التي يمكن أن يتغير مكانها (positioned elements). قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* كلمة محجوزة */ z-index: auto; /* <integer> قيم عددية */ z-index: 0; z-index: 3; z-index: 289; z-index: ...

الخاصية width في CSS تُحدِّد عرض أحد العناصر، وتستخدم هذه الخاصية افتراضيًا لتحديد عرض منطقة المحتوى (content area)، لكن إن كانت الخاصية box-sizing مضبوطة إلى border-box فستُحدِّد عرض العنصر بدءًا من الحافة الخارجية للإطار. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على جميع العناصر، ما عدا العناصر السطرية غير المُستبدَلة (non-replaced inline elements)، وأعمدة الجداول، ومجموعات الأعمدة. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق أو الكلمة المحجوزة auto. /* كلمة محجوزة */ width: auto; /* <length> أطوال ...

الخاصية resize في CSS تُحدِّد إذا كان تغيير حجم العنصر ممكنًا، وفي أيّ اتجاه. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على العناصر التي لا تكون قيمة الخاصية overflow فيها تساوي visible. قابلة للوراثة لا قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ resize: none; resize: both; resize: horizontal; resize: vertical; resize: block; resize: inline; /* القيم العامة */ resize: inherit; resize: initial; resize: unset; أمثلة سيُسمَح بتغيير حجم عناصر <textarea> من قِبل المستخدم في الكثير من المتصفحات؛ لكن يمكن تغيير هذا السلوك باستخدام الخاصية resize: <textarea>Type some ...

الخاصية order في CSS تُحدِّد ترتيب عناصر flex في الحاوية، إذ ستُرتَّب العناصر ترتيبًا تصاعديًا اعتمادًا على قيمة الخاصية order المُسندَة إليها، والعناصر التي لها نفس القيمة ستُرتَّب وفق ورودها في الشيفرة المصدرية. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على حاويات flex. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* القيم العددية، بما في ذلك الأعداد السالبة */ order: 5; order: -5; /* القيم العامة */ order: inherit; order: initial; order: unset; ملاحظة: الغرض من الخاصية order هو التأثير على الترتيب المرئي للعناصر، ...

الخاصية border-image-repeat في CSS تُعرِّف كيفية عرض الجزء الأوسط من صورة الإطار لكي تُطابِق أبعاد الإطار. ويمكن استخدام قيمة واحدة لهذه الخاصية لضبط سلوك جميع الحواف، أو يمكن تحديد قيمتين لضبط سلوك الحواف الأفقية والرأسية كلًا على حدة. بطاقة الخاصية القيمة الابتدائية stretch تُطبَّق على جميع العناصر ما عدا عناصر الجدول الداخلية التي ضُبِطَت فيها الخاصية border-collapse إلى collapse. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* border-image-repeat: type */ border-image-repeat: stretch; /* border-image-repeat: horizontal vertical */ border-image-repeat: round stretch; /* ...

الخاصية overflow-wrap في CSS تُحدِّد إذا كان على المتصفح الانتقال إلى سطر جديد ضمن الكلمات نفسها لمنع النص من تجاوز حدود صندوق المحتوى للعنصر الحاوي عليه. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدت. وعلى النقيض من الخاصية word-break، ستنتقل الخاصية overflow-wrap إلى سطرٍ جديد إذا لم يتمكن المتصفح من وضع الكلمة في سطرٍ بمفردها دون تجاوز حدود صندوق المحتوى. /* كلمات محجوزة */ overflow-wrap: normal; overflow-wrap: break-word; /* قيم عامة */ overflow-wrap: ...

الخاصية border-right-style في CSS تُحدِّد شكل خط الإطار الأيمن الخاص بالعنصر. القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ border-right-style: none; border-right-style: hidden; border-right-style: dotted; border-right-style: dashed; border-right-style: solid; border-right-style: double; border-right-style: groove; border-right-style: ridge; border-right-style: inset; border-right-style: outset; /* القيم العامة */ border-right-style: inherit; border-right-style: initial; border-right-style: unset; ملاحظة: لا تُعرِّف المواصفة كيف ستلتقي الإطارات التي لها أشكال مختلفة في الزوايا. أمثلة هذا مثال عن جدول <table> يُبيّن مختلف أشكال الإطارات عبر الخاصية border-right-style. شيفرة HTML: <table> <tr> ...

الخاصية border-bottom-width في CSS تضبط عرض الإطار السفلي للعنصر. بطاقة الخاصية القيمة الابتدائية medium تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة الطول المطلق، أو 0 إذا ضُبِطَت الخاصية border-bottom-style إلى none أو hidden. /* كلمات مفتاحية */ border-bottom-width: thin; border-bottom-width: medium; border-bottom-width: thick; /* <length> أطوال */ border-bottom-width: 10em; border-bottom-width: 3vmax; border-bottom-width: 6px; /* قيم عامة */ border-bottom-width: inherit; border-bottom-width: initial; border-bottom-width: unset; أمثلة سنضبط في المثال الآتي إطارًا سفليًا لعناصر <div> لونه (border-bottom-color) أحمر، وعرضه (border-bottom-width) يساوي 4px وشكله (border-bottom-style) منقط. شيفرة HTML: <div>لهذا العنصر ...

الخاصية overflow-x في CSS تُحدِّد إن كان سيتم اقتصاص (clip) المحتوى، أو سيُعرَض شريط تمرير (scroll bar)، أو سيُعرَض ما يزيد من محتوى العنصر الكتلي على يمينه أو يساره. بطاقة الخاصية القيمة الابتدائية visible تُطبَّق على عناصر block-level و inline-block غير المُستبدَلة (non-replaced). قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* لن يتم اقتصاص المحتوى */ overflow-x: visible; /* سيتم اقتصاص المحتوى دون عرض شريط تمرير */ overflow-x: hidden; /* سيتم اقتصاص المحتوى مع عرض شريط تمرير */ overflow-x: scroll; /* ترك الأمر ...

تدعم روبي شكلين من التوابع الكائنية (objectified methods). يستخدم الصنف Method لتمثيل التوابع المرتبطة بكائن معين، ويمكن إنشاء كائنات التوابع من هذا النوع عبر التابع Object.method. تدعم روبي أيضًا التوابع الحرة (unbound methods)؛ وهي كائنات توابع غير مرتبطة بكائن معين. يمكن إنشاؤها إما عن طريق استدعاء Module.instance_method، أو عن طريق استدعاء unbind على تابع مرتبط (bound method object). نتيجة كليهما ستكون تابعًا حرًا (كائن من النوع UnboundMethod). لا يمكن استدعاء التوابع الحرة إلا بعد ربطها بكائن ما. ويجب أن يعيد ...

تعيد الدّالة next()‎ القيمة التّالية من المُكرّر المٌعطى عبر استدعاء تابعه الخاصّ ‎_‎_‎next‎_‎_‎()‎. البنية العامة next(iterator[, default]) المعاملات iterator المُكرّر المرُاد الحصول على قيمته التّالية. default مُعامل اختياريّ. تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء StopIteration. القيمة المعادة القيمة التّاليّة للمُكرّر أو القيمة الافتراضيّة المُعطاة للمُعامل default عندما تنتهي قيم المُكرّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> name = 'Yousuf' >>> iterator = iter(name) >>> iterator <str_iterator object at 0x7f314d904fd0> >>> next(iterator) 'Y' >>> next(iterator) 'o' >>> next(iterator) 'u' >>> next(iterator) 's' >>> next(iterator) 'u' >>> next(iterator) 'f' >>> ...

كائنات الكتابة هي نسخ من الصنف DictWriter وتنشأ كذلك من استدعاء الدالة writer()‎. خصائص كائنات الكتابة تمتلك كائنات الكتابة الخصائص العامة التالية: csvwriter.dialect هذه الخاصية للقراءة فقط، وتتضمن وصفًا للهجة المستخدمة بواسطة كائن الكتابة. توابع كائنات الكتابة تمتلك كائنات الكتابة التوابع العامة التالية: يجب أن يكون الصف row كائنًا قابلًا للتكرار من السلاسل النصية او الأرقام عند استخدام كائنات Writer وأن يكون قاموسًا يربط أسماء الحقول fieldnames بسلاسل نصية أو أرقام (عن طريق تمريرها عبر الدالة str()‎ في البداية) عند ...

يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items()‎ في كائنات dict. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا. يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة. البنية العامة read_dict(dictionary, source='<dict>') ‎المعاملات dictionary القاموس الذي سيقرأ التابع منه الإعدادات. ‎source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name ...

يغير التابع chown المالك والمجموعة المالكة لملف أو عدة ملفات محدَّدة إلى مالك ومجموعة مالكة أخرى. لا يستطيع استعمال هذا التابع إلا المستخدم الذي يملك صلاحيات المستخدم الجذر (أو المستخدم المسؤول). مع ذلك، يستطيع المستخدم المالك لملف أن يغير المجموعة المالكة إلى أية مجموعة أخرى يريدها شرط أن يكون عضوًا فيها. البنية العامة chown(owner_int, group_int, file_name,... ) → integer المعاملات owner_int معرِّف المستخدم الذي سيصبح المالك الجديد للملف أو الملفات المحدَّدة. إن كانت قيمة هذا المعامل nil أو 1-، فسيُتجاهَل. group_int ...

تقدّم هذه الوحدة مجموعة متنوعة من الدوال التي تساعد في التعامل مع بيئات WSGI. بيئة WSGI هي قاموس يتضمّن متغيرات طلب HTTP وبحسب ما هو موصوف في PEP 3333.  تأخذ جميع الدوال المعامل environ وهو عبارة عن قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. دوال الوحدة wsgiref.util الدالة wsgiref.util.guess_scheme()‎ تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى. الدالة wsgiref.util.request_uri()‎ تعيد الدالة معرّف URI الكامل في الطلب باستخدام ...

يطبع التابع جدولًا بمحتويات كائن TarFile إلى مخرجات النظام sys.stdout. البنية العامة TarFile.list(verbose=True, *, members=None) ‎المعاملات ‎verbose إن أخذ المعامل verbose القيمة False، فسيطبع التابع أسماء أعضاء الأرشيف فقط. أما إن أخذ القيمة True (وهي القيمة الافتراضية)، فستكون المخرجات الناتجة مشابهة للمخرجات الناتجة من الأمر ls -l في الصدفة. members معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع getmembers()‎. ملاحظة: أضيف المعامل members في الإصدار 3.5 من بايثون. القيمة المعادة ...

مقدمة تسمح لنا الثوابت المتعدّدة بتعريف مجموعة مُسمّاةٍ من الثوابت (set of named constants). استخدام الثوابت المتعدّدة يُسهّل توضيحَ نية استعمال الشيفرة أو إنشاء مجموعة حالات مختلفة. تُوفّر TypeScript كلا من الثوابت المتعددة المعتمِدة على الأعداد وتلك المُعتمِدة على السلاسل النصية كذلك. الثوابت المتعددة العددية (Numeric enums) سنبدأ بالثوابت المتعددة العددية، والتي ستكون مألوفة لمن هو آتٍ من لغات البرمجة الأخرى. يُمكن تعريف ثابت متعدّد بالكلمة المفتاحية ‎enum‎: enum Direction { Up = 1, ...

تتيح وحدة decimal إجراء حسابات سريعة على الأعداد العشرية مع ضمان التقريب الصحيح. >>> import decimal >>> Decimal(10) Decimal('10') >>> Decimal('3.14') Decimal('3.14') >>> Decimal(3.14) Decimal('3.140000000000000124344978758017532527446746826171875') ميزات الوحدة decimal تتفوق هذه الوحدة على نوع الأعداد العشرية float بعدة ميزات: العدد العشري decimal "يستند إلى نموذج أعداد عشرية ذات فاصلة عائمة يراعي الاستخدام البشري ويلتزم بمبدأ أساسي هو أنّه يجب أن توفّر الحواسيب عمليات حسابية تعمل بنفس الطريقة التي يتعلّمها الناس في المدارس" - اقتباسٌ من مواصفات العمليات الحسابية التي تجرى على الأعداد العشرية decimal. يمكن تمثيل الأعداد ...

تتيح وحدة decimal إجراء حسابات سريعة على الأعداد العشرية مع ضمان التقريب الصحيح. >>> import decimal >>> Decimal(10) Decimal('10') >>> Decimal('3.14') Decimal('3.14') >>> Decimal(3.14) Decimal('3.140000000000000124344978758017532527446746826171875') ميزات الوحدة decimal تتفوق هذه الوحدة على نوع الأعداد العشرية float بعدة ميزات: العدد العشري decimal "يستند إلى نموذج أعداد عشرية ذات فاصلة عائمة يراعي الاستخدام البشري ويلتزم بمبدأ أساسي هو أنّه يجب أن توفّر الحواسيب عمليات حسابية تعمل بنفس الطريقة التي يتعلّمها الناس في المدارس" - اقتباسٌ من مواصفات العمليات الحسابية التي تجرى على الأعداد العشرية decimal. يمكن تمثيل الأعداد ...

تعرف هذه الوحدة كائنًا يمكن عن طريقه تمثيل مصفوفة من القيم الأساسية مثل الحروف والأعداد الصحيحة والأعداد ذات الفاصلة العائمة بشكل مضغوط. تعد المصفوفات نوعًا من أنواع التسلسلات وتشبه القوائم في عملها على نحو كبير، باستثناء أن أنواع الكائنات التي يمكن تخزينها في المصفوفات محدودة. أنواع الكائنات التي يمكن تخزينها في المصفوفات يجب تحديد نوع الكائنات عند إنشاء المصفوفة وذلك باستخدام رمز النوع وهو عبارة عن حرف واحد فقط. يبين الجدول التالي رموز الأنواع المتاحة: رمز النوع النوع في لغة ...

يستدعي التابع select دالة النظام select(2)‎، إذ يعمل على مراقبة المصفوفات الكائنات IO المعطاة، وينتظر حتى يصبح أحد تلك الكائنات أو أكثر جاهزًا للقراءة، وجاهزًا للكتابة، ومالكًا لاستثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من الكائنات IO السابقة. سيعيد التابع القيمة nil إذا تم إعطاء قيمة للمهلة الزمنية timeout، ولم يكن هناك أي كائن جاهز خلال هذه الفترة. يراقب التابع IO.select المخزن المؤقت (buffer) للكائنات IO لاختبار قابليتها للقراءة. إذا لم يكن المخزن المؤقت ...

ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. البنية العامة open(path [, mode [, perm]] [, opt]) → io or nil open(path [, mode [, perm]] [, opt]) {|io| block } → obj‎ في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج. إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة ...

الخاصية background-attachment في CSS تصف كيف يجب أن تمتزج صور الخلفية مع بعضها بعضًا ومع لون الخلفية المُحدَّد للعنصر. يجب تعريف أنماط الامتزاج (blending modes) بنفس ترتيب ورود الصور في خاصية background-image؛ وإذا لم يكن طول قائمة القيم في كلا الخاصيتين متساوٍ، فستُكرَّر أو تحذف بعض القيم حتى تتساوى فيما بينها. لاحظ أنَّه إذا استخدمنا الخاصية background المختصرة، فستؤدي إلى إعادة ضبط قيمة الخاصية background-blend-mode إلى قيمتها الافتراضية، لذا احرص على استعمال هذه الخاصية بعدها. بطاقة الخاصية القيمة الابتدائية normal ...

الخاصية transition-duration في CSS تُحدِّد الزمن الذي سيستغرقه تأثير الانتقال للوصول إلى القيمة النهائية للخاصية، والقيمة الافتراضية 0s لن تؤدي إلى حدوث تأثير انتقال أبدًا. بطاقة الخاصية القيمة الابتدائية 0s تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. يمكننا تحديد أكثر من قيمة لهذه الخاصية، وكل قيمة سترتبط بقيمة من قيم الخاصية transition-property، وإذا كانت هنالك قيم في هذه الخاصية أقل من القيم المسندة للخاصية transition-property فستُكرَّر قيم هذه الخاصية كي تكفي، وإذا كانت ...

الخاصية flex-wrap في CSS تُحدِّد فيما إذا كانت عناصر flex يجب أن تكون محتواةً في سطرٍ وحيد أم يمكن التفافها إلى عدِّة أسطر، وإذا سُمِحَ بالالتفاف (wrap) فيمكننا باستخدام هذه الخاصية تحديد ترتيب تكديس الأسطر. بطاقة الخاصية القيمة الابتدائية nowrap تُطبَّق على حاويات flex. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ flex-wrap: nowrap; flex-wrap: wrap; flex-wrap: wrap-reverse; /* قيم عامة */ flex-wrap: inherit; flex-wrap: initial; flex-wrap: unset; أمثلة هذا المثال يبيّن استخدام الكلمات المحجوزة wrap و nowrap و wrap-reverse مع ...

الخاصية text-decoration-style في CSS تُحدِّد شكل خطوط الزخرفة (decorative lines) المستخدمة على النص (المضبوطة عبر الخاصية text-decoration-line). إذا كنت ستضبط عدِّة خاصيات لتحديد شكل خطوط الزخرفة، فمن المستحسن حينئذٍ استخدام الخاصية المختصرة text-decoration. بطاقة الخاصية القيمة الابتدائية solid تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-decoration-style: solid; text-decoration-style: double; text-decoration-style: dotted; text-decoration-style: dashed; text-decoration-style: wavy; /* القيم العامة */ text-decoration-style: inherit; text-decoration-style: initial; text-decoration-style: unset; لا توفِّر CSS طريقةً مباشرةً لتحديد شكل فريد لكل خط زخرفة مُطبَّق على العنصر، لكن ...

الخاصية max-width في CSS تضبط العرض الأقصى للعنصر، وهي تمنع القيمة المستخدمة (used value) للخاصية width من أن تتجاوز القيمة المُحدَّدة في الخاصية max-width. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر، ما عدا العناصر السطرية غير المُستبدَلة (non-replaced inline elements)، وأعمدة الجداول، ومجموعات الأعمدة. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق أو الكلمة المحجوزة none. /* <length> أطوال */ max-width: 3.5em; /* <percentage> نسب مئوية */ max-width: 75%; /* كلمات محجوزة */ max-width: none; /* قيم عامة */ max-width: ...

الخاصية min-height في CSS تضبط الارتفاع الأدنى للعنصر، وهي تمنع القيمة المستخدمة (used value) للخاصية height من أن تقل عن القيمة المُحدَّدة في الخاصية min-height. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر، ما عدا العناصر السطرية غير المُستبدَلة (non-replaced inline elements)، وأعمدة الجداول، ومجموعات الأعمدة. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق أو الكلمة المحجوزة auto. /* <length> أطوال */ min-height: 3.5em; /* <percentage> نسب مئوية */ min-height: 75%; /* كلمات محجوزة */ min-height: none; /* قيم عامة ...

الخاصية word-spacing في CSS تُحدِّد كيف سيكون التباعد بين الكلمات والوسوم. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على جميع العناصر. قابلة للوراثة نعم. قابلة للتحريك نعم القيمة المحسوبة طول مطلق أو الكلمة المحجوزة normal. /* كلمة محجوزة */ word-spacing: normal; /* <length> أطوال */ word-spacing: 3px; word-spacing: 0.3em; /* <percentage> نسب مئوية */ word-spacing: 50%; word-spacing: 200%; /* قيم عامة */ word-spacing: inherit; word-spacing: initial; word-spacing: unset; أمثلة مثال عن استخدام قيم موجبة وسالبة مع الخاصية word-spacing لزيادة (أو إنقاص) التباعد بين الكلمات: <p class="word-spacing-px">محتوى موسوعة حسوب هو محتوى مرجعي، أي ...

الخاصية margin-bottom في CSS تضبط الهامش في الطرف السفلي من العنصر، والقيم الموجبة ستؤدي إلى إبعاد العنصر عمّا جاوره، والقيم السالبة ستقربه منها. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر، ما عدا عناصر الجداول التي لا تساوي فيها قيمة الخاصية display إحدى الكلمات المحجوزة table-caption و table و inline-table. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق. /* <length> أطوال */ margin-bottom: 10px; /* طول مطلق */ margin-bottom: 1em; /* طول نسبي ...

يتلخَّصُ الاستخدام الرئيسيّ لأصناف الثوابت المتعدَّدة في قدرتها على تعريف الاستخدام (implementing) للثوابت المتعدًّدة الحافظة للنوع (type-safe)، ويُصرَّح عنها بالشكل: enum class Direction { NORTH, SOUTH, WEST, EAST } إذ يُعدُّ كلُّ ثابتٍ فيها كائنًا (object)، ويُفصل فيما بينها بالفاصلة , . التهيئة (Initialization) لمّا كان كلّ ثابتٍ في صنف الثوابت المتعدِّدة (enum) يُعدُّ كائنًا فيمكن إجراء التهيئة كما يلي: enum class Color(val rgb: Int) { RED(0xFF0000), ...

الخاصية text-decoration-line في CSS تُحدِّد نوع خطوط الزخرفة (decorative lines) المستخدمة على النص. إذا كنت ستضبط عدِّة خاصيات لتحديد شكل خطوط الزخرفة، فمن المستحسن حينئذٍ استخدام الخاصية المختصرة text-decoration. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-decoration-line: none; text-decoration-line: underline; text-decoration-line: overline; text-decoration-line: line-through; text-decoration-line: blink; text-decoration-line: underline overline; /* استخدام خطَيّ زخرفة */ text-decoration-line: overline underline line-through; ...

الخاصية text-decoration-color في CSS تُحدِّد لون خطوط الزخرفة (decorative lines) المستخدمة على النص والمضبوطة عبر الخاصية text-decoration-line؛ وهذا يتضمن الأسطر التي تعلو الخط أو تظهر أدناه أو تمر عبره أو الخطوط المموجة (التي تُشير عادةً إلى أنَّ الكلام فيه خطأ إملائي على سبيل المثال)؛ وسيُطبَّق اللون المضبوط عبر هذه الخاصية على جميع خطوط الزخرفة المُحدَّدة على العنصر. بطاقة الخاصية القيمة الابتدائية currentcolor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة قيمة لونية <color>. إذا كنت ستضبط عدِّة ...

الخاصية border-bottom-style في CSS تُحدِّد شكل خط الإطار السفلي الخاص بالعنصر. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ border-bottom-style: none; border-bottom-style: hidden; border-bottom-style: dotted; border-bottom-style: dashed; border-bottom-style: solid; border-bottom-style: double; border-bottom-style: groove; border-bottom-style: ridge; border-bottom-style: inset; border-bottom-style: outset; /* القيم العامة */ border-bottom-style: inherit; border-bottom-style: initial; border-bottom-style: unset; ملاحظة: لا تُعرِّف المواصفة كيف ستلتقي الإطارات التي لها أشكال مختلفة في الزوايا. أمثلة هذا مثال عن جدول <table> يُبيّن مختلف أشكال الإطارات عبر الخاصية border-bottom-style. شيفرة HTML: <table> <tr> ...

الخاصية transition-delay في CSS تُحدِّد الزمن الذي يجب انتظاره بين وقوع الحدث الذي سيؤدي إلى بدء تأثير الانتقال وبين بداية التأثير. بطاقة الخاصية القيمة الابتدائية 0s تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. القيمة 0s أو 0ms تُشير إلى أنَّ الحركة الانتقالية للخاصية ستبدأ مباشرةً عند وقوع الحدث، والقيم الموجبة ستؤدي إلى تأثير بداية تأثير الانتقال وفقًا للقيمة المُحدَّدة، والقيم السالبة ستؤدي إلى بدء تأثير الانتقال مباشرةً لكن مع جعله يبدو وكأنه قد ...

الخاصية quotes في CSS تُشير إلى الطريقة التي يجب أن يعرض فيها المتصفح علامات الاقتباس. بطاقة الخاصية القيمة الابتدائية تختلف حسب المتصفح. تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* كلمة محجوزة */ quotes: none; /* <string> سلاسل نصية */ quotes: "«" "»"; /* ضبط علامة الاقتباس الابتدائية والنهائية */ quotes: "«" "»" "‹" "›"; /* ضبط مستويين من الاقتباس */ /* القيم العامة */ quotes: inherit; quotes: ...

الخاصية border-top-style في CSS تُحدِّد شكل خط الإطار العلوي الخاص بالعنصر. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ border-top-style: none; border-top-style: hidden; border-top-style: dotted; border-top-style: dashed; border-top-style: solid; border-top-style: double; border-top-style: groove; border-top-style: ridge; border-top-style: inset; border-top-style: outset; /* القيم العامة */ border-top-style: inherit; border-top-style: initial; border-top-style: unset; ملاحظة: لا تُعرِّف المواصفة كيف ستلتقي الإطارات التي لها أشكال مختلفة في الزوايا. أمثلة هذا مثال عن جدول <table> يُبيّن مختلف أشكال الإطارات عبر الخاصية border-top-style. شيفرة HTML: <table> <tr> ...

الخاصية border-image-width في CSS تُعرِّف عرض صورة الإطار بتحديد بعدها عن حافة الإطار الخارجية، وإذا كانت قيمة الخاصية border-image-width أكبر من قيمة الخاصية border-width، فستمتد صورة الإطار إلى ما بعد حافة الحاشية (padding) أو حافة المحتوى (content). بطاقة الخاصية القيمة الابتدائية 1 تُطبَّق على جميع العناصر ما عدا عناصر الجدول الداخلية التي ضُبِطَت فيها الخاصية border-collapse إلى collapse. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت، لكن مع تحويل الأطوال النسبية إلى أطوال مطلقة. /* border-image-width: all */ border-image-width: ...

الخاصية border-spacing في CSS تُحدِّد المسافة بين إطارات خلايا الجداول المتجاورة. لن يكون لهذه الخاصية أثرٌ إلا إذا كانت قيمة الخاصية border-collapse هي separate. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على عناصر table و inline-table. قابلة للوراثة نعم قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* <length> */ border-spacing: 2px; /* horizontal <length> | vertical <length> */ border-spacing: 1cm 2em; /* القيم العامة */ border-spacing: inherit; border-spacing: initial; border-spacing: unset; ستستخدم قيمة الخاصية border-spacing على الحافة الخارجية للجدول، إذ تكون المسافة بين إطار الجدول وبين الخلايا في أول ...

تُحدِّد الخاصية opacity في CSS درجة شفافية أحد العناصر، أي مدى ظهور المحتوى الذي يقع وراءه. بطاقة الخاصية القيمة الابتدائية 1.0 تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للحركة نعم القيمة المحسوبة القيمة المُحدَّدة لكن ضمن المجال من 0 إلى 1. /* غير شفاف */ opacity: 1; opacity: 1.0; /* نصف شفاف */ opacity: 0.6; /* شفاف تمامًا */ opacity: 0; opacity: 0.0; /* القيم العامة */ opacity: inherit; opacity: initial; opacity: unset; تُطبَّق الخاصية opacity على العنصر ككل، بما في ذلك محتوى، حتى لو لم تكن قيمة هذه الخاصية قابلةً ...

الخاصية min-width في CSS تضبط العرض الأدنى للعنصر، وهي تمنع القيمة المستخدمة (used value) للخاصية width من أن تقل عن القيمة المُحدَّدة في الخاصية min-width. بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على جميع العناصر، ما عدا العناصر السطرية غير المُستبدَلة (non-replaced inline elements)، وأعمدة الجداول، ومجموعات الأعمدة. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق أو الكلمة المحجوزة auto. /* <length> أطوال */ min-width: 3.5em; /* <percentage> نسب مئوية */ min-width: 75%; /* كلمات محجوزة */ min-width: none; /* قيم عامة ...

يحذف هذا التابع أول عنصر في القائمة تساوي قيمته القيمة التي يحدّدها المستخدم. البنية العامة l.remove() المعاملات x العنصر المراد حذفه من القائمة. القيمة المعادة يعيد هذا التابع القيمة None، ويُطلِق الخطأ ValueError إن كان العنصر المراد حذفه غير موجودٍ في القائمة. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لحذف العناصر من القائمة: >>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana'] >>> fruits.remove('banana') >>> fruits ['orange', 'apple', 'pear', 'kiwi', 'apple', 'banana'] >>> fruits.remove('watermelon') Traceback (most recent call last): File "<input>", line ...

التابع linecache.lazycache يحصل هذا التابع على المعلومات الكافية عن وحدة غير معتمدة على الملف" non-file-based" بحيث تكون جاهزة لقراءة أسطرها لاحقًا باستخدام التابع getline حتى لو كان المعامل module_globals غير مُسند ضمن معاملات getline، مما يسمح بتجنب عمليات الكتابة والقراءة إلى حين وجود حاجة حقيقية دون الحاجة إلى الاحتفاظ بالمعامل module_globals ضمن الشيفرة البرمجية. البنية العامة linecache.lazycache(filename, module_globals) المعاملات المعامل filename اسم الملف المُراد وضعه بالكاش بطريقة كسولة. المعامل module_globals قاموس (dict) يحتوي على مفتاحين __name__ و __loader__ يُستخدمان ضمن ...

تقدّم هذه الوحدة واجهة بسيطة لضغط الملفات وفك ضغطها بنفس الأسلوب المتّبع في برنامجي gzip و gunzip في GNU. وتجري عملية ضغط البيانات بواسطة وحدة zlib. تقدّم وحدة gzip الصنف GzipFile إضافة إلى الدوال open()‎ و compress()‎ و decompress()‎. يدعم برنامجا gzip و gunzip صيغ ملفات أخرى مثل تلك التي تنتج من compress و pack، ولكن يجدر التنبيه إلى أنّ هذه الصيغة غير مدعومة من قبل هذه الوحدة. تعرّف الوحدة العناصر التالية: الدالة gzip.open()‎ تفتح الدالة ملفًّا مضغوطًا بواسطة gzip ...

ينشئ التابع كائن TarInfo من نتيجة استدعاء الدالة os.stat()‎ أو ما يكافئها على ملف موجود فعلًا. البنية العامة TarFile.gettarinfo(name=None, arcname=None, fileobj=None) المعاملات ‎name يمكن تسمية الملف عن طريق تمرير الاسم في المعامل name أو باستخدام كائن fileobj مع واصف للملف. ويمكن للمعامل name أن يكون كائنًا شبيهًا بالمسارات. arcname معامل اختياري يعيّن اسمًا بديلًا للملف في الأرشيف، وفي حال عدم تحديد قيمة لهذا المعامل يأخذ الملف اسمه من خاصية name في كائن الملف fileobj، أو من المعامل name. يجدر التنبيه ...

تقدّم وحدة dbm.ndbm واجهة برمجية لمكتبة ‎"(n)dbm"‎ في يونكس. تسلك كائنات dbm سلوك كائنات الربط (القواميس) باستثناء أنّ المفاتيح والقيم تخزّن دائمًا كبايتات. لا تؤدي طباعة كائنات dbm إلى طباعة المفاتيح والقيم، ولا تدعم هذه الكائنات التابعين items()‎ و values()‎. يمكن استخدام هذه الوحدة مع واجهة ndbm الكلاسيكية أو مع واجهة GNU GDBM التوافقية. ستحاول شيفرة configure في يونكس أن تحدد موقع ملف الترويسة header file المناسب لتبسيط عملية بناء هذه الوحدة. الاستثناءات الاستثناء dbm.ndbm.error يطلق هذا الاستثناء عند حدوث ...

يوفّر لك هذا الدليل كل ما تحتاجه للبدء في إرسال واستقبال رسائل البريد الإلكتروني من وإلى تطبيقك، والعديد من عمليّات Action Mailer الداخليّة. كما يغطي كيفية اختبار مُرسلي بريدك (mailers). ستتعلم بعد قراءة هذا الدليل: كيفيّة إرسال واستقبال البريد الإلكتروني داخل تطبيق ريلز. كيفيّة إنشاء وتعديل صنف Action Mailer والعرض المرتبط به. كيفيّة إعداد Action Mailer لبيئتك. كيفيّة اختبار أصنافك لـ Action Mailer. مقدمة يسمح لك Action Mailer بإرسال رسائل البريد الإلكتروني من تطبيقك باستخدام الأصناف mailer والعروض المرتبطة بها ...

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

الوصول إلى الطلب عليك التلميح إلى نوع الصنف Illuminate\Http\Request في وحدة تحكمّك للحصول على نسخة الطلب HTTP الحالي عبر إضافة الاعتماديّة. ستُضاف نسخة الطلب الوارد تلقائيًّا بواسطة حاوي الخدمات: <?php namespace App\Http\Controllers; use Illuminate\Http\Request; class UserController extends Controller { /** * خزّن مستخدمًا جديدًا * * @param Request $request * @return Response */ public function store(Request ...

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

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

يحوّل التابع اسم الخيار المعطى وكما هو موجود في ملف الإعدادات أو كما هو ممرّر إلى التابع عن طريق الشيفرة التي يكتبها المستخدم إلى الصيغة التي يجب استخدامها في البنية الداخلية لملفات الإعدادات. البنية العامة optionxform(option) ‎المعاملات option المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات. القيمة المعادة تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ ...

التابع linecache.getline يعيد السطر المُحدد رقمُه بالمعامل lineno الممرة كسلسلة نصية، ويعيد سلسلة نصية فارغة إن حدث أي خطأ. يكون المحرف الدال على نهاية السطر متضَمّنًا ضمن السلسة النصية المعادة. إن لم يكن الملف ذو الاسم filename موجودًا، يقوم التابع بالبحث عنه ضمن مسار البحث عن الوحدات، sys.path، وذلك بعد أن يتم البحث أولًا عن تابع __loader__ المعرف ضمن التحسين PEP-302 ضمن الوسيط module_globals وذلك في حال كانت الوحدة مستوردةً من ملف مضغوط أو من مصدر ليس من نظام الملفات. ...

يقرأ التابع readline سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع gets باستثناء أنَّه يُطلق الاستثناء EOFError عند نهاية الملف. البنية العامة readline(sep=$/ [, getline_args]) → string readline(limit [, getline_args])→ string readline(sep, limit [, getline_args]) → string‎ المعاملات sep‎ محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: /$. limit‎ عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها. getline_args راجع صفحة readlines لمزيد من التفاصيل حول هذا المعامل. القيمة المعادة تعاد سلسلة نصية تحوي السطر الذي قُرِئ من المجرى المعطى، أو يطلق ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filetype()‎ نوع الملف المحدَّد. الوصف string filetype ( string $filename ) تعيد هذه الدالة نوع الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد نوع الملف filename. القيم المتوقَّعة لنوع الملف هي إمَّا أنبوبة مسماة (FIFO وتدعى أحيانًا named pipe) أو ملف محرفي خاص (char) أو مجلد (dir) أو ملف كتلي خاص (block) أو وصلة رمزية (link) أو ملف عادي (file) أو مقبس (socket) أو نوع غير معروف (unknown). ...

تقدّم بايثون ثمان عمليات للمقارنة، وتمتلك جميعها نفس الأولوية (وهي أعلى من العمليات المنطقية). يلخّص الجدول التالي عمليات المقارنة المتوفّرة في بايثون: العملية الوظيفة ‎<‎‎ أقل من ‎<=‎ أقل من أو يساوي ‎>‎ أكبر من ‎>=‎ أكبر من أو يساوي == المساواة ‎!=‎ عدم المساواة is هوية الكائن is not نفي هوية الكائن ملاحظات يمكن ربط عمليات المقارنة بعضها ببعض حسب الحاجة، فعلى سبيل المثال العبارة x < y <= z مكافئة للعبارة x < y and y <= z، ...

الخاصية column-count في CSS هي تُحدِّد ما هو عدد الأعمدة التي سينقسم العنصر إليها. بطاقة الخاصية القيمة الابتدائية auto تُطبَّق على جميع الحاويات الكتلية (block containers) عدا حاويات الجداول. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* <integer> قيمة عددية */ column-count: 3; /* كلمة محجوزة */ column-count: auto; /* القيم العامة */ column-count: inherit; column-count: initial; column-count: unset; أمثلة مثال على استخدام الخاصية column-count وضبط قيمتها إلى 3: <p class="content-box"> هذه فقرةٌ نصيةٌ ستُقسَم إلى ثلاثة أعمدة باستخدام CSS، لاحظ أنَّ النص سيوزَّع بالتساوي بين ...

الخاصية font-stretch في CSS تختار نسخةً ضيقةً (condensed) أو عاديةً (normal) أو موسعةً (expanded) من الخط. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ font-stretch: ultra-condensed; font-stretch: extra-condensed; font-stretch: condensed; font-stretch: semi-condensed; font-stretch: normal; font-stretch: semi-expanded; font-stretch: expanded; font-stretch: extra-expanded; font-stretch: ultra-expanded; /* قيم عامة */ font-stretch: inherit; font-stretch: initial; font-stretch: unset; لا تؤدي هذه الخاصية إلى تغيير أبعاد الخط، وإنما هي طريقةٌ لاختيار أفضل نسخة من الخط إن كان الخط يوفِّر أكثر من نسخة. تبيين تأثير مختلف القيم ...

الخاصية outline في CSS هي خاصية مختصرة تُستخدَم لضبط خاصية أو أكثر من الخاصيات outline-style و outline-width و outline-color في آنٍ واحد. بطاقة الخاصية القيمة الابتدائية لكل خاصية مختصرة: outline-color: currentColor outline-style: none outline-width: medium تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للحركة نعم القيمة المحسوبة لكل خاصية مختصرة: outline-color: قيمة لونية outline-style: كما حُدِّدَت. outline-width: طول مطلق، إلا إذا حُدِّدَت الكلمة المحجوزة none فستكون القيمة المحسوبة 0. /* width | style | color */ outline: 1px solid white; /* القيم العامة */ outline: inherit; outline: initial; outline: unset; حدود العنصر ...

الخاصية column-span في CSS تسمح بأن يمتد أحد العناصر على جميع الأعمدة وذلك عند ضبط القيمة all لها. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على العناصر الكتلية. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* كلمات محجوزة */ column-span: none; column-span: all; /* القيم العامة */ column-span: inherit; column-span: initial; column-span: unset; أمثلة مثال عن استخدام القيمة all في الخاصية column-span على عناصر <h1>: <div class="content-box"> حسوب مجموعة من شركات الانترنت تخدم المستخدمين العرب حول العالم. تدير حسوب أكبر منصتي عمل حر عربية وأكبر ...

الخاصية text-indent في CSS تُحدِّد مقدار المسافة البادئة التي توضع قبل أسطر النص الموجودة في عنصر كتلي؛ وهذه الخاصية تتحكم بالمسافة البادئة لأوّل سطر افتراضيًا، لكن يمكن استخدام الكلمتين المحجوزتين hanging و each-line لتغيير هذا السلوك (انظر «دعم المتصفحات»). بطاقة الخاصية القيمة الابتدائية 0 تُطبَّق على العناصر الكتلية. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدت. /* <length> أطوال */ text-indent: 3mm; text-indent: 40px; /* <percentage> نسبة مئوية*/ text-indent: 15%; /* قيم عامة */ text-indent: inherit; text-indent: initial; text-indent: unset; تبدأ هذه المسافة من الحافة اليسرى لصندوق ...

الخاصية background-clip في CSS تُحدِّد كيف أين ستتوقف خلفية العنصر على حدود العنصر، سواءً كانت الخلفية لونًا <color> أو صورةً <image>. إذا لم يكن للعنصر الخاصية background-image أو background-color، فسيغطي إطار العنصر الفرق بين قيم هذه الخاصية إلا فيما ندر (نتيجة تأثير الخاصية border-style أو border-image). بطاقة الخاصية القيمة الابتدائية border-box تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ background-clip: border-box; background-clip: padding-box; background-clip: content-box; background-clip: text; /* القيم العامة */ background-clip: inherit; background-clip: initial; background-clip: unset; أمثلة ...

الخاصية list-style في CSS هي خاصية مختصرة تؤدي إلى ضبط قيم الخاصيات list-style-type و list-style-image و list-style-position. بطاقة الخاصية القيمة الابتدائية لكل قيمة مختصرة: list-style-type: disc list-style-position: outside list-style-image: none تُطبَّق على عناصر القوائم. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة لكل قيمة مختصرة: list-style-image: القيمة none أو رابط URI مطلق للصورة. list-style-position: كما حُدِّدَت. list-style-type: كما حُدِّدَت. /* type */ list-style: square; /* image */ list-style: url('../img/shape.png'); /* position */ list-style: inside; /* type | position */ list-style: georgian inside; /* type | image | position */ list-style: lower-roman url('../img/shape.png') outside; /* ...

الخاصية max-height في CSS تضبط الارتفاع الأقصى للعنصر، وهي تمنع القيمة المستخدمة (used value) للخاصية height من أن تتجاوز القيمة المُحدَّدة في الخاصية max-height. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر، ما عدا العناصر السطرية غير المُستبدَلة (non-replaced inline elements)، وأعمدة الجداول، ومجموعات الأعمدة. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة نسبة مئوية أو طول مطلق أو الكلمة المحجوزة none. /* <length> أطوال */ max-height: 3.5em; /* <percentage> نسب مئوية */ max-height: 75%; /* كلمات محجوزة */ max-height: none; /* قيم عامة */ max-height: ...

تضبط الخاصية background-color في CSS لون الخلفية لأحد العناصر، ويكون لون الخلفية قيمةً لونيةً <color>. بطاقة الخاصية القيمة الابتدائية transparent تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة القيمة المحسوبة للون. /* كلمات محجوزة */ background-color: red; /* قيمة ست عشرية */ background-color: #bbff00; /* قيم ست عشرية مع شفافية */ background-color: #11ffee00; background-color: #11ffeeff; /* استخدام دالة */ background-color: rgb(255, 255, 128); /* استخدام دالة تدعم الشفافية */ background-color: rgba(117, 190, 218, 0.0); background-color: rgba(117, 190, 218, 0.5); background-color: rgba(117, 190, 218, 1.0); ​​​​​​​ /* hsla() */ background-color: hsla(50, ...

الخاصية border-collapse في CSS تُحدِّد إذا كان إطار الجدول منفصلًا عن إطار الخلايا (أي لكلٍ واحدٍ منها إطارٌ خاصٌ به) أو كان مدمجًا مع إطار الخلايا (أي تتشارك الخلايا المتجاورة الإطار مع بعضها بعضًا). بطاقة الخاصية القيمة الابتدائية separate تُطبَّق على عناصر table و inline-table. قابلة للوراثة نعم قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ border-collapse: collapse; border-collapse: separate; /* القيم المحجوزة */ border-collapse: inherit; border-collapse: initial; border-collapse: unset; إذا كانت قيمة هذه الخاصية هي separate، فيمكن تعريف المسافة بين الخلايا باستخدام الخاصية ...

‎.fadeTo( duration, opacity [, complete ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يضبط هذا التابع درجة عتامة العناصر المطابقة. ‎.fadeTo( duration, opacity [, complete ] )‎ أُضيف مع الإصدار: 1.0. duration مدة الحركة وهو من النوع عدد Number أو سلسلة نصية String. opacity رقم من النوع Number يتراوح ما بين 0 و 1 ويشير إلى درجة العتامة المستهدفة. complete دالة على الشكل Function()‎‎، تُستدعى بمجرد اكتمال الحركة. ‎.fadeTo( duration, opacity [, easing ] [, complete ] )‎ ...

الخاصية visibility في CSS تسمح بإظهار أو إخفاء عنصر دون التأثير بتخطيط المستند، أي أنَّ المساحة ستُحجَز للعناصر سواءً كانت مرئيةً أو لا، ويمكن استخدام هذه الخاصية أيضًا لإخفاء أو إظهار الأعمدة في جدول <table>. بطاقة الخاصية القيمة الابتدائية visible تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للحركة نعم القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ visibility: visible; visibility: hidden; visibility: collapse; /* القيم العامة */ visibility: inherit; visibility: initial; visibility: unset; ملاحظة: إذا أردتَ إخفاء العنصر وإزالته من تخطيط المستند معًا، فاضبط الخاصية display إلى ...

الخاصية transform-origin في CSS تسمح بتحديد مبدأ الإحداثيات للتحويلات التي ستجرى على العنصر، فمثلًا سيكون مبدأ إحداثيات العنصر الافتراضي عند تطبيق الدالة rotate()‎ هو مركز العنصر. بطاقة الخاصية القيمة الابتدائية 50% 50% 0 تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. ستُطبَّق هذه الخاصية بنقل العنصر بمقدار قيمة هذه الخاصية مضروبةً بالعدد -1، ثم تطبيق التحويلات على العنصر، ثم تنقل العنصر بمقدار قيمة هذه الخاصية. /* قيمة واحدة */ transform-origin: 2px; transform-origin: bottom; /* x-offset y-offset */ transform-origin: ...

الخاصية font-size-adjust في CSS تقول أنَّ حجم الخط يجب أن يكون مُختارًا اعتمادًا على ارتفاع الأحرف الصغيرة (lowercase) بدلًا من ارتفاع الأحرف الكبيرة؛ وهذا مُفيدٌ لأنَّ وضوح الخطوط وسهولة قراءتها -خصوصًا إذا كان حجمها صغيرًا- سيُحدَّد بحجم الأحرف ذات الحالة الصغيرة وليس الكبيرة. بطاقة الخاصية القيمة الابتدائية none تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك نعم القيمة المحسوبة كما حُدِّدَت. /* استخدام حجم الخط المُحدَّد */ font-size-adjust: none; /* استخدام حجم خط سيجعل الأحرف الصغيرة بنصف ارتفاع حجم الخط المُحدَّد ...

الخاصية word-break في CSS تُحدِّد إذا كان على المتصفح الانتقال إلى سطر جديد ضمن الكلمات نفسها لمنع النص من تجاوز حدود صندوق المحتوى للعنصر الحاوي عليه. وعلى النقيض من الخاصية overflow-wrap، ستنتقل الخاصية word-break إلى سطرٍ جديد عند المكان الذي كان سيتجاوز النص فيه حدود صندوق المحتوى، حتى لو كان وضع الكلمة في سطرٍ بمفردها سيؤدي إلى عدم تجاوزها حدود صندوق المحتوى. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على جميع العناصر. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما ...

الخاصية grid-gap في CSS هي خاصيةٌ مختصرةٌ تضبط قيمة الخاصيتين grid-row-gap و grid-column-gap، وهي تُحدِّد المسافة التي تفصل بين الأسطر والأعمدة في حاوية gird. بطاقة الخاصية القيمة الابتدائية لكل خاصية مختصرة: grid-row-gap: 0 grid-column-gap: 0 تُطبَّق على حاويات gird. قابلة للوراثة لا قابلة للتحريك نعم القيمة المحسوبة لكل خاصية مختصرة: grid-row-gap: نسبة مئوية أو طول مطلق. grid-column-gap: نسبة مئوية أو طول مطلق. /* <length> القيم الطولية */ grid-gap: 20px; grid-gap: 1em; grid-gap: 3vmin; grid-gap: 0.5cm; /* <percentage> النسب المئوية */ grid-gap: 10%; /* <length> قيمتان طوليتان */ grid-gap: 20px 10px; grid-gap: 1em 0.5em; grid-gap: ...

تنشئ الدالة البانية لهذا الصنف كائنًا يعمل كقارئ عادي ولكنّه يربط المعلومات في كل سطر بقاموس مرتّب OrderedDict تحدّد مفاتيحه بواسطة المعامل الاختياري fieldnames. البنية العامة csv.DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', *args, **kwds) ‎المعاملات ‎f ملف csv المراد قرائته. fieldnames معامل اختياري، وهو عبارة عن تسلسل. إن لم يُستخدم هذا المعامل فإنّ القيم الموجودة في السطر الأول من الملف المفتوح ستُستخدم كأسماء للحقول. وبصرف النظر عن طريقة تحديد أسماء الحقول فإنّ القاموس المرتّب سيحافظ دائمًا على ترتيبها الأصلي. restkey إن ...

يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. البنية العامة TarFile.extractall(path=".", members=None, *, numeric_owner=False) المعاملات ‎memebers معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع getmembers()‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين: يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه. إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة feof()‎ من الوصول إلى نهاية ملف (EOF) بتمرير المقبض الذي يشير إلى الملف. الوصف bool feof ( resource $handle ) تتحقَّق هذه الدالة من الوصول إلى نهاية ملف (EOF) بتمرير المقبض handle الذي يشير إلى الملف. المعاملات handle مقبض (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد القيمة TRUE إن وصل مقبض ...

يعيد هذا التابع موقع بداية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. البنية العامة match.start([group]) المعاملات group المجموعة التي سيستخدمها التابع لمطابقة السلسلة النصية معها. يأخذ المعامل group القيمة الافتراضية 0 (أي أن التطابق حصل في السلسلة النصية الفرعية بأكملها). القيمة المعادة يعيد التابع موقع بداية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. ويعيد التابع القيمة ‎-1 إن كانت المجموعة موجودة ولكنّها لا تساهم في حالة التطابق. لو فرضنا وجود كائن تطابق m ومجموعة g تساهم في حالة التطابق، فإن ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة opendir()‎ مجلَّدًا محدَّدًا. الوصف resource opendir ( string $path [, resource $context ] ) تفتح هذه الدالة المجلَّد ذي المسار path ثمَّ تعيد مقبضًا له يمكن أن يُستعمل لاحقًا مع الدالة closedir()‎ والدالة readdir()‎ والدالة rewinddir()‎. المعاملات path مسار المجلَّد المُراد فتحه. context راجع قسم المجرى (stream) للمزيد من الشرح عن المعامل context. القيم المعادة يُعاد مورد مقبض المجلَّد عند نجاح العمليَّة، أو القيمة FALSE عند فشلها. إن كان المسار path خطأً ولا ...

لعلّك لاحظت أن بالإمكان المرور على عناصر معظم الكائنات الحاوية (container objects) (مثل القوائم والقواميس والسلاسل النصية وغيرها...) باستخدام عبارة for: for element in [1, 2, 3]:     print(element) for element in (1, 2, 3):     print(element) for key in {'one':1, 'two':2}:     print(key) for char in "123":     print(char) for line in open("myfile.txt"):     print(line, end='') تستدعي عبارة for خلف الكواليس الدالة iter()‎ على الكائن الحاوي، فتعيد الدالة كائن تكرار (iterator object) يعرّف التابع ‎__next__‎()‎ الذي يستطيع الوصول إلى عنصر واحد في الكائن الحاوي ...

تتيح وحدة linecache قراءة أسطر الملفات بفعالية، حيث تمت أمثلة العمليات ضمن هذه الوحدة باستخدام مبدأ الكاش cache التي تظهر فائدتها عند الحاجة إلى قراءة العديد من الأسطر من الملف، وتُستخدم هذه الوحدة ضمن الوحدة traceback التي تسترجع أسطرًا من شيفرات بايثون المصدرية لتضمينها ضمن رسالة الخطأ المنسقة. يُستخدم التابع tokenize.open لفتح الملفات، وهذا التابع يستخدم tokenize.detect_encoding لقراءة ترميز الملف في حال غياب الرمز الخاص بالترميز المستخدم، ويُعتبر الترميز الافتراضي للملفات هو UTF-8. مُلاحظة: تستخدم هذه الوحدة داخليًّا ضمن بايثون ...

يجلب التابع الخيار المحدّد من القسم المعطى. البنية العامة get(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎section اسم القسم الذي سيجلب التابع الخيار منه. option قيمة الخيار المراد جلبه. يبحث التابع عن قيمة المعامل option في vars (إن كان متوفّرًا) ثم في section ثم في DEFAULTSECT. raw يوسّع التابع جميع عمليات الاستيفاء التي تستخدم الرمز '%' في القيمة المعادة إلا إذا كان إذا أخذ المعامل raw القيمة True. vars معامل اختياري، يجب أن تكون قيمته قاموسًا. fallback في حال عدم ...

تبدل الدالة حالات التطابق غير المتداخلة في أقصى اليسار -والناتجة عن تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة- بسلسلة نصية أو بالقيمة المعادة من دالة. البنية العامة re.sub(pattern, repl, string, count=0, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. يمكن للنمط أن يكون سلسلة نصية أو كائن نمط pattern object. repl يمكن للبديل repl أن يكون سلسلة نصية أو دالة، وإن كان سلسلة نصية، فإنّ الدالة تعالج جميع المحارف المهرّبة فيها. بمعنى أنّ ‎\n تحوّل إلى محرف سطر ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة file_exists()‎ من وجود ملف أو مجلَّد محدَّد. الوصف bool file_exists ( string $filename ) تتحقَّق هذه الدالة إن كان الملف أو المجلَّد filename موجودًا أو لا. المعاملات filename مسار الملف أو المجلَّد المُراد التحقُّق من وجوده. استعمل على ويندوز المسار ‎//computername/share/filename أو ‎\\computername\share\filename للتحقُّق من الملفات المُشاركة على الشبكة. القيم المعادة تُعاد القيمة TRUE إن كان الملف أو المجلَّد المحدَّد بوساطة المعامل filename موجودًا، وتُعاد القيمة FALSE إن لم يكن. ملاحظة: ستعيد هذه ...

تنشئ الدالة البانية لهذا الصنف كائنًا يعمل ككاتب عاديٍّ ولكنّه يربط القواميس بالأسطر الموجودة في ملف csv. البنية العامة csv.DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds) ‎المعاملات ‎f ملف csv الذي ستجري الكتابة فيه. fieldnames تسلسل من المفاتيح التي تحدّد ترتيب القيم في القاموس الذي سيمرّر إلى التابع writerow()‎ لكتابة الأسطر في الملف المعطى. يجب الانتباه إلى أنّه وعلى عكس الصنف DictReader فإنّ المعامل fieldnames في الصنف DictWriter ليس اختياريًا. restval معامل اختياري، يحدّد القيمة التي ستُستخدم في حال وجود ...

يحرِّك التابع seek المؤشِّر الحالي في المجرى ARGF إلى موقع محدد. البنية العامة seek(amount, whence=IO::SEEK_SET) → 0 المعاملات amount قيمة إزاحة موقع المؤشِّر بالبايت. إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل amount ثمَّ حدِّد القيمة ‎:END أو IO::SEEK_END للمعامل whence. whence قيمة هذا المعامل هي إحدى القيم التالية: ‎:SET أو IO::SEEK_SET: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت انطلاقًا من البداية. ‎:CUR أو IO::SEEK_CUR: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت ...

الخاصية overflow في CSS تُحدِّد إن كان سيتم اقتصاص (clip) المحتوى، أو سيُعرَض شريط تمرير (scroll bar)، أو سيُعرَض ما يزيد من محتوى العنصر الكتلي عند تجاوزه أبعاد الحاوية الكتلية التي هو فيها. بطاقة الخاصية القيمة الابتدائية visible تُطبَّق على عناصر block-level و inline-block غير المُستبدَلة (non-replaced). قابلة للوراثة لا قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* لن يتم اقتصاص المحتوى */ overflow: visible; /* سيتم اقتصاص المحتوى دون عرض شريط تمرير */ overflow: hidden; /* سيتم اقتصاص المحتوى مع عرض شريط تمرير ...