نتائج البحث

المولّدات هي أداة بسيطة وقوية لإنشاء المكرِّرات. تأخذ المولِّدات صيغة الدوال العادية ولكنّها تستخدم عبارة yield عند إعادة البيانات. في كلّ مرة تستدعى فيها الدالة next()‎ على المولّدات تعود الأخيرة إلى المكان الذي تركته (تتذكر المولّدات جميع القيم والعبارات التي نفّذت أخيرًا). يوضح المثال التالي كيفية إنشاء المولّدات وآلية عملها: def reverse(data):     for index in range(len(data)-1, -1, -1):         yield data[index] >>> >>> for char in reverse('golf'): ...     print(char) ... f l o g يمكن إنجاز كل ما تقوم به المولّدات باستخدام مكرِّرات صنفية (class-based ...

يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب. يهيّئ هذا التابع الذاكرة المخبئية ومعلومات الوسيط، ثم يستدعي تابع الفتح الملائم مع وسائط الإدخال الخاصة به. إن لم يتمكن التابع من التعرّف على المخطّط يُستدعى التابع open_unknown()‎. البنية العامة URLopener.open(fullurl, data=None) ‎المعاملات ‎data يحمل المعامل data المعنى نفسه لنظيره في الدالة urlopen()‎. القيمة المعادة يعيد التابع كائن urllib.response.addinfourl. أمثلة يقرأ المثال التالي أول 300 بايت من موقع Python: >>> from urllib import request >>> opener = request.URLopener() >>> result = opener.open("https://www.python.org") >>> print(result.read(300)) b'<!doctype ...

تضغط الدالة البيانات المعطاة (كائن bytes) وتعيد البيانات المضغوطة على هيئة كائن bytes. البنية العامة lzma.compress(data, format=FORMAT_XZ, check=-1, preset=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMACompressor للاطلاع على وصف مفصّل للمعاملات format و check و preset و filters. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات المضغوطة. أمثلة يبين المثال التالي طريقة ضغط البيانات في الذاكرة: import lzma data_in = b"Insert Data Here" data_out = lzma.compress(data_in) انظر أيضًا الدالة lzma.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات ...

(PHP 4, PHP 5, PHP 7) تفك الدالة session_decode()‎ ترميز بيانات الجلسة مِن سلسلة نصية مُرمَّزة للجلسة. الوصف bool session_decode ( string $data ) تفك الدالة session_decode()‎ ترميز بيانات الجلسة المُسلسلة المُتوافرة في المعامل ‎$data وتقوم بنشرها في المُتغير ‎$_SESSION العام (superglobal) مع النتيجة. تُستخدم طريقة داخلية في PHP افتراضيًا لفك التسلسل، وهي تختلف عن الدالة unserialize()‎. طريقة التسلسل المُستخدمة تُحدد بواسطة session.serialize_handler. المعاملات data البيانات المُرمَّزة التي ستُخزَّن. القيم المعادة تُعيد الدالة session_decode()‎ القيمة TRUE في حالة نجاح عملها، أو القيمة FALSE في ...

(PHP 4, PHP 5, PHP 7) تُرتِّب الدالة array_multisort()‎ عدة مصفوفات أو المصفوفات متعددة الأبعاد. الوصف bool array_multisort ( array &$array1 [, mixed $array1_sort_order = SORT_ASC [, mixed$array1_sort_flags = SORT_REGULAR [, mixed $... ]]] ) يمكن استخدام الدالة array_multisort()‎ لترتيب عدة مصفوفات دفعةً واحدةً، أو بُعد واحد أو أكثر في حالة المصفوفة متعددة الأبعاد. ويُحتَفَظ بالمفاتيح المقترنة من النوع string، ولكن ستُعاد فهرسة المفاتيح الرقمية. ملاحظة: إذا تساوت مقارنة عنصرين في المصفوفة، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. ...

(PHP 4, PHP 5, PHP 7) تُرتِّب الدالة array_multisort()‎ عدة مصفوفات أو المصفوفات متعددة الأبعاد. الوصف bool array_multisort ( array &$array1 [, mixed $array1_sort_order = SORT_ASC [, mixed$array1_sort_flags = SORT_REGULAR [, mixed $... ]]] ) يمكن استخدام الدالة array_multisort()‎ لترتيب عدة مصفوفات دفعةً واحدةً، أو بُعد واحد أو أكثر في حالة المصفوفة متعددة الأبعاد. ويُحتَفَظ بالمفاتيح المقترنة من النوع string، ولكن ستُعاد فهرسة المفاتيح الرقمية. ملاحظة: إذا تساوت مقارنة عنصرين في المصفوفة، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. ...

‎.one( events [, data ], handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر  بالعناصر المحدَّدة. يُنفَّذ معالج الحدث مرةً واحدةً لكل عنصر ولكل نوع من الأحداث المرتبطة. ‎.one( events [, data ], handler )‎ أُضيف مع الإصدار: 1.1. events سلسلة نصية تحتوي على نوع حدث واحد أو عدَّة أنواع من أحداث JavaScript مثل "click" أو "submit,‎". data كائن مجرَّد (Object) يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الحدث ...

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

يُنشئُ التّابع Document.createComment()‎ عقدةَ تعليق جديدةً ويُعيدها. البنية العامة CommentNode = document.createComment(data) data سلسلةٌ نصيّة تحتوي على التعليق المرغوب إضافته. مثال var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml"); var comment = docu.createComment('هذا تعليق'); docu.getElementsByTagName('xml')[0].appendChild(comment); alert(new XMLSerializer().serializeToString(docu)); // تعرض // <xml><!--هذا تعليق--></xml> مصادر ومواصفات مواصفة createComment

تضغط الدالة البيانات المعطاة. البنية العامة bz2.compress(data, compresslevel=9) المعاملات ‎data البيانات المراد ضغطها. compresslevel إن توفّرت قيمة لهذا المعامل فيجب أن تكون عددًا صحيحًا يتدرّج من 1 إلى 9، والقيمة الافتراضية لهذا المعامل هي 9. لإجراء عمليات الضغط التزايدية عليك باستخدام الصنف BZ2Compressor عوضًا عن هذه الدالة. مصادر صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

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

تفكّ الدالة الضغط عن البيانات المعطاة. البنية العامة bz2.decompress(data) المعاملات ‎data البيانات المراد ضغطها. تفكّ الدالة الضغط عن كل تدفّقات البيانات المعطاة إن كانت ناتجة عن ربط مجموعة من التدفّقات المضغوطة. لإجراء عمليات فك الضغطّ التزايدية، عليك باستخدام التابع BZ2Decompressor. ملاحظة: أضيف دعم تدفّقات البيانات المتعدّدة في الإصدار 3.3 من بايثون. مصادر صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

يقدّم التابع البيانات المعطاة إلى كائن compressor، ويعيد البيانات المضغوطة إن أمكن ذلك. البنية العامة compress(data) ‎المعاملات data البيانات المراد ضغطها. القيمة المعادة يقدّم التابع البيانات المعطاة إلى كائن compressor، ويعيد البيانات المضغوطة إن أمكن ذلك، وإلا فإنه يعيد سلسلة بايتات فارغة. بعد الانتهاء من تزويد البيانات المراد ضغطها إلى كائن compressor، يجب استدعاء التابع flush()‎ لإتمام عملية الضغط. مصادر صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

يضغط التابع البيانات المعطاة (كائن bytes) ويعيد كائن bytes يتضمّن البيانات المضغوطة لجزء من المدخلات على الأقل. البنية العامة compress(data) ‎المعاملات data البيانات المراد ضغطها. القيمة المعادة يمكن لبعض البيانات أن تُخزّن داخليًا buffered internally لاستخدامها في الاستدعاءات اللاحقة للدالة compress()‎ والتابع flush()‎. يجب أن تكون البيانات المعادة مترابطة مع المخرجات الناتجة عن الاستدعاءات السابقة للدالة compress()‎. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

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

(PHP 5, PHP 7) تكتب الدالة file_put_contents()‎ سلسلة نصيَّة على ملف. الوصف int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] ) عمل هذه الدالة مشابه تمامًا لعمليَّة استدعاء الدالة fopen()‎ والدالة fwrite()‎ والدالة fclose()‎ على التوالي وذلك لكتابة بيانات على ملف. إن لم يكن الملف filename موجودًا، فسيُنشأ ويضاف إليه البيانات. إن كان موجودًا، فسيُستبدل إلا إذا كانت إحدى قيم المعامل flags هي الراية FILE_APPEND. المعاملات filename مسار الملف المراد كتابة البيانات ...

يكتب التابع تمثيلًا مُسلسَلًا للكائن المُعطى في كائن الملف المفتوح والمحدّد في الدالة البانية للصنف. البنية العامة dump(obj) ‎المعاملات obj الكائن المراد كتابة تمثيله المسَلسَل في الملف المفتوح. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import pickle >>> data = [1, 2.0, 4, 4+2j] >>> f = open('file1.dat', 'wb') >>> mypickler = pickle.Pickler(f, pickle.HIGHEST_PROTOCOL) >>> mypickler.dump(data) مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

تقدّم هذه الوحدة وسيلة للتعامل مع القوائم وفرزها بصورة تلقائية، وبذلك يمكن تجنب إعادة فرز القائمة بعد كل عملية إدراج للعناصر فيها. وتظهر فائدة هذه الوحدة بجلاء عند التعامل مع القوائم الطويلة والتي تؤدي عمليات مقارنة مكثّفة. تحمل هذه الوحدة اسم bisect لأنّها تستخدم خوارزمية التنصيف البسيطة bisection algorithm لإنجاز عملها. دوال الوحدة bisect تقدّم الوحدة bisect الدوال التالية: الدالة bisect_left()‎ تحدّد الدالة موقع إدراج العنصر المحدد في المصفوفة المعطاة. الدالتان bisect_right()‎ و bisect()‎ تعيدان موقع الإدراج الذي يأتي بعد ...

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

(PHP 5, PHP 7) تفك الدالة convert_uudecode()‎ ترميز سلسلة نصية مرمَّزة بالدالة convert_uuencode()‎. الوصف string convert_uudecode ( string $data ) تفك ترميز سلسلة نصية مرمَّزة بالدالة convert_uuencode()‎. المعاملات data البيانات المُرمَّزة بالدالة convert_uuencode()‎. القيم المعادة تُعيد الدالة convert_uudecode()‎ البيانات بعد فك ترميزها، أو القيمة FALSE عند فشل فك ترميز السلسلة النصية. أمثلة المثال 1: مثال بسيط عن الدالة convert_uudncode()‎ <?php echo convert_uudecode("+22!L;W9E(%!(4\"$`\n`"); ?> انظر أيضًا convert_uuencode()‎: ترميز سلسلة نصية. مصادر صفحة الدالة convert_uudecodes في توثيق PHP الرسمي.

يُنشئ التّابع Document.createTextNode()‎ عقدةً نصيّةً جديدة. البنية العامة var text = document.createTextNode(data); text عقدةٌ نصيّة. data سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى العقدة النّصيّة. أمثلة <!DOCTYPE html> <html lang="en"> <head> <title>createTextNode example</title> <script> function addTextNode(text) { var newtext = document.createTextNode(text), p1 = document.getElementById("p1"); p1.appendChild(newtext); } </script> </head> <body> <button onclick="addTextNode('نعم ');">YES!</button> <button onclick="addTextNode('لا ');">NO!</button> <button onclick="addTextNode('نستطيع ');">WE CAN!</button> <hr /> <p id="p1">أول سطرٍ من الفقرة</p> </body> </html> دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم ...

يضغط التابع البيانات المعطاة ويعيد كائن bytes يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل. البنية العامة Compress.compress(data) المعاملات data البيانات المراد ضغطها. يجب أن تكون هذه البيانات مرتبطة concatenated بالمخرجات الناتجة من أي استدعاءات سابقة للتابع compress()‎. قد يحتفظ التابع ببعض المدخلات في ذواكر داخلية لغرض المعالجة في وقت لاحق. انظر أيضًا التابع Decompress.decompress()‎: يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. ...

يُسلسل (Serializes) التابع dump الكائن المعطى وجميع الكائنات المنحدرة منه (descendant objects). في حال تمرير كائن من النوع IO، فستُكتب البيانات المُسَلسلة فيه، وإلا فستُعاد البيانات كسلسلة نصية. البنية العامة dump( obj [, anIO] , limit=-1 ) → anIO‎ في حال تمرير المعامل limit، فسيقتصر التابع dump على سَلسَلة الكائنات الفرعية حتى العمق المحدد. إذا كان limit سالبًا، لن يكون هناك أي تحقق من للعمق. لا يمكن للتابع Marshal تفريغ (dump) الكائنات التالية: الوحدات أو الأصناف المجهولة (anonymous Class/Module). الكائنات المرتبطة بالنظام (مثل ...

يوفر هذا القسم مجموعة من التوابع التي تستعمل من أجل ربط بيانات محدَّدة مع عنصر محدَّد (أو مجموعة عناصر محدَّدة) وقراءة تلك البيانات لاحقًا. ‎.data()‎ يخزِّن التابع ‎.data()‎ بيانات عشوائية مرتبطة بالعناصر المتطابقة أو تُعيد القيمة في مخزن البيانات المحدد للعنصر الأول في مجموعة العناصر المتطابقة. ‎jQuery.data()‎ يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. ‎jQuery.hasData()‎ يتحقَّق هذا التابع إن كان يملك عنصرٌ محدَّدٌ أيَّةَ بياناتٍ مرتبطةٍ به. jQuery‎.proxy()‎ يأخذ هذا التابع دالةً ويعيد أخرى جديدة ...

تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. البنية العامة gzip.compress(data, compresslevel=9) المعاملات ‎data البيانات المراد ضغطها. compresslevel يحدّد المعامل compresslevel مستوى الضغط بنفس الطريقة المعتمدة في الدالة البانية لكائنات GzipFile. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. أمثلة يبين المثال التالي طريقة ضغط سلسلة نصية ثنائية: import gzip s_in = b"Lots of content here" s_out = gzip.compress(s_in) انظر أيضًا الدالة gzip.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. مصادر صفحة Support ...

يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى. البنية العامة URLopener.retrieve(url, filename=None, reporthook=None, data=None) ‎المعاملات ‎reporthook معامل اختياري، يجب أن يكون دالة تستقبل ثلاثة معاملات عددية هي: عدد قطعة البيانات chunk، أقصى حجم لقطع البيانات، والحجم الكلي لعملية التحميل (‎-1 إن كان الحجم مجهولًا). تستدعى هذه الدالة مرة واحدة عند بدء عملية قراءة قطعة البيانات وبعد قراءة كلّ قطعة بيانات من الشبكة. يتجاهل التابع المعامل reporthook عند استخدام عناوين URL محلية. ‎data إن استخدم المعامل url المخطط http:‎ ...

لعلّك لاحظت أن بالإمكان المرور على عناصر معظم الكائنات الحاوية (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__‎()‎ الذي يستطيع الوصول إلى عنصر واحد في الكائن الحاوي ...

تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات غير المضغوطة على هيئة كائن bytes. تفكّ الدالة الضغط عن كل تدفّقات البيانات المعطاة إن كانت ناتجة عن ربط مجموعة من التدفّقات المضغوطة، وتعيد حاصل عملية ربط النتائج بعضها ببعض. البنية العامة lzma.decompress(data, format=FORMAT_AUTO, memlimit=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMADecompressor للاطلاع على وصف مفصّل للمعاملات format و memlimit و filters. القيمة المعادة تعيد الدالة البيانات غير المضغوطة على هيئة كائن bytes. انظر أيضًا الدالة lzma.compress()‎: تضغط ...

تزيح الدالة shiftOut()‎ بايتًا من البيانات إلى رجل محدَّدة مقدار بتٍّ واحدٍ في كل مرة تتغير فيها حالة النبضة على رجل أخرى إلى HIGH. يمكن ترتيب عملية إزاحة البتات وكتابتها على الرجل إمَّا بدءًا من البت الأكثر أهمية (أقصى اليسار) أو من البت الأقل أهمية (أقصى اليمين). البنية العامة shiftOut(dataPin, clockPin, bitOrder, value) في كل بت، تقدح الرجل clockPin عملية كتابة البت التالي من القيمة value على الرجل dataPin عند الجبهة الصاعدة للإشارة (أي عندما تنتقل النبضة من LOW إلى HIGH) ...

jQuery.ready القيم المعادة قيمة هذا الخاصية هي من النوع Thenable. الوصف هذه الخاصية هي كائنٌ شبيه بالكائن Pormise (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا. jQuery.ready أُضيف مع الإصدار: 1.8. بدءًا من الإصدار jQuery 3.0، أصبح بالإمكان استعمال الكائن الذي يعيده هذا التابع مع التابع jQuery.when()‎ والتابع jQuery.resolve()‎ الأساسي. لا يجب أن تبني الشيفرة أيَّة افتراضات تتعلق فيما إذا كان هذا الكائن هو jQuery.Deferred، أو Promise، أو أي نوع آخر من أنواع الكائن Promise. انظر ...

(PHP 4, PHP 5, PHP 7) تُرِّمز الدالة ‎convert_uuencode()‎ السلسلة النصية. الوصف string convert_uuencode ( string $data ) تُرِّمز الدالة convert_uuencode()‎ السلسلة النصية بإستعمال الخوارزمية uuencode. تُتَرجم خوارزمية Uuencode كل السلاسل النصية (بما في ذلك البيانات بالنظام الثنائي) إلى أحرف قابلة للطباعة، ما يجعله نقلها داخل الشبكة آمنًا. يزيد حجم البيانات المُرَمَزة بخوارزمية Uuencode عن حجمها الطبيعي بنسبة 35%. المعاملات data البيانات التي نريد ترميزها. القيم المعادة تُعيد الدالة convert_uuencode()‎ البيانات مُرَمَزةً، أو القيمة FALSE عند فشل ترميزها. أمثلة المثال 1: ...

jQuery.ready القيم المعادة قيمة هذا الخاصية هي من النوع Thenable. الوصف هذه الخاصية هي كائنٌ شبيه بالكائن Pormise (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا. jQuery.ready أُضيف مع الإصدار: 1.8. بدءًا من الإصدار jQuery 3.0، أصبح بالإمكان استعمال الكائن الذي يعيده هذا التابع مع التابع jQuery.when()‎ والتابع jQuery.resolve()‎ الأساسي. لا يجب أن تبني الشيفرة أيَّة افتراضات تتعلق فيما إذا كان هذا الكائن هو jQuery.Deferred، أو Promise، أو أي نوع آخر من أنواع الكائن Promise. انظر ...

يعدّ هذا الصنف تجريدًا abstraction لطلب URL. البنية العامة urllib.request.Request(url, data=None, headers={}, origin_req_host=None, unverifiable=False, method=None) المعاملات ‎url يجب أن يكون سلسلة نصية تحتوي على عنوان URL صالح للاستخدام. data يجب أن يكون كائنًا يحدّد المعلومات الإضافية التي ستُرسل إلى المخدّم، أو يحمل القيمة None في حال انتفاء الحاجة إلى إرسال مثل هذه المعلومات. يستخدم هذا المعامل من قبل طلبات HTTP فقط في الوقت الحاضر. أنواع الكائنات المدعومة هي كائنات bytes، والكائنات الشبيهة بالملفات file-like objects، والكائنات القابلة للتكرار iterables. في ...

يُنشئُ التّابع Document.createCDATASection()‎ عقدةَ قسم CDATA جديدةً ويُعيدها. البنية العامة CDATASectionNode = document.createCDATASection(data) CDATASectionNode يُمثّل عقدةً من النّوع CDATASection. data سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA. مثال var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") var cdata = docu.createCDATASection('هنا عقدة البيانات'); docu.getElementsByTagName('xml')[0].appendChild(cdata); alert(new XMLSerializer().serializeToString(docu)); // ستَعرضُ // <xml><![CDATA[هنا عقدة البيانات]]></xml> ملاحظات يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات HTML (لأنّ مُستندات HTML لا تدعم أقسام CDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء NOT_SUPPORTED_ERR. سترمي كذلك الاستثناء NS_ERROR_DOM_INVALID_CHARACTER_ERR ...

تفتح هذه الدالة ملفًّا مضغوطًا بخوارزمية LZMA في الوضع الثنائي أو النصي، وتعيد كائن ملف. البنية العامة lzma.open(filename, mode="rb", *, format=None, check=-1, preset=None, filters=None, encoding=None, errors=None, newline=None) المعاملات ‎filename يمكن أن يكون اسم ملفٍّ موجود فعلًا (سلسلة نصية أو كائن bytes أو كائن شبيه بالمسار)، أو يمكن أن يكون كائن ملفٍّ موجود فعلًا يمكن القراءة منه والكتابة فيه. mode يمكن يأخذ المعامل mode إحدى القيم التالية: ‎'r'، 'rb'، 'w'، 'wb'، 'x'، 'xb'، 'a'، 'ab'‎ للنمط الثنائي، والقيم ‎'rt'، 'wt'، 'xt'، ...

الاستقرار: 2-مستقر المجرى هو واجهة مجرّدة للعمل مع البيانات المتدفقة في Node.js. توفّر الوحدة stream واجهة برمجية (API) أساسية تجعل من السهل بناء كائنات تتعامل مع واجهة المجرى. يوجد العديد من كائنات المجرى التي توفرها Node.js. على سبيل المثال، http.IncomingMessage (طلبيات الخادم HTTP) و process.stdout هما نسخ من الصنف stream. يمكن أن تكون المجاري قابلة للقراءة (readable)، أو قابلة للكتابة (writable)، أو كليهما. كل المجاري هي نسخ من الصنف EventEmitter. يمكن الوصول إلى الوحدة stream باستخدام: const stream = require('stream'); لمَّا ...

يُنشئ التّابع Document.createProcessingInstruction()‎ عقدةَ إرشادِ مُعالجة (processing instruction node) جديدةً ويُعيدها. البنية العامة Processing_instruction_node = document.createProcessingInstruction(target, data) المعاملات Processing_instruction_node عقدةٌ من النّوع ProcessingInstruction. target يُشير إلى جزء الهدف في عقدة إرشاد المعالجة، ‎<?‎target ... ?‎>‎ مثلًا. data سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى البيانات داخل العقدة. الاستثناءات NOT_SUPPORTED_ERR يُرمى في حال لم يدعم المُتصفّح هذا التّابع (إصدارات أقدم من Firefox 9 مثلًا). DOM_INVALID_CHARACTER يُرمى عند مُحاولة إضافة هدف إرشاد مُعالجةٍ غير صالح (يجب أن يكون اسم XML أو الأحرف ...

تقديم ميزة التحميل الزائد في PHP القدرة على إنشاء الخصائص والتوابع بصورة ديناميكية، وتعالج هذه العناصر الديناميكية بواسطة التوابع السحرية (magic methods) التي يمكن استخدامها في الصنف لأداء العديد من الوظائف. تنفّذ توابع التحميل الزائد عند التفاعل مع الخصائص أو التوابع غير المصرّح عنها أو غير المرئية ضمن النطاق الحالي. سيستخدم هذا القسم مصطلحي "خاصية يتعذر الوصول إليها" و"تابع يتعذر الوصول إليه" للإشارة إلى حالة التصريح وقابلية الرؤية هذه. يجب تعريف جميع توابع التحميل الزائد كتوابع من نوع public. ملاحظة: ...

تقديم ميزة التحميل الزائد في PHP القدرة على إنشاء الخصائص والتوابع بصورة ديناميكية، وتعالج هذه العناصر الديناميكية بواسطة التوابع السحرية (magic methods) التي يمكن استخدامها في الصنف لأداء العديد من الوظائف. تنفّذ توابع التحميل الزائد عند التفاعل مع الخصائص أو التوابع غير المصرّح عنها أو غير المرئية ضمن النطاق الحالي. سيستخدم هذا القسم مصطلحي "خاصية يتعذر الوصول إليها" و"تابع يتعذر الوصول إليه" للإشارة إلى حالة التصريح وقابلية الرؤية هذه. يجب تعريف جميع توابع التحميل الزائد كتوابع من نوع public. ملاحظة: ...

الاستقرار: 2-مستقر توِّفر الوحدة console طرفيَّة بسيطة لتنقيح الأخطاء تشبه طرفيَّة JavaScript التي توفِّرها متصفحات الويب. تنتج الوحدة عنصرين محدَّدين هما: الصنف Console مع توابعه مثل التوابع console.log()‎، و console.error()‎، و console.warn()‎ التي يمكن استعمالها للكتابة على أي مجرى من مجاري Node.js. نسخة الكائن console العامَّة المضبوطة للكتابة على المجرى process.stdout والمجرى process.stderr، ويمكن استعمالها دون استدعاء require('console')‎. تحذير: لا تكون توابع الكائن console العام متزامنةً دومًا مثل واجهات المتصفح البرمجيَّة التي تشبهها، ولا غير متزامنةٍ دومًا مثل مجاري Node.js ...

تُستخدَم الأصناف المُغلَقة لتمثيل الهرميّة (hierarchy) المحدودة للأصناف؛ وذلك عندما يكون نوع القيمة هو أحد الأنواع الموجودة في مجموعةٍ مُحدَّدةٍ (limited set) وليس أيّ نوع آخر، وبالتالي تُعدُّ هذه الأصناف إضافةً (extension) لأصناف الثوابت المُتعدَّدة (enum classes)، إذ إنّ مجموعة القيم لنوع enum محدودة أيضًا ولكل ثابت فيها نسخةٌ (instance) واحدةٌ فقط، بينما يمكن أن يكون للصنف الفرعيّ (subclass) من الصنف المغلق أكثر من نسخةٍ تحتوي على الحالة (case). ويُستخدَم المُحدِّد (modifier)‏ sealed قبل اسم الصنف للتصريح عن أنّه من ...

تحسب الدالة مجموع تحقق من نوع CRC (التحقّق من الزيادة الدورية Cyclic Redundancy Check) للبيانات المعطاة. تكون النتيجة عددًا صحيحًا طوله 32-بت خالٍ من الإشارة. البنية العامة zlib.crc32(data[, value]) ‎المعاملات value معامل اختياري تستخدمه قيمته -إن توفّرت- كقيمة بادئة لمجموع التحقق، وفي حال غيابه تكون القيمة الافتراضية هي 0. يؤدي تمرير قيمة إلى المعامل value إلى السماح بإجراء عمليات جمع تحقق مستمرّة على مجموعة من المدخلات المترابطة بعضها ببعض. هذه الخوارزمية ليست قوية من ناحية التشفير؛ لذا يُنصح بعدم استخدامها ...

يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. البنية العامة Decompress.decompress(data, max_length=0) المعاملات data البيانات المراد فك الضغط عنها. max_length معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية unconsumed_tail. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع ...

‎.live( events, handler )‎ أهمل مع الإصدار: 1.7، وحذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين بجميع العناصر التي طابقت المحدِّد الحالي الآن وفي المستقبل. ‎.live( events, handler )‎ أُضيف مع الإصدار: 1.3. events سلسلة نصية تحتوي على نوع حدث JavaScript مثل "click" أو "keydown". يمكن للسلسلة النصية بدءًا من الإصدار jQuery 1.4 أن تحتوي على أنواع أحداث متعدِّدة مفصولةً بمسافة فارغة، أو أسماء أحداث مخصَّصة. handler دالة من الشكل ...

‎.load( url [, data ] [, complete ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحمِّل هذا التابع البيانات من الخادم ثمَّ يضع محتوى HTML المُعاد في العنصر المتطابق. ‎.load( url [, data ] [, complete ] )‎ أُضيف مع الإصدار: 1.0. url سلسلة نصية تمثل الرابط URL الذي سيُرسل إليه الطلب. data كائن مجرد (Object) أو سلسلة نصية يُراد إرسالها إلى الخادم مع الطلب. complete دالة من الشكل Function( String responseText, String textStatus, jqXHR jqXHR )‎، وتمثِّل ...

الاستقرار: 2-مستقر توفِّر الوحدة crypto وظيفة التشفير (cryptographic functionality) التي تتضمن مجموعةً من المغلفات (wrappers) التي تُستعمَل من أجل دوال شيفرة Hash في OpenSSL، والتشفير HMAC، والتشفير (cipher)، وفك التشفير (decipher)، والتوقيع (sign)، والتحقق (verify). استعمل الأمر require('crypto')‎ للوصول إلى هذه الوحدة. const crypto = require('crypto'); const secret = 'abcdefg'; const hash = crypto.createHmac('sha256', secret) .update('I love cupcakes') ...

تنسخ الدالة كائن شبكة network object المشار إليه بواسطة عنوان URL إلى ملف محلّي. إن أشار عنوان URL إلى ملف محلي، فإنّ الكائن لن يُنسخ إلا إذا زُوّدت الدالة باسم للملف. البنية العامة urllib.request.urlretrieve(url, filename=None, reporthook=None, data=None) المعاملات filename معامل اختياري، يحدّد موقع الملف الذي ستُجرى عملية النسخ إليه (وإن لم يكن الملف موجودًا، فإنّ الموقع سيكون ملفًّا مؤقتًا tempfile يحمل اسمًا تُنشئه الدالة). reporthook معامل اختياري وهو كائن قابل للاستدعاء ويُستدعى لمرة واحدة عند إجراء الاتصال بالشبكة ومرة بعد ...

deferred.pipe( [doneFilter ] [, failFilter ] )‎ أُهمِلَت مع الإصدار: 1.8. القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds. deferred.pipe ([doneFilter] [، failFilter])‎ أُضيف مع الإصدار: 1.6. doneFilter هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function()‎. failFilter هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function()‎. أُضيف مع الإصدار: 1.7. deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])‎ doneFilter هو دالة اختيارية تُستدعى عند ...

deferred.pipe( [doneFilter ] [, failFilter ] )‎ أُهمِلَت مع الإصدار: 1.8. القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds. deferred.pipe ([doneFilter] [، failFilter])‎ أُضيف مع الإصدار: 1.6. doneFilter هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function()‎. failFilter هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function()‎. أُضيف مع الإصدار: 1.7. deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])‎ doneFilter هو دالة اختيارية تُستدعى عند ...

يُعيد التّابع Document.querySelectorAll()‎ كائنًا ثابتًا (غير حيّ) من النّوع NodeList الذي يُمثّل قائمة عناصر المستند التي تُوافق المُحدّدات المعطاة. مُلاحظة: هذا التّابع مبني على التّابع ParentNode.querySelectorAll()‎. البنية العامة elementList = parentNode.querySelectorAll(selectors); selectors‎ سلسلة نصيّة من النّوع DOMString تحتوي على مُحدّد واحدٍ أو أكثر لمُوافقته مع عناصر المستند والبحث عن العنصر المرغوب. يجب على هذه السّلسلة النّصيّة أن تكون مُحدّد CSS صالح، إن لم يكن كذلك، فسيُرمى استثناء SyntaxError، انظر هذه الصّفحة للمزيد حول المُحدّدات وكيفيّة إدارتها. يُمكن تحديد عدّة محدّدات ...

(PHP 7, PHP 7.1.0) تجمع الدالة session_gc()‎ البيانات المُهملة garbage data)‎) . الوصف int session_gc ( void ) تجمع الدالة ()session_gc البيانات المُهملة (garbage data) . تعمل PHP على تجميع البيانات المُهملة افتراضيًا طِبقًا لاحتمالات افتراضية على الجلسة. تِلك الإحتمالات تعمل بشكل جيد إلى حد ما ولكن يوجد بعض المشاكل: المواقع ذات مرور المُستخدمين المُنخفض قد لا يُحذف فيها البيانات المُهملة في فترة زمنية مُناسبة. المواقع ذات مرور المستخدمين العادي قد تتكرر بها البيانات المُهملة ولا تُحذف. تُجمع البيانات المُهملة طِبقًا لطلب المُستخدم مِما قد ...

يفكّ التابع الضغط عن البيانات المعطاة (كائن شبيه بالبايتات bytes-like) ويعيد البيانات الناتجة عن عملية فك الضغط على هيئة بايتات. البنية العامة decompress(data, max_length=-1) ‎المعاملات data البيانات المراد فك ضغطها. max_length ن كانت قيمة المعامل max_length عددًا لا يحمل الإشارة السالبة فإنّ التابع سيعيد على الأكثر العدد المحدّد في هذا المعامل من البايتات من البيانات التي جرى فك الضغط عنها. إن وصل التابع إلى القيمة المحدّدة في هذا المعامل وكان هناك المزيد من المخرجات التي يمكن إنتاجها، تُسند القيمة False ...

يفكّ التابع الضغط عن البيانات المعطاة (كائن شبيه بالبايتات bytes-like object) ويعيد البيانات غير المضغوطة على هيئة بايتات. البنية العامة decompress(data, max_length=-1) ‎المعاملات data البيانات المراد فك ضغطها. max_length ن كانت قيمة المعامل max_length عددًا لا يحمل الإشارة السالبة فإنّ التابع سيعيد على الأكثر العدد المحدّد في هذا المعامل من البايتات من البيانات التي جرى فك الضغط عنها. إن وصل التابع إلى القيمة المحدّدة في هذا المعامل وكان هناك المزيد من المخرجات التي يمكن إنتاجها، تُسند القيمة False إلى الخاصية ...

(PHP 4 >= 4.0.4, PHP 5, PHP 7) تُعيد الدالة get_defined_functions()‎ مصفوفة فيها كل الدوال المعرّفة. الوصف array get_defined_functions ([ bool $exclude_disabled = FALSE ] ) تحصل الدالة get_defined_functions()‎ على مصفوفة بكل الدوال المعرّفة. المعاملات exclude_disabled لتحديد فيما إذا كان يجب استبعاد الدوال المعطّلة من القيمة المعادة. القيم المعادة تُعيد الدالة get_defined_functions()‎ مصفوفة متعددة الأبعاد تحتوي على قائمة بجميع الدوال المعرّفة، سواء المُضمَّنة باللغة أو المعرّفة من قبل المستخدم. حيث يمكن الوصول إلى الدوال الداخلية عبر ‎$arr["internal"]‎، ويمكن الوصول إلى الدوال ...

jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...

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.parseHTML( data [, context ] [, keepScripts ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] )‎ أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...

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.data( element, key, value )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. jQuery.data( element, key, value )‎ أُضيف مع الإصدار: 1.2.3. element العنصر DOM الذي يراد ربط البيانات به. key سلسلة نصية تمثِّل الاسم الذي ستسمى البيانات المخزَّنة به. value أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة استعمال ...