نتائج البحث

يتحقَّق التابع ?key إذا كان المفتاح مُسجّلًا (registered). البنية العامة key?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع keys على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة keys() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع keys في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?include إذا كان المفتاح مُسجّلًا (registered). البنية العامة include?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?include في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_pair على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_pair() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_pair في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

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

في هذا القسم جميع التعابير البرمجية الموجودة في لغة JavaScript. التحكم في التنفيذ block تُستخدَم الأقسام الكتلية لتجميع عدِّة تعابير برمجية معًا، ويُعرَّف القسم بزوجين من الأقواس المعقوفة {}. break يإنهاء حلقة التكرار الحالية أو التعبير switch أو label، وستنقل تنفيذ البرنامج إلى التعبير البرمجي الذي يلي التعبير الذي انتهى. continue تجاوز تنفيذ التعابير البرمجية في التكرار الحالي (iteration) في حلقة التكرار الحالية أو حلقة التكرار المسماة (عبر لافتة)، وسيستمر تنفيذ الحلقة بدءًا من التكرار التالي. Empty يُستخدَم لتجنب توفير تعبير برمجي في ...

يعالج التابع استجابات HTTP التي تتضمن أخطاءً. البنية العامة HTTPErrorProcessor.http_response(request, response) القيمة المعادة يعاد كائن الاستجابة مباشرة في الأخطاء ذات الرمز 200. أما في حال ظهور الأخطاء الأخرى فإنّ العمل ينتقل إلى توابع المعالجة protocol_error_code()‎ بواسطة التابع OpenerDirector.error()‎. ويُطلق الصنف المعالج HTTPDefaultErrorHandler استثناء من نوع HTTPError في حال عدم معالجة الخطأ من قبل أيّ صنفٍ معالج. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تغلّف هذه الدالة التطبيق المعطى وتعيد كائن تطبيق WSGI جديد، وسيوجّه التطبيق المعاد جميع الطلبات إلى التطبيق الأصلي، وسيتحقّق من أنّ كلًّا من التطبيق والمخدّم الذي يستدعيه متوافقان مع معايير WSGI وللبروتوكول RFC 2616. يؤدي وجود أيّ حالة من حالات عدم التوافق إلى إطلاق الخطأ AssertionError، ولكن يجب الانتباه إلى أنّ طريقة التعامل مع هذه الأخطاء تعتمد على المخدّم، فعلى سبيل المثال يعطي المخدّم wsgiref.simple_server و المخدّمات المستندة على أصناف الوحدة wsgiref.handlers (والتي لا تعيد تعريف توابع التعامل مع الأخطاء ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetcsv()‎ سطرًا واحدًا من ملف ذي الصيغة CSV (اختصارًا للعبارة comma-separated values) وتحلِّله ثمَّ تعيد مصفوفة بالقيم التي قرأتها. الوصف array fgetcsv ( resource $handle [, int $length = 0 [, string$delimiter = "," [, string $enclosure = '"' [, string $escape = "\\"]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة fgets()‎ باستثناء أنَّها تحلِّل السطر الذي تجلبه من ملف بصيغة CSV إلى حقول ثمَّ تعيد مصفوفةً تحوي تلك الحقول التي قرأتها ...

تتحقَّق الدالة mixin_exists()‎ إذا كان مخلوطٌ (mixin) ما موجودًا أم لا. البنية العامة mixin_exists($name) المعاملات ‎$name اسم المخلوط المراد التحقَّق من وجوده. القيم المعادة تُعاد القيمة المنطقيَّة TRUE إذا كان المخلوط ذو الاسم ‎$name مُعرّفًا، أو القيمة FALSE خلاف ذلك. أمثلة مثال عن استخدام الدالة mixin_exists()‎: @debug mixin-exists(nonexistent); // false @mixin red-text { color: red; } @debug mixin-exists(red-text); // true انظر أيضًا الدالة function_exists()‎: تتحقَّق ما إذا كانت دالة ما موجودة. الدالة global_variable_exists()‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام. ...

الكائنات العامة في هذا القسم جميع الكائنات العامة المُضمَّنة في لغة JavaScript، إضافةً إلى جميع الخاصيات والدوال التابعة لها. الخاصيات العامة هذه الخاصيات العامة تُعيد قيمةً بسيطةً، فهي لا تُمثِّل دوالًا أو خاصياتٍ تابعة لأحد الكائنات. Infinity NaN undefined null الدوال العامة هذه الدوال العامة -أي التي تستدعى في النطاق العام بدل استدعائها على كائن بعينه- تُعيد نتائجها إلى التعبير البرمجي الذي استدعاها. eval()‎‎ isFinite()‎ isNaN()‎ parseFloat()‎ parseInt()‎ decodeURI()‎ decodeURIComponent()‎ encodeURI()‎ encodeURIComponent()‎ escape()‎ unescape()‎ الكائنات الأساسية هذه هي الكائنات الأساسية ...

يجب أن تكون جميع الاستثناءات في لغة بايثون مُنشأة من صنف مُشتق من الصنف BaseException. عند ذكر صنف مُحدد في جملة except خلال تعبير try، فإن جملة except تُعالج أي استثناء مُشتق من ذلك الصنف المُحدَّد (وليس الاستثناءات المُشتقة من الصنف الذي اُشتقت منه). إذا كان لدينا صنفا استثناءات غير مرتبطين بعلاقة وراثة فهما غير متماثلان حتى لو كانا بنفس الاسم. من الممكن توليد الاستثناءات الداخلية المذكورة بالأسفل بواسطة مُفسر بايثون أو الدوال الداخلية.  تملك الاستثناءات "قيمة مرتبطة" تُشير بالتفصيل ...

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

يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. البنية العامة datetime.utcfromtimestamp(timestamp) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. القيمة المعادة يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة gmtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverflowError، وإن حدث خطأ في تنفيذ الدالة gmtime()‎ فإنّ ...

مقدمة JSX بنيةٌ (syntax) مشابهةٌ للغة XML يُمكن تضمينها وتحويلها إلى شيفرة JavaScript صالحة، لكن آلية عملية التحويل تختلف من تطبيق (implementation) إلى آخر. اشتهرت JSX باستخدامها مع مكتبة React، لكنها تملك تطبيقات أخرى غير React. تدعم لغة TypeScript تضمين JSX، وتدقيق الأنواع فيها، وكذا ترجمة JSX إلى JavaScript مباشرةً. ملاحظة حول المصطلحات: نستخدم في هذه الصّفحة كلمة "صِفَة" للإشارة إلى الكلمة الإنجليزيّة "attribute" وكلمة "خاصيّة" للإشارة إلى كلمة "property"، كلاهما يُترجَم إلى كلمة "خاصيّة" ولهما نفس المعنى في معظم ...

تقدّم وحدة urllib.request عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL‏ (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها. ملاحظة: يُنصح باستخدام الحزمة Requests في العمليات المتقدّمة لأنّها توفّر واجهة برمجية ذات مستوى أعلى. دوالّ الوحدة urllib.request تقدّم وحدة urllib.request الدوال التالية: الدالة urllib.request.urlopen()‎ تفتح الدالة عنوان URL المعطى. urllib.request.install_opener()‎ تثبّت الدالة نسخة من الصنف OpenerDirector كفاتح opener افتراضي عام. urllib.request.build_opener()‎ تعيد الدالة نسخة من الصنف OpenerDirector والتي تربط ...

تعدُّ كائنات الاستثناءات في روبي أصنافًا فرعيةً (subclasses) من الصنف Exception. على أي حال، تُبلِّغ أنظمة التشغيل عادةً عن الأخطاء باستخدام أعدادٍ صحيحةٍ مبسّطةٍ (plain integers). تُنشَأ الوحدة Errno ديناميكيًّا لتنظيم تفاصيل هذه الأخطاء الناتجة عن أنظمة التّشغيل وإرسالها إلى أصناف روبي، مع توليد صنف فرعي من الصنف SystemCallError خاص بكل رقم خطأٍ. عند إنشاء الصّنف الفرعي في الوحدة Errno، ستبدأ تسميته بالاسم ::Errno. تعتمد أسماء الأصناف ::Errno تعتمد على البيئة التي تعمل فيها روبي. ففي منصة يونكس أو ويندوز ...

تعيد الدالة simple_selectors()‎ المحدّدات البسيطة التي يتركّب منها المحدّد المركّب المُمرَّر إليها. لاحظ أنّ المحدِّد ‎$selector المرَّر إلى الدالة ينبغي أن يكون محدِّدًا مركَّبًا. هذا يعني أنَّه لا يمكن أن يحتوي على فواصل أو مسافات، ويعني ذلك أيضًا أنَّ هذه الدالة لا تقبل سوى سلاسل نصيَّة وليس القوائم بخلاف دوال المحدَّدات الأخرى. البنية العامة simple_selectors($selector) المعاملات ‎$selector المُحدد المُركَّب المراد استخراج المحدَّدات البسيطة التي يتركَّب منها. القيم المعادة تُعاد قائمة بالمحدِّدات البسيطة الموجودة في المحدِّد المركَّب ‎$selector. أمثلة أمثلة نموذجية ...

المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

عام قد تجد حالات لا تريد فيها من يستخدم شيفراتك النصية أن يخرج قبل الوقت المحدد عن طريق اختصارات لوحة المفاتيح حين تحتاج إلى مدخلات مثلًا أو عند القيام بعملية تنظيف، ويمكن استخدام أمر trap ليلتقط إشارات لوحة المفاتيح تلك، ويمكن برمجته مسبقًا لينفِّذ قائمة أوامر عند التقاط تلك الإشارات. قواعد أمر trap واضحة ومباشرة: trap [الإشارات] [الأوامر] هذا يجعل أمر trap يلتقط الإشارات المُعطاة له، والتي قد تكون أسماء إشارات مع سابقة SIG أو بدونها، أو تكون أرقام إشارات. وإن ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعيد تعريفه إن كانت معدّة لالتقاط جميع أخطاء HTTP غير المعالجة. يُستدعى هذا التابع تلقائيًا بواسطة كائن OpenerDirector الذي يتلقّى الخطأ، ويجب عدم استدعائه في الظروف الأخرى. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.http_error_default(req, fp, code, msg, hdrs) المعاملات req سيكون كائن Request. fp سيكون كائنًا شبيهًا بالملفات مع متن ...

يكتب التّابع Document.write‎()‎ سلسلةً نصيّةً إلى مجرى (stream) مستندٍ فُتح بالتّابع window.open‎()‎. مُلاحظة: لأنّ التّابع Document.write‎()‎ يكتب إلى مجرى المستند، فاستدعاؤه على مستندٍ مُغلقٍ (مُحمَّل) يستدعي تلقائيًّا التّابع Document.open‎()‎، الذي سيحذف محتويات المستند. البنية العامة document.write(markup); markup سلسلة نصيّة تحتوي على النّص المرغوب كتابته على المستند. مثال <!DOCTYPE html> <html> <head> <title>write مثال</title> <script> function newContent() { alert("تحميل محتوى جديد"); document.open(); document.write("<h1>المحتوى ...

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

يجب أن تكون nnn عددًا من ثلاث مراتب يمثّل شيفرة خطأ HTTP. هذا التابع غير معرّف في الصنف BaseHandler أيضًا، ولكن سيُستدعى إن كان موجودًا على نسخة من الصنف المتفرّع عن الصنف BaseHandler عند حدوث خطأ HTTP يحمل الشيفرة nnn. يجب على الأصناف الفرعية أن تعيد تعريف هذا التابع لمعالجة أخطاء HTTP معيّنة. البنية العامة BaseHandler.http_error_nnn(req, fp, code, msg, hdrs) يجب أن تكون المعاملات والقيم المعادة والاستثناءات المُطلقة مشابهة لنظيراتها في التابع http_error_default()‎. مصادر صفحة Extensible library for opening URLs ...

يغطي هذا الدليل دمج ريلز مع Rack والتفاعل مع مكونات Rack الأخرى. بعد قراءة هذا الدليل، ستتعلم: كيفية استخدام برمجيات Rack الوسيطة في تطبيقات ريلز الخاصة بك. حزمة البرمجيات الوسيطة الداخلية لـ Action Pack. كيفية تعريف مكدس برنامج وسيط مخصص (custom Middleware stack). تحذير: يفترض هذا الدليل معرفة عملية ببروتوكول Rack وبمفاهيم Rack مثل البرمجيات الوسيطة (middlewares) وخرائط url و Rack::Builder. مقدمة إلى Rack يوفر Rack واجهة دنيا، ومركبة من وحدات، وقابلة للتهيئة لتطوير تطبيقات الويب في روبي. من خلال ...

أنواع البيانات أنواع البيانات التي يمكن استخدامها مع محركات قواعد البيانات المختلفة (البيانات العددية، والبيانات النصية، والوقت والتاريخ، والبيانات الثنائية ...إلخ.). أساسيات لغة SQL القيمة NULL يستخدم التعبير IS NULL للتأكد من خلو القيمة (أي لا توجد قيمة في الحقل المحدد). التعليقات Comments تضاف التعليقات إلى الشيفرة بهدف تسهيل قراءتها أو كتابة ملاحظات جانبية مساعدة. SELECT count(*); -- This comment continues to the end of line SELECT count(*); /* This is an inline ...

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

يُعيد التّابع last_error الكائن exception عند حصول خطأٍ في آخر عملية تحويل أو يعيد القيمة nil إن لم يحصل أي خطأ. تشير القيمة "error" إلى أنَّ الخطأين Encoding::InvalidByteSequenceError وEncoding::UndefinedConversionError نتجا من التّابع convert، وأنَّ invalid_byte_sequence: وincomplete_input: و undefined_conversion: نتجوا من التّابع primitive_convert. البنية العامة last_error → exception or nil القيم المعادة يُعاد الكائن exception عند حصول خطأٍ في آخر عملية تحويل، أو تعاد القيمة nil إذا جرى التحويل الأخير من دون أخطاءٍ. أمثلة مثالٌ عن استخدام التابع last_error: ec = ...

يعيد المعامل [] كائنًا ذو مرجع ضعيف (weakly referenced) مع المفتاح المُعطى. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. انظر أيضًا المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل [] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يعيد المعامل [] كائنًا ذو مرجع ضعيف (weakly referenced) مع المفتاح المُعطى. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. انظر أيضًا المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل [] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يُنشئ المعامل =[] مرجعًا ضعيفًا (weak reference) من المفتاح المُعطى إلى القيمة المعطية. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. p2 القيمة المعطية. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل =[] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يُنشئ المعامل =[] مرجعًا ضعيفًا (weak reference) من المفتاح المُعطى إلى القيمة المعطية. البنية العامة [](p1) المعاملات p1 المفتاح المُعطى. p2 القيمة المعطية. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة المعامل =[] في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

تعيد الدالة ()blue‎ المكوِّن الأزرق للون الممرَّر إليها. قد تُحسب قيمته من الصيغة HSL عند الضرورة عبر هذه الخوارزمية. البنية العامة blue($color) المعاملات ‎$color اللون المراد الحصول على قيمة مكوِّنه الأزرق. القيم المعادة تُعاد قيمة المكوِّن الأزرق للون ‎$color، وتترواح بين 0 و 255. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة إحدى طرائق التحقق أنَّ اللون فاتح أو غامق هو التحقق من قيمة السطوع (الدالة lightness()‎)، وعلى الرغم من أنَّ هذه الطريقة صحيحة تقنيًا، لكنها ...

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

(PHP 5, PHP 5.4.0, PHP 7) توقف الدالة session_register_shutdown()‎ تشغيل الجلسة. الوصف void session_register_shutdown ( void ) توقف الدالة session_register_shutdown()‎ تشغيل الجلسة. المعاملات لا توجد معاملات. القيم المعادة لا توجد قيم معادة. أخطاء واستثناءات سيُولَّد الخطأ E_WARNING إذا فشل تسجيل إغلاق الجلسة. مصادر صفحة الدالة session_register_shutdown في توثيق PHP الرسمي.

يعيد التابع سلسلة نصية تمثّل الوقت بصيغة المعيار ISO 8601. البنية العامة ‎time.isoformat(timespec='auto') المعاملات timespec يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي: 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'. 'hours': تضمين الساعة بهيئة رقمين HH. 'minutes': تضمين الساعة والدقيقة بالصيغة HH:MM. 'seconds': تضمين الساعة والدقيقة والثانية بالصيغة HH:MM:SS. 'milliseconds': تضمين الوقت كاملًا، مع اقتطاع قيم الثانية الكسرية ...

التعبير ‎#define هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. الثوابت المعرَّفة باستعمال هذا التعبير في أردوينو لا تحتل أيَّة مساحةٍ من ذاكرة البرنامج على الشريحة (chip). سيبدِّل المفسِّر (compiler) القيمة المعرَّفة مكان المراجع التي تشير إلى هذه الثوابت أثناء عملية تصريف الشيفرة. انتبه إلى أنَّ استعمال التعبير ‎#define في تعريف الثوابت كما ذُكِر آنفًا له آثار جانبية غير مرغوبة مثل استعمال اسم ثابت عُرِّف في ‎#define مع اسم ثابت أو متغير ...

تستخدم صيغة IF لاختبار شرط معين للتأكّد من تحقّقه أو عدم تحقّقه وإجراء ما يتناسب مع ذلك، وتكون البنية العامة لها بالشكل الآتي: IF condition THEN statements [ ELSEIF condition THEN statements [ ELSEIF condition THEN statements ...]] [ ELSE statements ] END IF; إذ تعبّر الكلمة condition عن الشرط المُختبَر، وكلمة statements عن التعليمات التي ستُجرى أو قد تكون تعابير بدلًا من التعليمات. ويلاحظ  في محركي PostgreSQL و Oracle أن الكلمة المفتاحية ELSEIF تصبح ELSIF، وفي محرك SQL Server ...

مقدمة تُقدِّم خاصيّة التوطين في Laravel طريقةً مريحةً وسهلةً لإعطاء ترجمات للكلمة في عدّة لغات، ممّا يسمح للتطبيق بدعم لغات متعدّدة. تُحفظ سلاسل المحارف الخاصّة بكل لغة يدعمها التطبيق في المجلد resources/lang. يحتوي هذا الملف على مجلدٍ فرعي لكل لغة يدعمها التطبيق: /resources /lang /en messages.php /es ...

مقدمة تُقدِّم خاصيّة التوطين في Laravel طريقةً مريحةً وسهلةً لإعطاء ترجمات للكلمة في عدّة لغات، ممّا يسمح للتطبيق بدعم لغات متعدّدة. تُحفظ سلاسل المحارف الخاصّة بكل لغة يدعمها التطبيق في المجلد resources/lang. يحتوي هذا الملف على مجلدٍ فرعي لكل لغة يدعمها التطبيق: /resources /lang /en messages.php /es ...

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

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

يعيد هذا التابع التاريخ المحلّي والموافق للختم الزمني بصيغة POSIX كالذي يعيده التابع time.time()‎. البنية العامة date.fromtimestamp(timestamp) المعاملات timestamp الختم الزمني بصيغة POSIX والمراد معرفة التاريخ المحلي الموافق له. يعيد التابع time.time()‎ ختمًا زمنيًا بصيغة POSIX. القيمة المعادة إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة localtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverflowError، وإن حدث خطأ في تنفيذ الدالة localtime()‎ فإنّ التابع يطلق الخطأ OSError. من الشائع أن يكون استخدام هذا التابع مقصورًا على السنوات 1970 ...

تشبه هذه الوحدة إلى حدٍّ كبير الوحدة dbm، ولكنّها تستخدم مكتبة غنو gdbm لتقديم بعض الوظائف الإضافية. ويجب الانتباه إلى أنّ صيغ الملفات التي تنشئها dbm.gnu و dbm.ndbm غير متوافقة مع بعضها البعض. تقدّم وحدة dbm.gnu واجهة للتعامل مع مكتبة GNU DBM. وتسلك كائنات dbm.gnu.gdbm سلوك كائنات الربط (القواميس) باستثناء أنّ المفاتيح والقيم تحوّل دائمًا إلى بايتات قبل تخزينها. لا تؤدي طباعة كائن gdbm إلى طباعة المفاتيح والقيم، ولا تدعم هذه الكائنات التابعين items()‎ و values()‎. الاستثناءات الاستثناء exception dbm.gnu.error ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filesize()‎ حجم الملف. الوصف int filesize ( string $filename ) تعيد هذه الدالة حجم الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد حجم الملف filename بواحدة البايت أو القيمة FALSE مع توليد خطأ من المستوى E_WARNING عند حصول أي خطأ. ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد تعيد بعض دوال نظام الملفات نتائج مخالفة ...

من المفيد أن يتحقّق المبرمج عند إنشائه لكائنات تطبيقات WSGI أو أطر العمل أو المخدمات أو البرمجيات الوسيطة middleware من أنّ الشيفرة الجديدة مطابقة لمعايير WSGI؛ ويمكن أداء بذلك باستخدام الوحدة wsgiref.validate. تقدّم هذه الوحدة دالة تُنشئ كائن تطبيق WSGI وتتحقّق من تواصله مع مخدّم أو بوابة WSGI لضمان مطابقة الجانبين للبروتوكول. يجدر التنبيه إلى أنّ هذه الدالة لا تضمن التوافق التام مع المعيار PEP 3333، وعدم كشف هذه الوحدة عن الأخطاء لا يعني بالضرورة خلوّ الشيفرة من الأخطاء. ولكن ...

تعيد الدالة ()red قيمة المكوِّن الأحمر للون الممرَّر إليها. تُحسب القيمة من الصيغة HSL عند الضرورة عبر هذه الخوارزمية. البنية العامة red($color) المعاملات ‎$color اللون المراد الحصول على قيمة مكوِّنه الأحمر. القيم المعادة تُعاد قيمة المكوِّن الأحمر للون ‎$color، وتتراوح بين 0 و 255. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة إحدى طرائق التحقق أنَّ اللون فاتح أو غامق هو التحقق من قيمة السطوع (الدالة lightness()‎)، وعلى الرغم من أنَّ هذه الطريقة صحيحة تقنيًا، لكنها قد ...

تعيد الدالة ()green‎ قيمة المكوِّن الأخضر للون الممرَّر إليها. تُحسب القيمة من الصيغة HSL عند الضرورة عبر هذه الخوارزمية. البنية العامة green($color) المعاملات ‎$color اللون المراد الحصول على قيمة مكوِّنه الأخضر. القيم المعادة تُعاد قيمة المكوِّن الأخضر للون ‎$color، وتتراوح بين 0 و 255. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة إحدى طرائق التحقق أنَّ اللون فاتح أو غامق هو التحقق من قيمة السطوع (الدالة lightness()‎)، وعلى الرغم من أنَّ هذه الطريقة صحيحة تقنيًا، لكنها ...

يمثل الصنف InstructionSequence تسلسلًا مصرّفًا (compiled sequence) للتعليمات الخاصة بالآلة الافتراضية (Virtual Machine) لروبي. يمكّنك هذا الصنف من الحصول على مؤشر (handle) للتعليمات التي تشكل التابع أو الكتلة البرمجية، وتصريف (compile) سلاسل روبي النصية إلى تعليمات الآلة الافتراضية (VM)، وتفكيك التعليمات إلى سلاسل نصية لتسهيل فحصها. هذا الصنف مفيد للغاية إن كنت ترغب في معرفة كيفية عمل آلة روبي الافتراضية، لكنه يتيح لك أيضًا التحكم في إعدادات المُصرِّف iseq لروبي. يمكنك العثور على مصدر إرشادات الآلة الافتراضية في الصفحة insns.defفي ...

الدالة catch()‎ تعيد وعدًا Promise وتتعامل مع حالات رفض الوعود فقط. وهي تسلك نفس سلوك استدعاء الدالة Promise.prototype.then(undefined, onRejected)‎. وفي الواقع، استدعاء الدالة obj.catch(onRejected)‎ سيستدعي الدالة obj.then(undefined, onRejected)‎ داخليًا. var promise1 = new Promise(function(resolve, reject) { throw 'Uh-oh!'; }); promise1.catch(function(error) { console.log(error); }); // Uh-oh! البنية العامة p.catch(onRejected); p.catch(function(reason) { // التعامل مع الرفض }); المعاملات onRejected دالة تستدعى عند رفض الوعد Promise. هذه الدالة تملك معاملًا وحيدًا: reason سبب الرفض. الوعد المُعاد من الدالة catch()‎ سيُرفَض إذا رمت الدالة onRejected أو ...

تطلق اللغة هذا الاستثناء عند تمرير سلسلة نصية غير صالحة كتعبير نمطي إلى إحدى الدوال السابقة (كأن تتضمن السلسلة أقواسًا غير متطابقة)، أو عند حدوث أخطاء أخرى أثناء عملية التصريف أو المطابقة. لا يعد خلوّ السلسلة النصية من التطابقات خطأً على الإطلاق. البنية العامة re.error(msg, pattern=None, pos=None) الخاصيات تمتلك نسخة الخطأ الخصائص الإضافية التالية: msg رسالة الخطأ غير المنسّقة. pattern التعبير النمطي. pos موقع حدوث الخطأ في تصريف التعبير النمطي (قد يأخذ القيمة None). lineno السطر الحاوي على قيمة الخاصية ...

التابع الباني Constructor void __construct ([ mixed $args = "" [, $... ]] ) تتيح لغة PHP للمطورين التصريح عن تابع بانٍ في الأصناف. كل صنف يمتلك تابعًا بانيًا يُستدعى مع كل كائن جديد يُنشأ من ذلك الصنف؛ لهذا يعد هذا التابع ملائمًا لعمليات التهيئة التي قد يحتاج لها الكائن قبل استخدامه. ملاحظة: لا يُستدعى التابع الباني الأب ضمنيًا عندما يعرّف الصنف الابن تابعه الخاص، ولاستدعاء التابع الباني الأب يمكن استخدام الصيغة parent::__construct()‎ ضمن التابع الباني الابن. أما في حال ...

التابع الباني Constructor void __construct ([ mixed $args = "" [, $... ]] ) تتيح لغة PHP للمطورين التصريح عن تابع بانٍ في الأصناف. كل صنف يمتلك تابعًا بانيًا يُستدعى مع كل كائن جديد يُنشأ من ذلك الصنف؛ لهذا يعد هذا التابع ملائمًا لعمليات التهيئة التي قد يحتاج لها الكائن قبل استخدامه. ملاحظة: لا يُستدعى التابع الباني الأب ضمنيًا عندما يعرّف الصنف الابن تابعه الخاص، ولاستدعاء التابع الباني الأب يمكن استخدام الصيغة parent::__construct()‎ ضمن التابع الباني الابن. أما في حال ...

يعيد التابع as_integer_ratio()‎ زوجًا من الأعداد الصحيحة التي تكون نسبتها مساوية للعدد العشري تمامًا، ويكون المقام في هذه النسبة موجبًا. البنية العامة x.as_integer_ratio() يطلق التابع خطأً من نوع OverflowError عند استخدام قيم ما لا نهاية، والخطأ ValueError عند استخدام قيم NaN. أمثلة يبيّن المثال التالي طريقة استخدام التابع as_integer_ratio()‎ والقيم التي يعيدها: >>> f = 4.0 >>> f.as_integer_ratio() (4, 1) >>> f = 1.5 >>> f.as_integer_ratio() (3, 2) >>> f = 1.2 >>> f.as_integer_ratio() (5404319552844595, 4503599627370496) انظر أيضًا الأعداد الصحيحة في بايثون. الأعداد العشرية في بايثون. التابع float.is_integer()‎: اختبار ...

تنشئ الدالة ()rgb لونًا انطلاقًا من تمرير قيمة المكوِّنات الثلاث: الأحمر والأخضر والأزرق. البنية العامة rgb($red, $green, $blue) المعاملات ‎$red قيمة المكوِّن الأحمر في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ‎100%. ‎$green قيمة المكوِّن الأخضر في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ‎100%. ‎$blue قيمة المكوِّن الأزرق في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ‎100%. القيم المعادة يُعاد لون جديد قيمة مكوناته ...

يُستعمَل العنصر <video> لتضمين المحتوى المرئي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب صيغة لتشغيلها. مثال عن استخدام العنصر <video> لإضافة مقطع فيديو بصيغة WebM (عبر الخاصية src) بارتفاع 360، مع عرض عناصر التحكم (عبر الخاصية controls) وله صورة غلاف تُعرَض إلى أن يبدأ تشغيله (الخاصية poster)، وستُعرَض رسالة نصية تنوِّه المستخدم أنَّ متصفحه لا يدعم العنصر <video>: <video src="khamsat.webm" controls poster="khamsat-poster.jpg" height="360"> لا ...

الخاصية Number.MAX_SAFE_INTEGER تُمثِّل أكبر عدد صحيح «آمن» (safe integer) في JavaScript (وهو 253‎ -1). سمات الخاصية Number.MAX_SAFE_INTEGER قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الخاصية MAX_SAFE_INTEGER تملك القيمة 9007199254740991، والفكرة المنطقية وراء هذا الرقم هو أنَّ لغة JavaScript تستخدم صيغة الأعداد العشرية المُعرَّفة في IEEE 754 مما يعني أنَّها قادرةٌ على تمثيل الأعداد بأمان بين القيمتين (253‎ -1)- و 253‎ -1. الأمان في هذا السياق يعني القدرة على تمثيل الأعداد الصحيحة كما هي ومقارنتها مقارنةً صحيحةً؛ فمثلًا نتيجة ...

الخاصية Number.MIN_SAFE_INTEGER تُمثِّل أصغر عدد صحيح «آمن» (safe integer) في JavaScript (وهو (253‎ -1)-). سمات الخاصية Number.MIN_SAFE_INTEGER قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الخاصية MIN_SAFE_INTEGER تملك القيمة 9007199254740991-، والفكرة المنطقية وراء هذا الرقم هو أنَّ لغة JavaScript تستخدم صيغة الأعداد العشرية المُعرَّفة في IEEE 754 مما يعني أنَّها قادرةٌ على تمثيل الأعداد بأمان بين القيمتين (253‎ -1)- و 253‎ -1. الأمان في هذا السياق يعني القدرة على تمثيل الأعداد الصحيحة كما هي ومقارنتها مقارنةً صحيحةً؛ فمثلًا نتيجة ...

تتحقَّق الدالة content_exists()‎ ما إذا مُرِّرت كتلةٌ من المحتوى إلى المخلوط (mixin). إن لم تُستدعَ الدالة content_exists()‎ مباشرةً من مخلوطٍ ما، فسيُطلَق خطأ. لاحظ أنَّ هذه الدالة أضيفت في الإصدار 3.5 من Sass، ولن تعمل على الإصدارات القديمة من مفسّر اللغة. البنية العامة content_exists() القيم المعادة تُعاد القيمة المنطقيَّة TRUE إذا مُرِّرت كتلة من المحتوى إلى المخلوط. خلا ذلك، تُعاد القيمة FALSE. أمثلة مثال عن استخدام الدالة content_exists()‎ لمعرفة إذا مُرَّرت كتلة من المحتوى إلى المخلوط needs_content. لاحظ استخدام التعليمة ‎@warn ...

التعامل مع الأخطاء يطبَع المُفسِر - مُفسِر بايثون - رسالة خطأ ورصة تتبُّع (stack trace) عند حدوث خطأ ما. يرجع بعدها المُفسِر، في الوضع التفاعلي، إلى المُحِث الرئيسي (primary prompt)، وذلك نقيض ما يَحدُث عندما يُشغِّل المُفسِر ملفًا؛ حيث يوقِف المُفسِر التشغيل ويخرج برمز خروج غير مُصفَّر (nonzero exit status) بعد طباعته لرصة التتبُّع (لاحظ أنَّ الأخطاء الناتجة عن الشيفرات المحصورة بالعبارة try … except مُستثناة من سياقنا). بعض الأخطاء غير فادحة (fatal) ولكنها تسبب الخروج برمز خروج غير مُصفَّر ...

تقدّم القوالب طريقة أبسط لإجراء عمليات الاستبدال في السلاسل النصية الموصوفة في PEP 292. حيث يمكن إجراء عمليات الاستبدال باستخدام الرمز $ بدلًا من الرمز %، وباتباع القواعد التالية: يعتبر التسلسل $$ تسلسل تهريب، ويجري استبداله بعلامة $ واحدة. تسمّي الصيغة ‎$identifier معرّفًا يحدّد موضعًا للاستبدال يطابق مفتاح ربط يحمل الاسم "identifier". المعرّفات الصالحة هي تلك التي تتضمّن حروفًا وأرقامًا بترميز ASCII وتكون غير حساسة لحالة الأحرف، وتبدأ بشرطة سفلية أو أحد حروف الترميز ASCII. وينتهي اسم المحرّف عند أوّل ...

‎.ready( handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينفِّذ هذا التابع دالةً عندما تكون شجرة DOM جاهزة. ‎.ready( handler )‎ أُضيف مع الإصدار: 1.0. handler الدالة المراد تنفيذها بعد أن تصبح DOM جاهزة. يوفر التابع ‎.ready()‎ طريقة لتشغيل شيفرة JavaScript حالما يصبح بالإمكان تعديل DOM بشكل آمن. يُعدُّ هذا الوقت غالبًا أفضل الأوقات لإنجاز مهامٍ ضرورية قبل أن يشاهد المستخدم الصفحة أو يتفاعل معها مثل إضافة معالجات أحداث أو تهيئة إضافات معيَّنة. عندما تُضاف دوال متعدِّدة عبر ...

بنية اللغة بيان للبنية العامة للغة بايثون وبعض الأمور العامة مثل التعليقات وتسمية المعرّفات وغيرها. مفسر بايثون يستخدم مفسر بايثون لمعالجة الشيفرات المكتوبة بها، وهو يقبل عددًا من الخيارات، ويمكن تشغيله في الوضع التفاعلي. أنواع البيانات القيمة المنطقية (boolean) القيمتان المنطقيتان اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. الأعداد الصحيحة (int) العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن ...

المراجع (references) في PHP هي وسيلة للوصول إلى محتوى المتغير نفسه باستخدام أسماء مختلفة، والمراجع لا تشبه المؤشّرات في لغة C، فعلى سبيل المثال لا يمكن إجراء العمليات الحسابية الخاصّة بالمؤشّرات على المراجع، وهي ليست عناوين ذاكرة حقيقية، وهكذا. راجع الصفحة "ما هو غير المقصود بالمراجع" للمزيد من المعلومات. المراجع هي أسماء بديلة رمزية مجدولة (Symbol table aliases). لاحظ أنّ اسم المتغير ومحتواه مختلفان في لغة PHP؛ لهذا يمكن لنفس المحتوى أن يحمل اسمين مختلفين. وأقرب مثال على ذلك هو ...

المراجع (references) في PHP هي وسيلة للوصول إلى محتوى المتغير نفسه باستخدام أسماء مختلفة، والمراجع لا تشبه المؤشّرات في لغة C، فعلى سبيل المثال لا يمكن إجراء العمليات الحسابية الخاصّة بالمؤشّرات على المراجع، وهي ليست عناوين ذاكرة حقيقية، وهكذا. راجع الصفحة "ما هو غير المقصود بالمراجع" للمزيد من المعلومات. المراجع هي أسماء بديلة رمزية مجدولة (Symbol table aliases). لاحظ أنّ اسم المتغير ومحتواه مختلفان في لغة PHP؛ لهذا يمكن لنفس المحتوى أن يحمل اسمين مختلفين. وأقرب مثال على ذلك هو ...

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

تُنشئ الدالة hsl()‎ لونًا جديدًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness). تستخدم هذه الدالة خوارزمية من مواصفات CSS. البنية العامة hsl($hue, $saturation, $lightness) المعاملات ‎$hue قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة. ‎$saturation قيمة تشبُّع اللون. يجب أن تترواح بين ‎0% و ‎100%. ‎$lightness  قيمة سطوع اللون. يجب أن تكون بين ‎0%‎ و ‎100%. القيم المعادة تُعاد قيمة اللون الناتج. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كانت المعاملات من النوع الخطأ أو كانت ...

الكائن URIError يُمثِّل أحد الأخطاء التي تقع عند تمرير وسائط غير صالحة إلى دالة encodeURI()‎ (أو encodeURIComponent()‎) أو decodeURI()‎ (أو decodeURIComponent()‎) البنية العامة new URIError([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الخاصيات والدوال التابعة للدالة البانية URIError الخاصيات URIError.prototype تُمثِّل هذه الخاصية كائن prototype التابعة للكائن URIError. الدوال الدالة البانية URIError لا تملك أيّة دوال تابعة لها مباشرةً، وإنما ترث بعض الخاصيات عبر سلسلة prototype. الكائن prototype الخاصيات URIError.prototype.constructor تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات URIError؛ راجع صفحة الخاصيةObject.prototype.constructor لمزيدٍ ...

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

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601. البنية العامة isoformat(sep='T', timespec='auto') المعاملات sep معامل اختياري يأخذ القيمة الافتراضية 'T' ويمثّل فاصلًا يتكوّن من حرف واحد يوضع بين جزئي الوقت والتاريخ في النتيجة المعادة. timespec يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي: 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'. 'hours': تضمين الساعة بهيئة رقمين HH. 'minutes': ...

تزيد الدالة ()saturate من تشبُّع اللون إذ يممرَّر إليها لونًا وعددًا بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد زيادة قيمة التشبع له بحسب القيمة الأخيرة. البنية العامة saturate($color, $amount) المعاملات ‎$color اللون الذي ستُجرى عليه العمليَّة. ‎$amount قيمة تمثِّل مقدار زيادة التشبُّع، وتتراوح بين ‎0% و ‎100%. القيم المعادة يُعاد اللون ‎$color بعد زيادة قيمة مكوِّن التشبُّع له بمقدار ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل ‎$amount خارج ...

تُعيد الدالة str_index()‎ موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. البنية العامة str_index($string, $substring) المعاملات ‎$string السلسلة النصّيَّة التي سيُبحث ضمنها. ‎$substring السلسلة النصّيَّة المراد البحث عنها. القيم المعادة يٌعاد عدد صحيح يمثل فهرس أول ظهور للسلسة النصيَّة ‎$substring داخل السلسلة ‎$string. إن لم تكن تلك السلسلة موجودةً، فستُعاد القيمة العدميَّة (null). الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان أيّ من المعاملات ...

تحوّل الدالة percentage()‎ عددًا دون وحدة إلى نسبة مئوية. البنية العامة percentage($number) المعاملات ‎$number عددٌ طبيعي دون وحدة. القيم المعادة تُعاد نسبة مئوية تمثِّل العدد ‎$number. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان المعامل ‎$number عددًا له وحدة. أمثلة مثال عن استخدام الدالة percentage()‎  لضبط قيمة العرض (width): selector { width: percentage(0.2) // 20% } سيُصرّف المثال السابق إلى شيفرة CSS الآتية: .selector { width: 20%; } انظر أيضًا الدالة round()‎: تقرِّب العدد الممرَّر إليها. الدالة abs()‎: تعيد القيمة المطلقة للعدد الممرَّر إليها. الدالة ...

تعيد الدالة ()ceil‎ أقرب عدد صحيحٍ أكبر من العدد المٌمرّر إليها. البنية العامة ceil($number) المعاملات ‎$number العدد المراد تقريبه إلى أكبر عدد صحيح. القيم المعادة يُعاد أقرب عددٌ صحيحٌ أكبر من العدد ‎$number. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا لم يكن المعامل ‎$number عددًا. أمثلة مثال عن استخدام الدالة ceil()‎ لضبط قيمة الحواشي (padding): .selector { padding: ceil(10.4px); // 11px } سيُصرّف المثال السابق إلى شيفرة CSS الآتية:أكبر .selector { padding: 11px; } انظر أيضًا الدالة round()‎: تقرِّب العدد ...

تعرّف الوحدة urllib.error الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة urllib.request. الصنف الأساسي في هذه الوحدة هو URLError. تطلق الوحدة urllib.error الاستثناءات التالية: الاستثناء urllib.error.URLError تُطلق أصناف المعالجة هذا الاستثناء (أو الاستثناءات المشتقة منه) عند وقوعها في مشكلة معيّنة. هذا الاستثناء هو صنف متفرّع من الاستثناء OSError. reason سبب حدوث هذا الخطأ. يمكن أن تكون رسالة على هيئة سلسلة نصية أو نسخة من استثناء آخر. ملاحظة: أصبح URLError صنفًا متفرّعًا من الصنف OSError عوضًا عن IOError في الإصدار 3.3 من بايثون. ...

يستدعي التابع syscall دالة نظام التشغيل المحددة بواسطة المعامل المُمرَّر إليه ويعيد نتيجة هذه الدالة أو يطلق الخطأ SystemCallError في حال فشل استدعائها. وسائط الدالة المُستدعاة يمكن أن تمريرها إلى التابع بعد تمرير رقم تلك الدالة. يجب أن تكون تلك الوسائط إما سلاسل نصية أو أعدادًا صحيحةً. يُمرّر كائن من النوع String كمؤشر (pointer) لتسلسل البايتات (byte sequence) بينما يمُرَّر كائن من النوع Integer كعدد صحيح له نفس حجم بتات (bit size) المؤشر. الحد الأقصى للوسائط التي يمكن تمريرها هو ...

(‎(PHP 5 >= 5.4.0, PHP 7 تُفك الدالة ‎hex2bin()‎ الترميز الست عشري للسلاسل النصية ثنائية التمثيل. الوصف ‎string hex2bin(string $data) تُفك الدالة ‎hex2bin()‎ الترميز الست عشري للسلاسل النصية ثنائية التمثيل. تنبيه: لا تُحوِل الدالة hex2bin‎()‎ التمثيل الست عشري للأعداد إلى التمثيل الثنائي، بل تُستَعمل الدالة base_convert()‎ لإجراء هكذا تحويل. المعاملات data البيانات المُرَمَّزة بالتمثيل الست عشري. القيم المعادة تُعيد الدالة hex2bin()‎ التمثيل الثنائي للبيانات المُدخَلة، أو القيمة ‎FALSE في حالة الفشل. الأخطاء والاستثناءات ترمي الدالة hex2bin()‎ الخطأ E_WARNING في حال كان ...

تغيِّر الدالة adjust_hue()‎ قيمة مكوِّن الصبغة (hue) للون إذ يمرر لها اللون وعدد الدرجات (يكون عادةً ما بين ‎-‎360 و 360 درجة [deg]) ، ثمَّ تُعيد لونًا بعد تدوير الصبغة على طول عجلة اللون (color wheel) بالمقدار المُحدّد. البنية العامة adjust_hue($color, $degrees)‎ المعاملات ‎$color اللون المراد تعديله. ‎$degrees عدد درجات تدوير الصبغة، ويتراوح ما بين ‎-‎360 و 360 درجة (deg). القيم المعادة تُعاد قيمة لونيَّة بعد التعديل. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا كان أيٌّ من المعاملات من النوع الخطأ. ...

(PHP 5, PHP 7) تنشئ الدالة array_combine()‎ مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. الوصف array array_combine ( array $keys , array $values ) تنشئ الدالة مصفوفة جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل keys كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل values كقيم مرتبطة بهذه المفاتيح. المعاملات keys مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى سلسلة نصية. values مصفوفة من القيم تربط الدالة بينها وبين ...

تنشئ الدالة hsla()‎ لونًا انطلاقًا من قيم الصبغة (hue) والتشبُّع (saturation) والسطوع (lightness) والشفافيَّة (alpha). تستخدم الدالة خوارزمية من مواصفات CSS. البنية العامة hsla($hue, $saturation, $lightness, $alpha) المعاملات ‎$hue قيمة صبغة اللون. يجب أن تكون بين 0 و 360 درجة. ‎$saturation قيمة تشبُّع اللون. يجب أن تترواح بين ‎0%‎ و ‎100%. ‎$lightness  قيمة سطوع اللون. يجب أن تترواح بين ‎0%‎ و ‎100%. ‎$alpha قيمة شفافيَّة اللون. يجب أن تكون بين 0 و 1. القيم المعادة تُعاد قيمة اللون الناتج. الأخطاء ...

(PHP 5, PHP 7) تنشئ الدالة array_combine()‎ مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. الوصف array array_combine ( array $keys , array $values ) تنشئ الدالة مصفوفة جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل keys كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل values كقيم مرتبطة بهذه المفاتيح. المعاملات keys مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى سلسلة نصية. values مصفوفة من القيم تربط الدالة بينها وبين ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileinode()‎ رقم مؤشِّر الفهرسة (inode) لملف محدَّد. الوصف int fileinode ( string $filename ) تعيد هذه الدالة رقم مؤشِّر الفهرسة للملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم مؤشِّر الفهرسة (inode) للملف filename أو القيمة FALSE عند حصول أي خطأ. أمثلة المثال 1: موازنة رقم مؤشِّر الفهرسة لملف مع نظيره للملف الحالي <?php $filename = 'index.php'; if (getmyinode() == fileinode($filename)) { echo 'You are checking the ...

jQuery.getScript( url [, success ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف تجلب هذه الدالة ملف JavaScript من الخادم باستعمال طلب HTTP عبر الطريقة GET ثمَّ يُنفِّذه. jQuery.getScript( url [, success ] )‎ أُضيفت مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسَل الطلب إليه. success دالةٌ من الشكل Function( String script, String textStatus, jqXHR jqXHR )‎ يراد تنفيذها إن نجح الطلب. هذه الدالة هي اختزالٌ للدالة jQuery.ajax()‎، إذ تكافئ: $.ajax({ url: url, ...

jQuery.getScript( url [, success ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف تجلب هذه الدالة ملف JavaScript من الخادم باستعمال طلب HTTP عبر الطريقة GET ثمَّ يُنفِّذه. jQuery.getScript( url [, success ] )‎ أُضيفت مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسَل الطلب إليه. success دالةٌ من الشكل Function( String script, String textStatus, jqXHR jqXHR )‎ يراد تنفيذها إن نجح الطلب. هذه الدالة هي اختزالٌ للدالة jQuery.ajax()‎، إذ تكافئ: $.ajax({ url: url, ...

عناصر <input> ذات النوع tel تستخدم للسماح للمستخدمين بإدخال وتعديل رقم هاتف. وعلى النقيض من الحقل email والحقل url، فلن يتحقق المتصفح من مطابقة قيمة هذا الحقل لصيغةٍ معينةٍ قبل السماح بإرسال النموذج، وذلك لأنَّ صيغ أرقام الهواتف تختلف كثيرًا حول العالم. <input type="tel" name="tel"> على الرغم من أنَّ وظيفة الحقل tel مماثلة تقريبًا لوظيفة الحقل text، إلا أنَّه يساعد في تسهيل عملية إدخال أرقام الهواتف في الهواتف المحمولة، إذ تُخصَّص لوحة المفاتيح لإدخال أرقام الهواتف؛ أضف إلى أنَّ استخدام نوع ...

(PHP 4 >= 4.0.4, PHP 5, PHP 7) تعيدُ الدالة constant()‎ قيمة ثابتٍ ما. الوصف mixed constant ( string $name ) تعيدُ الدالة constant()‎ قيمة الثابت المشار إليه بالمعامل name. الدالة constant()‎ مفيدة إذا كنت بحاجة إلى استرداد قيمة ثابت، ولكن لا تعرف اسمه. أي أنه مُخَزَّنٌ في متغير أو مُعَادٌ بواسطة دالة. تعمل الدالة constant()‎ أيضًا مع ثوابت الأصناف. العوامل name اسم الثابت. القيم المعادة إعادة قيمة الثابت، أو NULL إذا لم يكن الثابت مُعرَّفًا. الأخطاء والاستثناءات يُنشأ خطأ من ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_executable()‎ إن كان الملف قابلًا للتنفيذ أم لا. الوصف bool is_executable ( string $filename ) تتحقق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للتنفيذ. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للتنفيذ، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: استعمال الدالة is_executable()‎ <?php $file = '/home/vincent/somefile.sh'; if (is_executable($file)) { echo $file.' is executable'; } ...

تتحقَّق الدالة unitless()‎ ما إذا كان العدد الممرَّر إليها يملك وحدة أم لا. البنية العامة unitless($number) المعاملات ‎$number العدد المراد التحقَّق من وجود وحدة له. القيم المعادة تُعاد القيمة المنطقيَّة TRUE إذا كان للعدد ‎$number واحدة، أو القيمة FALSE خلاف ذلك. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا لم يكن المعامل ‎$number عددًا. أمثلة أمثلة نموذجية عن استخدام الدالة unitless()‎: unitless(100); // true unitless(100px); // false انظر أيضًا الدالة unit()‎: تعيد الوحدة (أو الوحدات) المرتبطة بالعدد الممرَّر إليها. الدالة type_of()‎: تعيد نوع قيمة معينة. الدالة inspect()‎: تعيد ...

تُعيد الدالة str_length()‎ عدد حروف السلسلة النصيَّة الممرَّرة إليها. البنية العامة str_length($string) المعاملات ‎$string  السلسلة النصّيَّة المراد معرفة عدد حروفها. القيم المعادة يُعاد عدد أحرف السلسلة النصيَّة ‎$string. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$string سلسلةً نصّيَّةً. أمثلة مثال نموذجي عن استخدام الدالة str_length()‎: str_length("Hsoub"); // 5 انظر أيضًا الدالة str_insert()‎: تدرج سلسلةً نصيةً داخل أخرى عند موضع محدَّد. الدالة str_index()‎: تعيد موقع أول ظهور لسلسلة نصيَّة محدَّدة داخل السلسلة النصيَّة المعطاة. الدالة str_slice()‎: تعيد جزءًا من السلسلة ...

التنقيح على مستوى البرنامج ككل حين تحدث مشكلة في البرنامج الذي كتبته فإنك في حاجة إلى وضع يدك على مكان المشكلة بالتحديد داخل الشيفرة، وتوفر Bash مزايا تنقيح شاملة لعل أشهرها هو بدء صدفة فرعية بخيار x- الذي سيبدأ الصدفة بالكامل في طور التنقيح، وستُطبَع آثار كل أمر إضافة إلى وسائطه (arguments) إلى خَرج قياسي (standard output) بعد توسيع الأوامر لكن قبل تنفيذها. الشيفرة التالية هي لبرنامج commented-script1.sh من مثال أساسيات كتابة برامج Bash، وقد استدعينا الصدفة في طور التنقيح ...

تتكون جميع شيفرات PHP من سلسلة من العبارات (statements)، ويمكن للعبارة أن تكون إسنادًا (assignment) أو استدعاءً لدالّة، أو حلقة تكرارية، أو عبارة شرطية أو حتى عبارة لا تقوم بأي عمل على الإطلاق (عبارة فارغة). تنتهي العبارات عادة بالفاصلة المنقوطة (;)، ويمكن تجميع العبارات بإحاطتها بالأقواس المعقوفة ({}) لتصبح مجموعة عبارات (statement-group)، والتي تعدّ بدورها عبارات أيضًا. سنفصل الحديث في هذا الفصل عن أنواع متعددة من العبارات. if بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات ...

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time()‎. البنية العامة ‎datetime.fromtimestamp(timestamp, tz=None) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. tz صنف فرعي من الصنف tzinfo، يحدّد المنطقة الزمنية. يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له. إن لم يأخذ المعامل tz القيمة None، فيجب ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chdir()‎ مجلَّد PHP الحالي إلى مجلَّد آخر معطى. الوصف bool chdir ( string $directory ) تغيِّر هذه الدالة مجلَّد PHP الحالي إلى المجلَّد directory المعطى. المعاملات directory المجلَّد الحالي الجديد. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، والقيمة FALSE خلاف ذلك. الأخطاء والاستثناءات سيُصدر خطأ من المستوى E_WARNING عند فشل العمليَّة. أمثلة المثال 1: استعمال الدالة chdir()‎ <?php // معرفة المجلَّد الحالي echo getcwd() . "\n"; chdir('public_html'); // معرفة المجلَّد الحالي بعد تغييره echo getcwd() . "\n"; ?> سيُظهر ...

تحوِّل الدالة ()grayscale اللون إلى تدرج الرمادي، وتكافئ استدعاء الدالة desaturate(color, 100%)‎. البنية العامة grayscale($color) المعاملات ‎$color القيمة اللونيَّة المراد تحويلها إلى تدرج الرمادي. القيم المعادة يُعاد اللون ‎$color المُعدّل الذي يكون بتدرج الرمادي. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة مثال عن تحويل اللون الأخضر (green) إلى تدرج الرمادي باستخدام الدالة grayscale()‎: .selector { color: grayscale(green); // #404040 } ستُصرَّف الشيفرة السابقة إلى شيفرة CSS الآتية: .selector { color: #404040; } انظر أيضًا الدالة desaturate()‎: ...

تضيف الدالة quote()‎ علامات الاقتباس إلى سلسلة نصيَّة غير مٌقتبسة. إن كانت السلسلة مُقتبسة فستُعيدها الدالة دون تغيير. البنية العامة quote($string) المعاملات ‎$string سلسلة نصيَّة غير مقتبسة. القيم المعادة تُعاد السلسلة النصيَّة ‎$string بعد إضافة علامات الاقتباس إليها إن لم تكن موجودةً. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$string سلسةً نصّيةً. أمثلة مثال نموذجي عن عمل الدالة quote()‎: quote("foo") // "foo" quote(foo) // "foo" انظر أيضًا الدالة unquote()‎: تزيل علامات الاقتباس من سلسلة نصية مُقتبسة. الدالة str_index()‎: تعيد موقع ...

تفكّ الدالة الضغط عن البايتات في البيانات المعطاة، وتعيد كائن bytes يحتوي على البيانات التي أزيل الضغط عنها. البنية العامة zlib.decompress(data, wbits=MAX_WBITS, bufsize=DEF_BUF_SIZE) ‎ المعاملات wbits يعتمد هذا المعامل على صيغة البيانات المعطاة، وسنتحدث عنه بتفصيل أكبر أدناه. يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. هذا المعامل يشبه نظيره في الدالة compressobj()‎ ولكنّه يأخذ نطاقات أكثر ...

تجعل الدالة ()desaturate اللون أقل تشبُّعًا. يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل قيمة مكوِّن تشبُّعه بحسب القيمة الأخيرة. البنية العامة desaturate($color, $amount) المعاملات ‎$color القيمة اللونيَّة التي ستُجرى عليها العمليَّة. ‎$amount قيمة تمثِّل مقدار تقليل التشبُّع، ويجب أن تتراوح بين ‎0% و ‎100%. القيم المعادة يُعاد اللون ‎$color بعد تقليل قيمة مكوِّن التشبع له بمقدار ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو كانت قيمة المعامل ...

تجعل الدالة ()darken اللون أكثر ظلمة. يُمرر لها لونًا وعددا يتراوح بين ‎0% و ‎100% ثمَّ تعيد ذلك اللون بعد تقليل السطوع بحسب القيمة الأخيرة. البنية العامة darken($color, $amount) المعاملات ‎$color القيمة اللونيَّة التي ستُجرى عليها العمليَّة. ‎$amount قيمة تمثِّل مقدار تقليل السطوع، ويجب أن تترواح بين ‎0% و ‎100%. القيم المعادة يُعاد اللون ‎$color بعد تقليل سطوعه بحسب قيمة المعامل ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل ‎$amount خارج ...

يفصل التابع daemon العملية من طرفية التحكم ويُشغِّلها في الخلفية كجوهرة نظام (system daemon). البنية العامة daemon() → 0 daemon(nochdir=nil,noclose=nil) → 0 ما لم تكن قيمة المعامل nochdir مساويةً إلى true (قيمة صحيحة)، يُغيِّر التابع daemon مجلد العمل الحالي إلى المجلد الجذر ("/"). ما لم تكن قيمة المعامل noclose مساويةً إلى true (قيمة صحيحة)، يعيد التابع توجيه مجرى الدخل القياسي، والخرج القياسي، والخطأ القياسي إلى ‎/dev/null. المعاملات nochdir يحدِّد إن كان يراد تغيير مجلد العمل الحالي إلى المجلد الجذر ("/") أم لا. القيمة الافتراضية ...