نتائج البحث

لا تؤدي عبارة pass أي عمل على الإطلاق، ويمكن استخدامها عندما تكون عبارة معيّنة مطلوبة لغويًّا ولكنّها لا تؤدّي وظيفة معينة. فعلى سبيل المثال يؤدي تنفيذ الشيفرة التالية إلى جعل مفسّر بايثون مشغولًا وبانتظار قطع عملية التنفيذ عن طريق الضغط على مفتاحي Ctrl+C: >>> while True: ...     pass ... تستخدم هذه العبارة عادة في إنشاء أصناف مصغّرة: >>> class MyEmptyClass: ...     pass ... يمكن استخدام عبارة pass أيضًا كنصّ بديل مؤقت لدالة أو جملة شرطية معيّنة عند العمل على شيفرة جديدة، الأمر الذي ...

يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا recursive. البنية العامة PrettyPrinter.isrecursive(object) القيمة المعادة يعمل هذا التابع كخطّاف hook يسمح للأصناف الفرعية بتعديل طريقة تحويل الكائنات إلى سلاسل نصية، ويعتمد في عمله بصورة افتراضية على الدالة saferepr()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pp = pprint.PrettyPrinter(indent=4) >>> pp.pprint(stuff) [ <Recursion on list with id=140108600272328>, 'spam', 'eggs', ...

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

يُرمَى الاستنثناء InvalidByteSequenceError من قبل توابع الصّنفين String و Encoding عندما تحوي السّلسلة النّصية التي يجري تحويل ترميزها بايتًا غير صالح إما للتّرميز المصدر أو التّرميز الهدف المراد التحويل إليه. توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد التّرميز الهدف. destination_encoding_name يُعيد اسم الترميز الهدف. error_bytes يعيد البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. ?incomplete_input يتحقّق فيما إذا كان خطأ تسلسل البايت (byte sequence error) الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. readagain_bytes يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع ...

يستورد التابع الوحدة المعطاة إذا اقتضت الحاجة ويعيد الكائن الذي يحمل الاسم المحدّد. تجدر الإشارة إلى أنّه وعلى خلاف ما يشير إليه اسم هذا التابع، فبالإمكان استخدام find_class()‎ للعثور على الدوال. يمكن للأصناف الفرعية أن تعيد تعريف override هذا التابع للتحكم بأنواع الكائنات المستوردة وطريقة تحميلها، وقد يساهم هذا في تقليل الأخطار الأمنية. راجع قسم تقييد المتغيرات العامة للمزيد من التفاصيل. البنية العامة find_class(module, name) ‎المعاملات module سلسلة نصية تتضمن اسم الوحدة التي يستوردها التابع. name سلسلة نصية تتضمن اسم ...

المحدد ‎‎:button الوصف يُحدِّد عناصر الأزرار <button> والعناصر التي من نوع button. ‎jQuery( ":button" )‎ أضيفت في الإصدار: 1.0. المُحدِّد المُكافِئ لـ ‎$( ":button" )‎ باستخدام CSS هو ‎$( "button, input[type='button']" )‎.  ملاحظات إضافيّة لمّا كان ‎:button عبارة عن امتداد jQuery وليس جزءًا من مواصفات CSS، فلن تستفيد الاستعلامات التي تستخدم ‎:button من زيادة الأداء المُقدَّمة عن طريق التّابع querySelectorAll()‎ الأصلي في DOM، وللحصول على أداء أفضل في المتصفحات الحديثة عند استخدام ‎:button لتحديد العناصر، اختر أولًا العناصر باستخدام مُحدِّد ...

 التابع PurePath.is_reserved في بايثون يعيد True عند استخدام النكهة PureWindowsPath إذا كان المسار يُعتبر اسمًا مجوزًا في نظام ويندوز. أما عند استخدام النكهة PurePosixPath فالتابع يعيد False دومًا. عند إجراء استعداءات نظام على مسارات محجوزة فإنها قد تفضل بشكل غامض ويمكن أن يكون لها آثار غير متوقعة. البنية العامة >>> PureWindowsPath('nul').is_reserved() True >>> PurePosixPath('nul').is_reserved() False المعاملات بدون معاملات القيمة المعادة يعيد True عند استخدام النكهة PureWindowsPath إذا كان المسار يُعتبر اسمًا مجوزًا في نظام ويندوز. أما عند استخدام النكهة PurePosixPath فالتابع يعيد False ...

يشبه التابع each_with_index التابع with_index باستثناء أنه لا يوجد إزاحة بادئة لبدء العملية عند قيمة محدَّدة. إن لم تعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator يحوي الفهارس التي كانت الكتلة ستُكرَّر عبرها من الكائن المعطى. البنية العامة each_with_index {|(*args), idx| ... } each_with_index القيمة المعادة يعاد ناتج تكرار الكتلة على فهارس الكائن المُعدِّد المعطى، أو يعاد كائنٌ مُعدِّدٌ جديد إن لم تُعطَ الكتلة. انظر أيضًا التابع each: يتكرر عبر الكتلة المعطاة وفقًا للكائن المُعدِّد الذي استدعي معه والطريقة التي أُنشِئ ...

يضيف التابع update محتويات الجدول Hash المعطى إلى متغيرات البيئة الحالية. البنية العامة update(hash) → Hash update(hash) { |name, old_value, new_value| } → Hash إن لم تُعطَ أية كتلة برمجية، فستُستبدَل قيم الأزواج ذات المفاتيح (keys) المكرَّرة أو يتم تحديد قيمة كل اسم مكرَّر عن طريق استدعاء الكتلة مع تمرير المفتاح (name) وقيمته من البيئة (old_value) وقيمته الجديدة (new_value) من الجدول Hash إليها لتحديد القيمة المراد إعتمادها. المعاملات hash جدول من النوع Hash يحوي الأزواج المراد إضافتها إلى البيئة. القيمة المعادة يُعاد الكائن ...

تضغط الدالة البيانات المعطاة (كائن 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) وتعيد البيانات ...

يضبط التابع default_external التّرميز الخارجي الافتراضي. لا يجدر بك ضبط قيمة التابع default_external:: في شيفرة روبي إذ أنَّ السّلاسل النّصية التي أُنشئت قبل تعديل القيمة قد تملك ترميزًا مختلفًا عن السّلاسل المنشأة بعد تغيير القيمة. يجب أن عليك أن تستخدم ruby -E بدلاً منها لاستدعاء روبي مع الترميز الخارجي الصحيح. ألقِ نظرة على التابع default_external:: لمعلومات أوسع عن طريقة استخدام التّرميز الخارجي الافتراضي. البنية العامة default_external = enc انظر أيضًا التّابع ?dummy: يتحقّق من التّرميز الزّائف. التابع default_external::: يُعيد قيمة ...

يعالج التابع طلب الاستيثاق عن طريق الحصول على زوج اسم المستخدم/كلمة المرور، وإعادة الطلب مرة أخرى. البنية العامة AbstractBasicAuthHandler.http_error_auth_reqed(authreq, host, req, headers) المعاملات authreq يجب أن يكون اسم الترويسة حيث تكون المعلومات المتعلّقة بالحقل مضمّنة في الطلب. host يحدّد عنوان URL والمسار الذي ستُجرى فيه عملية الاستيثاق. إما أن يكون سُلطة authority (مثل: "python.org") أو عنوان URL يتضمّن مكوّن سُلطة (مثل "http://python.org/‎"). في كلا الحالتين يجب أن تتضمّن السُّلطة مكوّن معلومات المستخدم userinfo (لذا لا بأس باستخدام "python.org" و "python.org:80" ...

‎.clearQueue( [queueName ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.clearQueue()‎ في إزالة كافّة العناصر التي لم تُشغَّل حتى الآن من الطابور. ‎.clearQueue( [queueName ] )‎ أضيفت في الإصدار: 1.4. queueName سلسلة نصيّة، وتُمثِّل اسم الطابور. القيمة الافتراضيّة هي fx، وهو طابور التأثيرات المعياري. عندما يُستدعى التّابع ‎.clearQueue()‎، فستُزال من الطابور كافّة الدوال الموجودة فيه والتي لم تُنفَّذ بعد. عندما يُستخدَم هذا التّابع دون وسيط، فسيُزيل ‎.clearQueue()‎ الدوال المتبقيّة من fx وهو طابور التأثيرات المعياري. يُشابِه هذا التّابع بهذه ...

القيمة false العامة (global) هي النسخة الوحيدة من الصنف FalseClass وتمثِّل قيمة الخطأ (false) في التعابير المنطقية (boolean expressions). يوفر هذا الصنف معاملات تسمح للقيمة false بالمساهمة بشكل صحيح في التعابير المنطقية. توابع الكائن العامة (Public Instance Methods) المعامل & يجري المعامل & العملية AND المنطقية بين القيمة false والكائن المعطى ثم يُعيد القيمة false. المعامل === يتحقق المعامل === من تساوي كائنين بشكل صارم. المعامل ^ يجري المعامل ^ العملية XOR المنطقية بين القيمة false وقيمة الكائن المعطى. inspect ...

يُعيد التابع abort_on_exception حالة الشرط المحلي (thread-local‏) "المقاطعة عند حدوث استثناء؟" (abort on exception) في المهمة الفرعية التي استُدعي معها. القيمة الافتراضية هي false. يوجد أيضًا تابع صنف (class method) لتعيين هذا الخيار في كل المهام الفرعية؛ راجع صفحة abort_on_exception. البنية العامة abort_on_exception→ true or false‎ القيمة المعادة تعاد حالة الشرط المحلي (thread-local‏) "المقاطعة عند حدوث استثناء؟" (abort on exception). في المهمة الفرعية المعطاة. انظر أيضًا التابع abort_on_exception =‎: يضبط عند استدعائه بالشكل abort_on_exception= boolean حالة الشرط المحلي "المقاطعة عند حدوث استثناء؟" (abort on exception) ...

يجري المعامل | العملية OR المنطقية على القيمة true وقيمة الكائن المعطى ويُعيد القيمة true دومًا. البنية العامة true | obj→ true‎ القيمة المعادة تعاد القيمة true دومًا. بما أن obj عبارة عن معامل مستعمل مع المعامل، فسيُقيّم دائمًا؛ ولا توجد طريقة لتجاوز هذا السلوك. أمثلة مثال على استخدام المعامل |‎: true | puts("or") true || puts("logical or")‎ الناتج: or‎ انظر أيضًا المعامل &: يجري العملية AND المنطقية على القيمة true وقيمة الكائن المعطى، ويُعيد القيمة false إن كان الكائن يساوي nil ...

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

يُعيد التابع singleton_class صنف الكائن المُنفرد (singleton class) للكائن الذي استدعي معه. يُنشئ هذا التابع صنفًا منفردًا جديدًا إذا كان هذا الكائن لا يملك واحدًا. البنية العامة singleton_class → class القيم المعادة إذا كان الكائن المعطى هو nil، أو true، أو false، فسيُعاد الصنف NilClass، أو TrueClass، أو FalseClass على التوالي. إذا كان الكائن عددًا صحيحًا (integer)، أو عشريًا (Float)، أو رمزًا (Symbol)، فسيُرمَى الاستثناء TypeError. أمثلة مثالٌ عن استخدام التابع singleton_class: Object.new.singleton_class #=> #<Class:#<Object:0xb7ce1e24>> String.singleton_class ...

المحدد ‎:animated‎ الوصف يُستخدَم المُحدِّد ‎:animated‎ في تحديد جميع العناصر قيد التحريك حاليًّا في وقت تشغيل المُحدِّد. ‎jQuery( ":animated" )‎ أضيفت في الإصدار: 1.2. ملاحظة: إن استخدمنا نسخة jQuery مُخصَّصة لا تحتوي على وحدة التأثيرات، فسيرمي المُحدِّد ‎:animated‎ خطأً. ملاحظات إضافيّة لمّا كان المُحدِّد ‎:animated‎ عبارة عن امتداد jQuery وليس جزءًا من مواصفات CSS، فلن تستفيد الاستعلامات التي تستخدم هذا المُحدِّد من تحسين الأداء المُقدَّم عن طريق تابع DOM الأصلي ‎querySelectorAll()‎. ولتحقيق أفضل أداء عند استخدام ‎:animated لتحديد العناصر، فحدِّد ...

يُعيد التابع absolute_path المسار المطلق لسلسلة التعليمات المعطاة، أو يعيد القيمة nil إذا تم تقييم سلسلة التعليمات التي استُدعي معها انطلاقًا من سلسلة نصية. البنية العامة absolute_path() القيمة المُعادة يُعيد التابع absolute_path المسار المطلق لسلسلة التعليمات. أمثلة مثال على استعمال التابع absolute_path مع استخدام التابع compile_file: # /tmp/method.rb def hello puts "hello, world" end # in irb > iseq = RubyVM::InstructionSequence.compile_file('/tmp/method.rb') > iseq.absolute_path #=> /tmp/method.rb‎ انظر أيضًا التابع of: يُعيد سلسلة التعليمات التي تحوي الكائن Proc أو Method المعطى. التابع base_label: يُعيد التسمية الأساسية (base label) لسلسلة التعليمات ...

مقدمة بدلًا من تعريف كامل منطق معالجة طلباتك (request handling logic) على أنّها نطاقات مغلقة (‎(Closures في ملفّات المسارات، قد ترغب في تنظيم هذا السلوك (behavior) باستخدام أصناف ووحدات التحكّم. تستطيع وحدات التحكّم جمع منطق معالجة الطلبات ذي الصلة في صنف واحد. تخزّن وحدات التحكّم في المجلّد app/Http/Controllers. وحدات التحكّم الأساسية تعريف وحدات التحكّم تجد أدناه مثالًا عن وحدة تحكّم بسيطة. لاحظ أن وحدة التحكّم تُوسّع صنف وحدة التحكّم الأساسية المُحتواة في Laravel. يوفّر الصنف الأساسي عددًا من التوابع المفيدة ...

صفحة man للإشارات يحتوي نظامك على صفحة man بها كل الإشارات المتاحة، لكن قد يُفتح بطريقة مختلفة اعتمادًا على نظام تشغيلك، والطريقة التي ستجدها في أغلب أنظمة لينكس هي man 7 signal، لكن إن كنت في ريب من الأمر فحدد صفحة man والقسم الذي تريده بالضبط باستخدام أوامر مثل: man -k signal | grep list أو apropos signal | grep list ستجد أسماء الإشارات باستخدام kill -l. الإشارات إلى صدفة Bash الخاصة بك تتجاهل صدفة bash التفاعلية إشارتي SIGTERM و SIGQUIT في ...

تقدّم وحدة reprlib وسيلة لإنتاج تمثيلات للكائنات مع إمكانية تحديد حجم السلسلة النصية الناتجة. تستخدم هذه الوحدة في منقّح بايثون وقد تكون مفيدة في سياقات أخرى أيضًا. الواجهة البرمجية لوحدة reprlib تقدّم هذه الوحدة صنفًا ونسخة صنف ودالة: الصنف reprlib.Repr يقدّم هذا الصنف خدمات تنسيق يمكن الاستفادة منها في إنشاء دوال مشابهة للدالة الداخلية repr()‎. ولتجنّب إنشاء تمثيلات ذات أحجام كبيرة جدًّا، فإنّ أحجام أنواع البيانات المستخدمة في هذا الصنف تكون محدّدة. نسخة الصنف reprlib.aRepr نسخة من الصنف Repr تستخدم ...

يُستَخدَم التّابع ‎.attr()‎ للحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة، أو تعيين خاصيّة HTML أو عدة خاصيّات لكل عنصر مُطابِق. attr( attributeName )‎. القيمة المعادة سلسلة نصيّة على شكل الكائن String. الوصف الحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة. attr( attributeName )‎. أضيفت في الإصدار: 1.0. attributeName سلسلة نصيّة من الكائن String، تُمثِّل اسم خاصيّة HTML المطلوب الحصول على قيمتها. يحصل التّابع ‎.attr()‎ على قيمة خاصيّة HTML لأول عنصر فقط من المجموعة ...

لغة CSS لغة ممتعةٌ، ولكنّ ملفات الأنماط أصبحت أكبر وأكثر تعقيدًا، وصيانتها صعبة ومتعبة؛ يمكن حينذاك أن تساعدنا المعالجة الأوليَّة (preprocessor). تتيح لك Sass استخدام ميزات غير موجودة في CSS مثل المتغيرات، والتشعب، والمخاليط، والوراثة، وغيرها من الأشياء التي تجعل البرمجة بلغة CSS ممتعةً مرةً أخرى. تحفظ Sass الملفات المعالجة على هيئة ملف CSS عادي، والذي يمكنك استخدامه في موقعك. الطريقة المباشرة لفعل ذلك هي باستخدام سطر الأوامر (terminal). يمكنك بمجرد تثبيت Sass تصريف الملفات إلى CSS باستخدام الأمر sass. ...

مؤشر الاستقرار: 2 - مستقر HTTPS هو بروتوكول HTTP على TLS/SSL. وهو ينفذ كوحدة منفصلة في Node.js. الصنف https.Agent أُضيف مع الإصدار: v0.4.5. كائن وكيل Agent لبروتوكول HTTPS مشابه للوكيل http.Agent. راجع https.request()‎‎ لمزيد من المعلومات. الصنف https.Server أُضيف مع الإصدار: v0.3.4. هذا الصنف هو صنف فرعي من tls.Server ويُطلق الأحداث نفسها كخادم http.Server. راجع http.Server لمزيد من المعلومات. server.close([callback])‎ أُضيف مع الإصدار: v0.1.90. callback من النوع <Function>. راجع server.close()‎‎ من وحدة HTTP لمزيد من التفاصيل. server.listen()‎‎ يبدأ استماع خادم ...

يعيد التابع truncate العدد الذي استُدعي معه بعد اقتطاع المنازل العشرية منه بمقدار محدَّد. ينفذ الصنف Numeric هذا عن طريق تحويل قيمة العدد إلى النوع Float ثم يستدعي Float.truncate. البنية العامة truncate([ndigits]) → integer or float‎ المعاملات ndigits‎ عدد يمثل دقة التقريب. القيمة الافتراضية هي: 0. القيمة المعادة يعاد عدد صحيح أو عشري يمثِّل العدد المعطى بعد اقتطاع المنازل العشرية منه بدقة ndigits. انظر أيضا التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الذي استُدعي معه ...

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. البنية العامة calendar.weekheader(n) المعاملات n معامل إلزامي، يحدّد عرض الترويسة بالحروف لأسبوع واحد فقط. القيمة المعادة سلسلة نصية تتضمن الصيغة المختصرة لأسماء أيام الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekheader(1) 'T W T F S S M' >>> calendar.weekheader(2) 'Tu We Th Fr Sa Su Mo' >>> calendar.weekheader(3) 'Tue Wed Thu Fri Sat Sun Mon' >>> calendar.weekheader(4) 'Tue Wed Thu Fri Sat Sun Mon ' >>> calendar.weekheader(8) ' ...

ينشئ التابع mkfifo ملفًا خاصًّا من النوع "أنبوبة مسماة" (FIFO ويدعى أحيانًا named pipe) باسم وأذونات محدَّدة. البنية العامة mkfifo(file_name, mode=0666) => 0 المعاملات file_name اسم الأنبوبة المسماة (FIFO) المراد إنشاؤها. mode نمط أذونات الأنبوبة المسماة المراد إنشاؤها. تُعدَّل هذه القيمة عبر القناع umask للعملية الحالية بالطريقة المعتادة وهي: أذونات الملف المُنشَأ تكون حاصل العملية mode & ~umask. القيمة المعادة تعاد القيمة 0 بعد اكتمال تنفيذ العملية. انظر أيضا التابع link: ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). ...

تابع رد النداء ‎callbacks.locked()‎ القيمة المعادة قيمة منطقيّة (Boolean). الوصف يُستخدَم تابع رد النداء ‎callbacks.locked()‎ في تحديد ما إذا كانت قائمة ردود النداء مقفلة. ‎callbacks.locked()‎ أضيفت في الإصدار: 1.7. لا يقبل هذا التّابع أي وسائط. أمثلة استخدام ‎callbacks.locked()‎ في تحديد حالة إقفال قائمة ردود النداء: // دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء var foo = function( value ) { console.log( "foo: " + value ); }; var callbacks = $.Callbacks(); // إضافة دالة التسجيل إلى قائمة ردود النداء callbacks.add( foo ...

يوسع التابع extend_object الكائن المعطى بإضافة ثوابت و توابع هذه الوحدة (والتي تُضاف كتوابع فردية [singleton methods]). هذا هو التابع المستخدم من قبل Object.extend. البنية العامة extend_object(obj) → obj‎ المعاملات obj‎ الكائن المراد توسعته. القيمة المعادة يعاد الكائن obj بعد توسيعه. أمثلة مثال على استخدام التابع extend_object‎: module Picky def Picky.extend_object(o) if String === o puts "Can't add Picky to a String" else puts ...

التابع Path.exists في بايثون يدلّ على كون المسار مشيرًا إلى ملف أو مجلد حقيقي أم لا. ملاحظة: إذا كان المسار يشير إلى اختصار (symlink) فإن ناتج استدعاء التابع exists مرتبط بما يشير إليه الاختصار. وتعتمد آلية التحقق على محاولة استدعاء التابع stat للكائن، وفي حال رمي استثناء من نوع OSError فإن التابع exists يعيد False. البنية العامة exists() المعاملات بدون معاملات القيمة المعادة يعيد True إن كان الملف موجودًا ضمن نظام الملفات، ويعيد False في حال عدم وجوده. أمثلة يبين ...

يقرِّب التابع round العدد الذي استُدعي معه إلى أقرب قيمة بدقة محدَّدة. ينفذ الصنف Numeric هذا عن طريق تحويل قيمة العدد إلى النوع Float ثم استدعاء Float.round. البنية العامة round([ndigits]) → integer or float‎ المعاملات ndigits‎ عدد يمثل دقة التقريب. القيمة المعادة يعاد عدد صحيح أو عشري يمثِّل ناتج تقريب العدد المعطى إلى أقرب قيمة بدقة ndigits للمنازل العشري. انظر أيضا التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة. التابع floor: ...

يعيد التّابع backtrace أيَّ تتبع عكسي (backtrace) مرتبط بالاستثناء. التتبع العكسي (backtrace) هو مصفوفةٌ من السّلاسل النصية، تحوي كل واحدةٍ منها إمّا "filename:lineNo: in 'method'‎'' أو ".filename:lineNo''. البنية العامة backtrace → array القيم المعادة تُعاد مصفوفة تمثل التتبع العكسي. أمثلة مثالٌ عن استخدام التابع backtrace: def a raise "boom" end def b a() end begin b() rescue => detail print detail.backtrace.join("\n") end سيعطي هذا المثال عند تنفيذه الناتج التالي: prog.rb:2:in `a' prog.rb:6:in `b' prog.rb:10 انظر أيضا التابع backtrace_locations: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء. ...

يضبط التّابع default_internal القيمة الافتراضية التّرميز الداخلي أو يحذفها عند تعيين القيمة nil. لا يجدر بك ضبط قيمة التابع ‎::default_internal في شيفرة روبي، إذ أن السّلاسل النّصية التي أُنشئَت  قبل تعديل القيمة قد تملك ترميزًا مختلفًا عن السّلاسل المنشأة بعد تغيير القيمة. يجب عليك أن تستخدم ruby -E بدلاً منها لبدء روبي مع الترميز الداخلي الافتراضي الصحيح. ألقِ نظرة على التابع default_internal:: لمعلومات أوسع عن طريقة استخدام التّرميز الداخلي الافتراضي. البنية العامة default_internal = enc or nil انظر أيضًا التّابع ...

يستخلص التابع dig القيمة المتشعبة (nested) المحددة بواسطة سلسلة من الكائنات عن طريق استدعاء التابع dig في كل خطوة، ويُعيد القيمة nil إن كانت قيمة أي خطوة وسطية تساوي nil. البنية العامة dig(key, ...) → object‎ المعاملات key‎ كائن. القيمة المعادة تعاد القيمة المتشعبة (nested) المحددة بواسطة سلسلة الكائنات key، أو تعاد القيمة nil إن كانت قيمة أي خطوة وسطية تساوي nil. أمثلة مثال على استخدام التابع dig‎: Foo = Struct.new(:a) f = Foo.new(Foo.new({b: [1, 2, 3]})) f.dig(:a, :a, :b, 0) ...

محدد أكثر من عنصر multiple selector الوصف يختار هذا المحدِّد نتائج جميع المحددات المعطاة. jQuery( "selector1, selector2, selectorN" )‎ أُضيف مع الإصدار: 1.0. selector1 أي محدَّد صحيح. selector2 محدِّد آخر صحيح. selectorN محدِّد آخر صحيح، ويمكن استعمال عددٍ غير محدود من المحدِّدات بحسب الحاجة. يمكنك جمع ناتج أي عددٍ من المحددات في نتيجة واحدة، فمحدد التعبير المتعدد (multiple expression combinator) هذا هو طريقة فعالة لاختيار عناصر مختلفة. ترتيب عناصر DOM ضمن كائن jQuery المعاد قد يختلف عن ترتيبها ضمن الصفحة. ...

ينشئ التابع public_class_method قائمةً بتوابع الصنف العامة الحالية. البنية العامة public_class_method(symbol, ...) → mod public_class_method(string, ...) → mod‎ المعاملات symbol‎ رمز يمثل التابع. string‎ سلسلة نصية تمثل التابع. يحول هذا المعامل إن أعطي إلى رمز. القيمة المعادة تعاد وحدة. انظر أيضا التابع public: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة. التابع public_constant: ينشئ قائمة بالثوابت العامة (public) الموجودة. التابع public_instance_method: يبحث عن التوابع العامة (public) وحسب على غرار التابع instance_method. التابع public_instance_methods: يعيد قائمة بتوابع النسخة العامة (public instance methods) المعرفة في الوحدة.  التابع public_method_defined?‎: يتحقق إن كان ...

تابع رد النداء ‎callbacks.locked()‎ القيمة المعادة قيمة منطقيّة (Boolean). الوصف يُستخدَم تابع رد النداء ‎callbacks.locked()‎ في تحديد ما إذا كانت قائمة ردود النداء مقفلة. ‎callbacks.locked()‎ أضيفت في الإصدار: 1.7. لا يقبل هذا التّابع أي وسائط. أمثلة استخدام ‎callbacks.locked()‎ في تحديد حالة إقفال قائمة ردود النداء: // دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء var foo = function( value ) { console.log( "foo: " + value ); }; var callbacks = $.Callbacks(); // إضافة دالة التسجيل إلى قائمة ردود النداء callbacks.add( foo ...

ينشئ التابع attr_reader متغيرات نسخ (instance variables) والتوابع المقابلة التي تعيد قيمة متغيرات النسخ هذه. وهو مكافئ لاستدعاء "attr:name" على كل اسم name بالتتابع. تحول الوسائط النصية إلى رموز. البنية العامة attr_reader(symbol, ...) → nil attr(symbol, ...)→ nil attr_reader(string, ...) → nil attr(string, ...)→ nil‎ المعاملات symbol‎ رمز يمثل الخاصية. string‎ سلسلة نصية تمثل الخاصية. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr: الشكل الأول لهذا التابع مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ التابع attr_accessor. التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه ...

معاملات الأنواع (Type Parameters) قد تحتوي الأصناف (classes) -كما هو الحال في لغة Java- على معاملات للأنواع (type parameters) مثل: class Box<T>(t: T) { var value = t } ولإنشاء كائنٍ (instance) من هذا الصنف يجب تحديد النوع كما في الشيفرة الآتية: val box: Box<Int> = Box<Int>(1) أمّا إن كان بالإمكان معرفة (infer) المعاملات إمّا من خلال معاملات الباني (constructor arguments) أو بأيّ وسيلةٍ أخرى فيمكن حينئذٍ حذف نوع المعاملات، مثل: val box = Box(1) // القيمة 1 لها ...

الوصول إلى الطلب عليك التلميح إلى نوع الصنف 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 ...

يعيد هذا الصنف كائن إنهاء finalizer قابل للاستدعاء، ويجري استدعاؤه عند استرجاع الكائن المعطى بواسطة مجموعة garbage. البنية العامة class weakref.finalize(obj, func, *args, **kwargs) المعاملات يعدّ كائن الإنهاء "حيًّا" إلى حين استدعائه (إما على نحو صريح أو في مجموعة garbage) وبعد ذلك يصبح "ميّتًا". تؤدي عملية استدعاء كائن إنهاء حيّ إلى إعادة نتيجة تنفيذ func(*arg, **kwarg)‎، في حين تعيد عملية استدعاء كائن إنهاء ميّت القيمة None. من الضروري التأكّد من أن func و args و kwargs لا تمتلك أيّ إشارات ...

يستخدم التابع str.format()‎ والصنف Formatter صيغة سلاسل التنسيق النصية ذاتها، (ولكن يمكن للأصناف الفرعية في الصنف Formatter أن تعرّف الصيغة الخاصّة بها). ترتبط هذه الصيغة بحروف سلاسل التنسيق النصية، ولكن هناك بعض الاختلافات. تتضمّن سلاسل التنسيق "حقول استبدال" محاطة بالأقواس المعقوفة {}، ويعدّ كل شيء خارج هذه الأقواس حرفًا اعتياديًا ويُنسخ إلى المخرجات دون أي تعديل. إن كانت هناك حاجة إلى استخدام الأقواس المعقوفة ضمن النص فيمكن تهريبها بمضاعفتها: {{ و }}. الصيغة العامة لحقل الاستبدال الصيغة العامة لحقل الاستبدال ...

يمثّل كائن timedelta المدّة الزمنية التي تفصل بين تاريخين أو وقتين معيّنين. البنية العامة ‎datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0) المعاملات جميع المعاملات في عبارة إنشاء الصنف timedelta اختيارية، وقيمتها الافتراضية تساوي 0، ويمكن أن تكون أعدادًا صحيحة أو ذات فاصلة عائمة، ويمكن كذلك أن تكون موجبة أو سالبة. تُخزّن قيم المعاملات days و seconds و microseconds داخليًا، أما بقية المعاملات فتُحوّل إلى الوحدات التالية: تحوّل المللي ثانية إلى 1000 مايكرو ثانية. تحوّل الدقيقة إلى 60 ثانية. تحوّل الساعة ...

يقدّم الإصدار الخامس من اللغة الأصناف والتوابع المجرّدة (abstract classes and methods). لا يمكن تهيئة الأصناف المجرّدة، وإذا احتوى الصنف على تابع مجرّد واحدٍ على الأقل فيجب أن يكون الصنف مجردًا أيضًا. تصرّح الأصناف المجرّدة ببساطة عن توقيع التابع (method's signature، أي اسم الدالة وعدد ونوع معاملاتها)، ولا يمكنها تعريف محتويات تلك التوابع (implementation). عندما يرث صنفٌ ما من صنفٍ مجرّد، يجب تعريف جميع التوابع المجرّدة في الصنف الأب ضمن الصنف الابن، إضافة إلى وجوب تعريف هذه الأصناف بنفس مستوى ...

‎.insertBefore( target )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. ‎.insertBefore( target )‎ أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة قبل العنصر (العناصر) المحدد بواسطة هذا المعامل. يُنفذ التابع ‎.before()‎ والتابع ‎.insertBefore()‎ نفس المهمة. الاختلاف الرئيسي هو في بناء الجملة، على ...

‎.insertAfter( target )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. ‎.insertAfter( target )‎ أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة بعد العنصر (العناصر) المحدد بواسطة هذا المعامل. ينفذ كلٌ من التابع ‎.after()‎ والتابع ‎.insertAfter()‎ نفس المهمة. الاختلاف الرئيسي هو في ...

يقدّم الإصدار الخامس من اللغة الأصناف والتوابع المجرّدة (abstract classes and methods). لا يمكن تهيئة الأصناف المجرّدة، وإذا احتوى الصنف على تابع مجرّد واحدٍ على الأقل فيجب أن يكون الصنف مجردًا أيضًا. تصرّح الأصناف المجرّدة ببساطة عن توقيع التابع (method's signature، أي اسم الدالة وعدد ونوع معاملاتها)، ولا يمكنها تعريف محتويات تلك التوابع (implementation). عندما يرث صنفٌ ما من صنفٍ مجرّد، يجب تعريف جميع التوابع المجرّدة في الصنف الأب ضمن الصنف الابن، إضافة إلى وجوب تعريف هذه الأصناف بنفس مستوى ...

يُستعمَل الصنف Encoding::Converter في عمليات تحويل الترميز في السلاسل النصية. الثوابت AFTER_OUTPUT يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. CRLF_NEWLINE_DECORATOR يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF. CR_NEWLINE_DECORATOR يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR. INVALID_MASK يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). INVALID_REPLACE يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة. ...

الدالة Date.UTC()‎ تقبل نفس الوسائط التي يقبلها أطول شكل من أشكال الدالة البانية، وتُعيد كم ملي ثانية مضت منذ January 1, 1970, 00:00:00 في التوقيت العالمي (UTC). البنية العامة Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]]) year قيمة عددية صحيحة تُمثِّل السنة بعد عام 1900. month قيمة عددية صحيحة تُمثِّل الشهر، وتبدأ من 0 (كانون الثاني/يناير) إلى 11 (كانون الأول/ديسمبر). day قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل اليوم من الشهر (من 1 إلى 31). hours قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ ...

يُستعمَل الصنف Encoding::Converter في عمليات تحويل الترميز في السلاسل النصية. الثوابت AFTER_OUTPUT يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. CRLF_NEWLINE_DECORATOR يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF. CR_NEWLINE_DECORATOR يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR. INVALID_MASK يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). INVALID_REPLACE يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة. ...

بالرغم من أنّ النمط الافتراضي لمخرجات CSS في Sass لطيفٌ ويعكسُ بِنية المستند، إلا أنَّ الأذواق والاحتياجات تختلف من شخص لآخر، لذا تدعمُ Sass عدة أنماط أخرى. تسمح لك Sass بأن تختار بين أربعة أنماط مختلفة للإخراج عن طريق ضبط الخيار ‎:style أو استخدام الراية ‎--style في سطر الأوامر. ملاحظة: لا يدعم مصرّف Sass الذي يمكن تثبيت باستخدام مدير الحزم npm النمط :nested؛ إذا أردتَ استخدامه فثبت مصرّف Sass كما هو موضّح في صفحة تثبيت وضبط واستخدام Sass. النمط ‎المتشعّب ...

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

تعيد الدّالة type()‎ نوع الكائن المُعطى إن مُرّر مُعامل واحد لها. وتعيد كائن نوعٍ (type object) جديد إن مُرّرت لها ثلاثة مُعاملات. البنية العامة type(object) type(name, bases, dict) المعاملات تقبل الدّالة type()‎ إمّا مُعاملًا واحدًا فقط، أو ثلاثة مُعاملات كما هو واضح في البنية العامّة أعلاه. عند استدعائها بمُعامل واحد فقط، ستُعيد الدّالة نوع الكائن المُمرّر. أمّا عند الاستدعاء بثلاثة مُعاملات، فسيُعاد كائن نوعٍ جديد. وهو طريقة ديناميكيّة لإنشاء الأصناف كبديل للجملة class. object عند استدعائها بمُعامل واحد فقط، يُمثّل هذا ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد صحيح. البنية العامة getint(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد صحيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getint('topsecret.server.com', 'Port') 50022 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getfloat()‎: تابع مساعد وظيفته تحويل ...

(PHP 4,PHP 4.0.4, PHP 5, PHP 7) تُخزن الدالة ()session_write_close بيانات الجلسة وتنهيها. الوصف bool session_write_close ( void ) تُنهي الدالة الجلسة الحالية ()session_write_close وتُخزن بيانتها. عادةً ما تُخزن بيانات الجلسة تلقائيًا بعد انتهاء تنفيذ الكود دون الحاجة إلى الدالة ()session_write_close، ولكن لأن بيانات الجلسة مٌحكمة لمنع الكتابة المتزامنة حيث يجب تنفيذ سكربت واحد في الجلسة الواحدة وعند استعمالك أكثر من مجموعة إطار (frameset) في وقت واحد في الجلسات، ستواجه تحميل تلك الإطارات واحدًا تلو الآخر. نتيجةً لهذا الإحكام. يُمكنك توفير وقت التحميل عن طريق إنهاء ...

التابع PurePath.iterdir في بايثون يُسمح باستخدام هذا التابع على كائنات المسارات التي تشير إلى مجلدات، حيث يُنتج كائنات مسارات لكل محتويات المجلد، وتكون النتيجة قابلة للتكرار. البنية العامة >>> p = Path('docs') >>> for child in p.iterdir(): child ... PosixPath('docs/conf.py') PosixPath('docs/_templates') PosixPath('docs/make.bat') PosixPath('docs/index.rst') PosixPath('docs/_build') PosixPath('docs/_static') PosixPath('docs/Makefile') المعاملات بدون معاملات القيمة المعادة يُسمح باستخدام هذا التابع على كائنات المسارات التي تشير إلى مجلدات، حيث يُنتج كائنات مسارات لكل محتويات المجلد، وتكون النتيجة قابلة للتكرار. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = Path('docs') >>> for child in p.iterdir(): child ... PosixPath('docs/conf.py') PosixPath('docs/_templates') PosixPath('docs/make.bat') PosixPath('docs/index.rst') PosixPath('docs/_build') PosixPath('docs/_static') PosixPath('docs/Makefile') ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد عشري ذي فاصلة عائمة. البنية العامة getfloat(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد عشري ذي فاصلة عائمة. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getfloat('topsecret.server.com', 'php_version') 7.1 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. ...

يؤدي هذا التابع عملًا مماثلًا للتابع match.group(g)‎، ويسهّل عملية الوصول إلى المجاميع المفردة في تطابق معين باستخدام الصيغة m[g]‎. البنية العامة match.__getitem__(g) المعاملات g رقم المجموعة المراد الوصول إليها في كائن التطابق. القيمة المعادة يعيد التابع القيمة التي تحملها المجموعة الممرّر رقمها إليه كمعامل. ملاحظة: هذا التابع جديد في الإصدار 3.6. أمثلة يبين المثال التالي طريقة الوصول إلى المجموعات والتي يتيحها هذا التابع: >>> m = re.match(r"(\w+) (\w+)", "Isaac Newton, physicist") >>> m[0] # التطابق ...

يكتب التابع تمثيلًا للإعدادات في كائن الملف المعطى. البنية العامة write(fileobject, space_around_delimiters=True) ‎المعاملات ‎fileobject كائن الملف المراد كتابة الإعدادات فيه. ‎space_around_delimiters إن أخذ هذا المعامل القيمة True سيضيف التابع مسافات بيضاء حول الفواصل التي تفصل القيم عن المفاتيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config['DEFAULT'] = {'ServerAliveInterval': '45', ... 'Compression': 'yes', ... ...

تعيد الدالة اللهجة المرتبطة بالاسم المعطى. البنية العامة csv.get_dialect(name) ‎المعاملات name اسم اللهجة المطلوبة. القيمة المعادة تعيد الدالة اللهجة المرتبطة بالاسم المعطى. تُطلق الدالة استثناء إن كان الاسم المعطى غير موجود في سجلّ اللهجات. تعيد الدالة كائن Dialect غير قابل للتعديل. أمثلة يعرض المثال التالي طريقة الاستفادة من هذه الدالة: >>> import csv >>> csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) >>> csv.get_dialect('unixpwd') <_csv.Dialect object at 0x7f29af0a6ae8> >>> csv.get_dialect('xpwd') Traceback (most recent call last): File "<stdin>", line 1, in <module> _csv.Error: unknown dialect انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة ...

يربط العنصر <data> بين محتوى العنصر وقيمة سهلة القراءة برمجيًا. لا يؤثر العنصر <data> على طريقة العرض أبدًا. إذا كان المحتوى متعلقًا بالوقت أو التاريخ، فيجب حينئذٍ استخدام العنصر <time>. تُعرَض قائمة غير مرتبة <ul> في المثال الآتي فيها عناصر <li> تُمثِّل السلع، ويرتبط رقم خاص بكل سلعة: <p>المنتجات</p> <ul> <li><data value="001">مربى السفرجل</data></li> <li><data value="002">حلاوة بطحينة</data></li> <li><data value="003">جبنة سائلة</data></li> </ul> بطاقة العنصر تصنيفات المحتوى عنصر تنظيمي أو عنصر عادي. المحتوى المسموح محتوى عادي. الوسم المختصر لا يمكن حذف أيّ ...

يمنع التابع freeze إجراء تعديلاتٍ إضافيةٍ على الكائن الذي استدعي معه. سيُرمَى الخطأ RuntimeError عند محاولة إجراء أي تعديلٍ مع هذا الكائن بعد استدعاء التابع freeze معه. ليس هناك أيُّ طريقةٍ لتحرير الكائن من حالة التجميد (frozen) بعد تطبيقها. انتبه إلى أن الأصناف التالية تكون في حالة تجميد دائمة وهي: Integer، و Float، و Symbol. البنية العامة freeze → obj القيم المعادة يُعاد الكائن المعطى نفسه بعد تجميده. أمثلة مثالٌ عن استخدام التابع freeze: a = [ "a", "b", "c" ...

 التابع PurePath.is_absolute في بايثون يعيد True إن كان كائن المسار يشير إلى مسارٍ مطلق. يكون المسار مطلقًا إن كان يحتوي على مسار جذر واسم السواقة (إن كانت نكهة كائن المسار تسمح بذلك). البنية العامة >>> PurePosixPath('/a/b').is_absolute() True >>> PurePosixPath('a/b').is_absolute() False >>> PureWindowsPath('c:/a/b').is_absolute() True >>> PureWindowsPath('/a/b').is_absolute() False >>> PureWindowsPath('c:').is_absolute() False >>> PureWindowsPath('//some/share').is_absolute() True المعاملات بدون معاملات القيمة المعادة يعيد True إن كان كائن المسار يشير إلى مسارٍ مطلق. يكون المسار مطلقًا إن كان يحتوي على مسار جذر واسم السواقة (إن كانت نكهة كائن المسار تسمح بذلك). أمثلة يبين المثال التالي طريقة استخدام ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى قيمة منطقية (بوليانية). البنية العامة getboolean(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى قيمة منطقية (بوليانية). أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getboolean('topsecret.server.com', 'ForwardX11') False >>> config.getboolean('topsecret.server.com', 'Compression') True انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getint()‎: ...

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

يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. البنية العامة load() ‎القيمة المعادة يعيد التابع هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. أمثلة يبين المثال التالي طريقة عمل التابع (راجع المثال في صفحة التابع Pickler.dump()‎ للاطلاع على الكائن المسَلسَل في الملف file1.dat): >>> import pickle >>> f = open('file1.dat', 'rb') >>> ...

يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. البنية العامة load() ‎القيمة المعادة يعيد التابع هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. أمثلة يبين المثال التالي طريقة عمل التابع (راجع المثال في صفحة التابع Pickler.dump()‎ للاطلاع على الكائن المسَلسَل في الملف file1.dat): >>> import pickle >>> f = open('file1.dat', 'rb') >>> ...

 التابع Path.cwd يعيد كائن مسار جديدًا يمثّل المسار الحالي (بشكل مشابه للتابع os.getcwd) البنية العامة Path.cwd() المعاملات بدون معاملات القيمة المعادة يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم أمثلة يبين المثال التالي طريقة استخدام التابع: >>> from pathlib import Path >>> Path.cwd()#لاحظ أنه يمكن استدعاء التابع دون إنشاء كائن منه WindowsPath('D:/Downloads/WinPython/notebooks') >>> import os >>> os.getcwd()#تابع يقوم بنفس الوظيفة في وحدة نظام التشغيل 'D:\\Downloads\\WinPython\\notebooks' >>> os.chdir('C:\\Program Files (x86)')#تغيير مسار المجلد الرئيسي >>> Path.cwd() WindowsPath('C:/Program Files (x86)') انظر أيضًا التابع os.getcwd في الوحدة os يقوم بنفس ...

تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة البيانات إلى نوع خاص من أنواع بيانات بايثون. البنية العامة sqlite3.register_converter(typename, callable) ‎المعاملات typename يستدعى الكائن الذي تسجّله الدالة لجميع القيم الموجودة في قاعدة البيانات والتي تكون من النوع المحدد بواسطة المعامل typename. يمكنك الرجوع إلى المعامل detect_types في دالة connect()‎ للاطلاع على طريقة الكشف عن الأنواع. يجدر التنبيه إلى أنّ المطابقة بين النوع المعطى والنوع المحدد في جملة الاستعلام تكون غير حساسة لحالة الأحرف. callable كائن قابل ...

 التابع PurePath.with_suffix في بايثون يعيد مسارًا جديدًا بعد تغيير امتداد الملف، وإن لم يكن للملف امتداد فإنه يضيف الامتداد المُعطى إليه. البنية العامة >>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz') >>> p.with_suffix('.bz2') PureWindowsPath('c:/Downloads/pathlib.tar.bz2') >>> p = PureWindowsPath('README') >>> p.with_suffix('.txt') PureWindowsPath('README.txt') المعاملات الوسيط suffix الامتداد الجديد للملف. القيمة المعادة يعيد مسارًا جديدًا بعد تغيير امتداد الملف، وإن لم يكن للملف امتداد فإنه يضيف الامتداد المُعطى إليه. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz') >>> p.with_suffix('.bz2') PureWindowsPath('c:/Downloads/pathlib.tar.bz2') >>> p = PureWindowsPath('README') >>> p.with_suffix('.txt') PureWindowsPath('README.txt') >>> p=PureWindowsPath('C:/Program Files/Windows Mail/wab.exe') >>> p.suffix '.exe' >>> p.with_suffix('.txt') PureWindowsPath('C:/Program Files/Windows Mail/wab.txt') >>> ...

الدالة Date.now()‎ تعيد كم ملي ثانية مضت منذ ‎1 January 1970 00:00:00 UTC. البنية العامة Date.now() القيمة المعادة قيمة عددية من النوع Number تُمثِّل كم ملي ثانية مضت منذ بدء توقيت يونكس (UNIX epoch). الوصف لمّا كانت الدالة now()‎ دالةً ساكنة (static method) تابعةً للكائن Date، فيجب استخدامها دومًا بالشكل Date.now()‎. تعويض نقص دعم المتصفحات أُضيفت هذه الدالة في معيار ECMAScript 5.1، لذا يمكننا استخدام الشيفرة الآتية لإضافتها في المتصفحات التي لا تدعمها: if (!Date.now) { Date.now = function ...

يغلق التابع المؤشر فورًا (عوضًا عن إغلاقه عند استدعاء التابع ‎__del__‎)، وبعدها لن يكون بالإمكان استخدام المؤشر، وستطلق اللغة الاستثناء ProgrammingError عند تنفيذ أي عملية باستخدام المؤشر. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import sqlite3 >>> conn = sqlite3.connect('example.db') >>> c = conn.cursor() >>> c.execute('''CREATE TABLE stocks ... (date text, trans text, symbol text, qty real, price real)''') <sqlite3.Cursor object at 0x7f0ea62989d0> >>> c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") <sqlite3.Cursor ...

الضبط كيفية ضبط لغة PHP عبر مختلف أنواع ملفات الضبط، وطرائق تعديلها. بنية اللغة تبيان أنواع وسوم لغة PHP، وطريقة دمجها مع HTML، وشرح بعض خصائصها البنيوية (ومن بينها التعليقات). أنواع البيانات لا يعيّن المبرمج نوع المتغير عادةً، بل تُعيِّنُه لغة PHP أثناء التنفيذ بالاعتماد على محتوى المتغير المستخدم. القيم المنطقية (boolean) القيم المنطقية (boolean) من أبسط الأنواع، فالتعبير المنطقي يُعبِّر عن صحّة تعبيرٍ ما، فإما أن تكون قيمة التعبير صحيحةً TRUE أو خطأً FALSE. الأعداد الصحيحة (integer) العدد الصحيح هو عدد من ...

‎.add()‎ إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة. ‎.addBack()‎ يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector). ‎.addClass()‎ يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. ‎.after()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.ajaxComplete()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. ‎.ajaxError()‎ ...

التطبيق وحيد الصفحة التطبيق وحيد الصفحة (Single-page Application) هو التطبيق الذي يُحمِّل صفحة HTML واحدة وكل ملحقاتها الضرورية (مثل CSS و JavaScript) المطلوبة لكي يعمل التطبيق. لا تتطلّب أيّة تفاعلات مع الصفحة أو الصفحات اللاحقة أي عودة للخادم مرّة أخرى، ممّا يعني عدم إعادة تحميل الصفحة. بالرغم من قدرتك على بناء تطبيق وحيد الصفحة في React فهو ليس أمرًا ضروريًّا. يُمكِن أيضًا استخدام React لتحسين أجزاء صغيرة من الموقع مع الحصول على تفاعليّة أكبر. يُمكِن للشيفرة المكتوبة باستخدام React أن ...

‎.animate( properties [, duration ] [, easing ] [, complete ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.animate()‎ في تنفيذ تحريك (animation) مُخصَّص لمجموعة من خاصيّات CSS. ‎.animate( properties [, duration ] [, easing ] [, complete ] )‎ أضيفت في الإصدار 1.0. properties كائن مُجرَّد (PlainObject)، ويُمثِّل خاصيّات CSS والقيم التي سيتجه التحريك باتجاهها. duration عدد أو سلسلة نصيّة، وتُمثِّل القيمة التي ستُحدِّد فترة تشغيل التحريك. القيمة الافتراضيّة: 400. easing سلسلة نصيّة، وتُمثِّل دالة الحركة السّلسة (easing ...

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

أشباه الأنواع هي كلمات مفتاحيَّة مستخدمة في توثيق PHP لتحديد الأنواع أو القيم التي يمكن أن يمتلكها المعامل ولا يمكن استخدامها في الشيفرات البرمجية. مختلط – mixed يعني هذا أن المعامل يقبل العديد من الأنواع -وليس بالضرورة جميعها-. على سبيل المثال الدالة gettype()‎ ستقبل جميع أنواع المتغيرات، في حين أن الدالة str_replace()‎ ستقبل السلاسل النصية والمصفوفات. رقم – Number يشير Number إلى أن المعامل يمكن أن يكون عددًا صحيحًا أو عددًا عشريًا. رد النداء – callback استخدم هذا في التوثيق ...

الصنف NilClass هو صنفٌ للكائن nil المُفرد. توابع النسخ العامة (Public Instance Methods) & يجري المعامل & العملية And المنطقية على الكائن المعطى والقيمة nil أو false. === يتحقق المعامل === من تساوي كائنين مع بعضهما بعضًا. ^ يجري المعامل ^ العملية XOR المنطقية على الكائن المعطى والقيمة nil أو false. | يجري المعامل | العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. inspect يعيد دائمًا السلسلة النصية "nil". nil?‎ يتحقق إن كان الكائن الذي استدعي معه هو الكائن nil. rationalize يعيد الصفر كعدد جذري (rational). to_a يعيد دائمًا مصفوفة فارغة. to_c يحول الصفر إلى عدد عقدي. to_f يعيد ...

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎deferred.state()‎ القيمة المعادة يُعيد كائنًا من النوع String. الوصف يُحدد هذا التابع الحالة الحالية لكائن مؤجل. deferred.state()‎ أُضيف مع الإصدار: 1.7. هذا التابع لا يقبل أي وسائط. يعيد التابع deferred.state()‎ سلسلة نصية تمثل الحالة الحالية للكائن المؤجل. يمكن أن يكون الكائن المؤجل في إحدى الحالات الثلاث: معلق pending : الكائن المؤجل ليس في حالة مكتملة (لا "مرفوض" ولا "مقبول"). مقبول resolved : الكائن المؤجل موجود في حالة قبول، مما يعني أنَّه قد استدعي التابع deferred.resolve()‎ أو التابع deferred.resolveWith()‎ للكائن أو أنَّ الدالة ...

يُبدِّل التابع replace محتويات الكائن المُمرَّر إليه مكان محتويات الكائن Hash الذي استدعي معه. البنية العامة replace(other_hash) → hsh المعاملات other_hash كائن من النوع Hash يراد تبديل محتوياته مكان محتويات الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash المعطى بعد تبديل محتوياته مكان محتويات الكائن other_hash. أمثلة مثال على استعمال التابع replace: h = { "a" => 100, "b" => 200 } h.replace({ "c" => 300, "d" => 400 }) #=> {"c"=>300, "d"=>400} انظر أيضًا التابع merge: يدمج كائنين من ...

يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد. البنية العامة c.‎most_common([n]) المعاملات n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة يعيد التابع قائمة بالعناصر الأكثر تكرارًا إلى جانب عدد مرات التكرار. يمكن تحديد عدد العناصر المطلوبة عن طريق تمرير القيمة إلى المعامل n. أمثلة يبين المثال التالي آلية ...

يعيد التابع next الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة. عند وصول المؤشر إلى النهاية، يُطلَق الاستثناء StopIteration. البنية العامة next → object القيمة المعادة يعاد الكائن التالي في المُعدِّد المعطى. أمثلة مثال على استعمال التابع next: a = [1,2,3] e = a.to_enum p e.next #=> 1 p e.next #=> 2 p e.next #=> 3 p e.next #=> StopIteration انتبه إلى أنَّ السلسلة التعدادية المعادة عبر next لا تؤثر على التوابع التعدادية الغير ...

أشباه الأنواع هي كلمات مفتاحيَّة مستخدمة في توثيق PHP لتحديد الأنواع أو القيم التي يمكن أن يمتلكها المعامل ولا يمكن استخدامها في الشيفرات البرمجية. مختلط – mixed يعني هذا أن المعامل يقبل العديد من الأنواع -وليس بالضرورة جميعها-. على سبيل المثال الدالة gettype()‎ ستقبل جميع أنواع المتغيرات، في حين أن الدالة str_replace()‎ ستقبل السلاسل النصية والمصفوفات. رقم – Number يشير Number إلى أن المعامل يمكن أن يكون عددًا صحيحًا أو عددًا عشريًا. رد النداء – callback استخدم هذا في التوثيق ...

يعيد التابع الخيارات المنطوية تحت القسم المعطى. البنية العامة items(raw=False, vars=None) items(section, raw=False, vars=None) ‎المعاملات section ‎في حال عدم تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم القسم، وسيط القسم (section_name, section_proxy) إضافة إلى قسم الإعدادات الافتراضية DEFAULTSECT. أما في حال تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم، قيمة (name, value) للخيارات الموجودة في القسم المعطى. راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars. القيمة المعادة يعيد التابع قائمة تتضمن قيمًا مختلفة بالاعتماد ...

يُعيد الصّنف bool()‎ قيمةً منطقيّةً تكون إمّا True أو False. ويُعَامَل مُعاملة دالةٍ مُضمنّة في بايثون. البنية العامة bool([x]) المعاملات x مُعامل اختياريّ يُحوَّل إلى قيمة منطقيّة باستعمال طريقة اختبار الصّحّة الاعتياديّة. القيمة المعادة إن كان المُعامل المُمرّر يحمل قيمة منطقيّة خطأ (false) أو لم يُمرّر أي مُعامل إلى الصّنف، فالقيمة المُعادة ستكون False، وتُعاد القيمة True في غير ذلك من حالات. أمثلة المثال التّالي يُوضّح كيفيّة عمل هذا الصّنف. لاحظ أنّه يُستدعى كما تُستدعى الدّوال في بايثون: >>> bool(1) True >>> ...

يعيد التابع 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()‎: اختبار ...

يتحقق التابع من وجود الخيار المعطى في القسم المحدّد. البنية العامة has_option(section, option) ‎المعاملات ‎section القسم الذي سيبحث فيه التابع عن الخيار المعطى. option الخيار الذي سيبحث عنه التابع. القيمة المعادة إن كان القسم المعطى موجودًا ويتضمّن الخيار المعطى فإنّ التابع يعيد القيمة True، ويعيد القيمة False فيما عدا ذلك. إن كان القسم المحدّد هو None أو سلسلة نصية فارغة، فإنّ التابع يفترض بأنّه القسم DEFAULT. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 ...

ينشئ التابع قاموسًا جديدًا من التسلسل الذي يحدّده المستخدم في المعاملات. البنية العامة fromkeys(seq[, value]) المعاملات seq تسلسل يستخدمه التابع لإنشاء مفاتيح القاموس الجديد. value معامل اختياري وقيمته الافتراضية هي None. يحدّد هذا المعامل القيمة التي سيُسندها التابع إلى مفاتيح القاموس الجديد. القيمة المعادة قاموس جديد تنشأ مفاتيحه من التسلسل seq ويحمل كل مفتاح القيمة value. أمثلة يبين المثال التالي طريقة استخدام التابع لإنشاء قاموس جديد: >>> s = {1, 2, 3, 4, 5} >>> numbers = dict.fromkeys(s) >>> numbers {1: None, 2: ...

تُعيد الخاصيّة Document.images مجموعة الصور الموجودة في مُستند HTML الحاليّ. البنية العامة var imageCollection = document.images; القيمة مجموعةٌ من النّوع HTMLCollection تحتوي على قائمة بجميع الصّور الموجودة في المُستند الحالي. كلّ عنصر في المجموعة يُعدّ من النّوع HTMLImageElement ويُمثّل عنصر صورة واحد. ملاحظات حول استعمال الخاصية يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع item‎‎‎‎()‎ على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير: firstImage = imageCollection(0); firstImage = imageCollection[0]; مُلاحظة: الخاصيّة Document.images مُتاحة في مُستندات HTML فقط. مثال ...

يكرر التابع each_with_object الكتلة المعطاة على كل عنصر من عناصر الكائن الذي استدعي معه مع كائن آخر اعتباطي (الكائن المُمرَّر إليه). إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة each_with_object(obj) {|(*args), obj| ... } each_with_object(obj) المعاملات obj الكائن الذي سيُكرَّر مع كل عنصر من عناصر الكائن المعطى. القيمة المعادة يعاد الكائن obj المعطى، أو يعاد كائن جديد من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع each_with_object: to_three = Enumerator.new do |y| ...

أشباه الأنواع هي كلمات مفتاحيَّة مستخدمة في توثيق PHP لتحديد الأنواع أو القيم التي يمكن أن يمتلكها المعامل ولا يمكن استخدامها في الشيفرات البرمجية. مختلط – mixed يعني هذا أن المعامل يقبل العديد من الأنواع -وليس بالضرورة جميعها-. على سبيل المثال الدالة gettype()‎ ستقبل جميع أنواع المتغيرات، في حين أن الدالة str_replace()‎ ستقبل السلاسل النصية والمصفوفات. رقم – Number يشير Number إلى أن المعامل يمكن أن يكون عددًا صحيحًا أو عددًا عشريًا. رد النداء – callback استخدم هذا في التوثيق ...

تنشئ الدالة مخدّم WSGI يستمع إلى المضيف والمنفذ المعطيين، ويستقبل الاتصالات من التطبيق المعطى. تعيد الدالة نسخة من صنف المخدّم المعطى وستعالج الطلبات باستخدام صنف المعالجة المعطى. البنية العامة wsgiref.simple_server.make_server(host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler) المعاملات host المضيف الذي ستستمع إليه الدالة. port المنفذ الذي ستستمع إليه الدالة. app يجب أن يكون كائن تطبيق WSGI كما هو معرّف في PEP 3333. server_class صنف المخدّم الذي ستعيد الدالة نسخة منه. handler_class صنف المعالجة الذي ستستخدمه الدالة في معالجة الطلبات. راجع وحدة wsgiref.handlers. ...

يعيد هذا التابع كائنًا مكرِّرًا يتضمّن عناصر تتكرّر فيه حسب قيمة التعداد في كائن التعداد. البنية العامة c.‎most_common([n]) المعاملات n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة يعيد التابع قائمة بالعناصر الأكثر تكرارًا إلى جانب عدد مرات التكرار. يمكن تحديد عدد العناصر المطلوبة عن طريق تمرير القيمة إلى المعامل n. أمثلة يبين المثال التالي آلية ...

تربط الدالة اللهجة المعطاة بالاسم المحدّد. البنية العامة csv.register_dialect(name[, dialect[, **fmtparams]]) المعاملات ‎name سلسلة نصية تتضمّن الاسم المراد ربطه باللهجة المعطاة. dialect يمكن تحديد اللهجة إمّا بتمرير صنف متفرّع عن الصنف Dialect، أو باستخدام المعاملات المفتاحية fmtparams أو كلاهما، مع الأخذ بنظر الاعتبار أنّ المعاملات المفتاحية ستعيد تعريف قيم المعاملات الخاصة باللهجة. راجع قسم اللهجات ومعاملات التنسيق للاطلاع على المزيد من المعلومات. أمثلة يبين المثال التالي طريقة تسجيل لهجة جديدة: import csv csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) with open('passwd', newline='') as f: ...

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎deferred.state()‎ القيمة المعادة يُعيد كائنًا من النوع String. الوصف يُحدد هذا التابع الحالة الحالية لكائن مؤجل. deferred.state()‎ أُضيف مع الإصدار: 1.7. هذا التابع لا يقبل أي وسائط. يعيد التابع deferred.state()‎ سلسلة نصية تمثل الحالة الحالية للكائن المؤجل. يمكن أن يكون الكائن المؤجل في إحدى الحالات الثلاث: معلق pending : الكائن المؤجل ليس في حالة مكتملة (لا "مرفوض" ولا "مقبول"). مقبول resolved : الكائن المؤجل موجود في حالة قبول، مما يعني أنَّه قد استدعي التابع deferred.resolve()‎ أو التابع deferred.resolveWith()‎ للكائن أو أنَّ الدالة ...

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

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