نتائج البحث

تُجمّع الدّالة compile()‎ شيفرة بايثون مصدريّةً إلى شيفرة أو كائن AST. يُمكن تنفيذ هذه الكائنات عبر استخدام الدّالة exec()‎ أو الدّالة eval()‎. البنية العامة compile(source, filename, mode, flags=0, dont_inherit=False, optimize=-1) المعاملات source الشيفرة المصدريّة المرغوب تجميعها، يُمكن أن تكون قيمة المُعامل سلسلةً نصيّة، أو سلسلة بايتات نصيّة (byte string) أو كانًا من النّوع AST. انظر توثيق الوحدة ast للمزيد من المعلومات حول كائنات AST. filename اسم الملفّ الذي قُرِئَت منه الشيفرة. مرّر قيمةً مفهومةً إن لم تكن الشّيفرة قد قرئَت ...

تعيد الدّالة itertools.combinations()‎ تسلسلات فرعيّة (subsequences) تُعدّ تجميعاتٍ ذات طولٍ مُحدّد لعناصر الكائن القابل للتّكرار المُعطى. تُنتَج التّجميعات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فلن تُكرّر أيّة قيم في كلّ تجميعة. البنية العامة itertools.combinations(iterable, r) المعاملات iterable الكائن القابل للتّكرار. r طول الصّفوف النّاتجة. القيمة المعادة صفوف بالطول المُعطى ...

صنف ربط ينشئ إشارات ضعيفة إلى القيم. يجري تجاهل عناصر القاموس عند عدم وجود إشارات قوية إلى القيم. البنية العامة weakref.WeakKeyDictionary([dict]) المعاملات dict القاموس الذي سينشئ هذا الصنف إشارات ضعيفة إلى قيمه. تنبيه: لما كان WeakValueDictionary مبنيًا على قواميس بايثون، فيجب أن لا يتغير حجمه عند المرور على عناصره، وهذا الأمر قد يصبح صعبًا مع WeakValueDictionary لأنّ الأحداث التي تُنفّذ بواسطة البرنامج أثناء عملية المرور على العناصر قد تتسبّب في اختفاء العناصر من القاموس (كتأثير جانبي لمجموعة garbage). التابع valuerefs()‎ ...

تعيد الدّالة divmod()‎ زوجًا من الأعداد تُمثّل ناتج وباقي قسمة العددين عند استعمال قسمة الأعداد الصّحيحة. البنية العامة divmod(a, b) المعاملات a قيمة عددية تمثل المقسوم. b قيمة عددية تمثل المقسوم عليه. القيمة المعادة عند استعمال أنواع operand المختلطة (mixed operand types)، فستُطبّق قواعد عاملات حسابات الأنواع الثّنائيّة (binary arithmetic operators). للأعداد الصّحيحة، ستكون النّتيجة، مُساويّة للزّوج ‎(‎‎a ‎‎/‎/‎ ‎b‎, ‎a ‎% ‎b‎)‎. أمّا للأعداد العشريّة فستكون النّتيجة هي ‎(q‎, ‎a ‎% ‎b‎)‎ بحيث q يكون عادةً نتيجة العمليّة ...

تُحدّث الدّالة functools.update_wrapper()‎ دالّة مُحيطةً (wrapper) لتبدوَ مثل الدّالة المُحاطة (wrapped). المُعاملات الاختياريّة هي صفوفٌ تُستخدم لتحديد أيّ خاصيّات الدّالة الأصليّة ستُعيّن مُباشرة للخاصيّات الموافقة لها على الدّالة المُحيطة وأيّ الخاصيّات من خاصيّات الدّالة المُحيطة ستُحدَّثُ بالخاصيّات المُوافقة لها في الدّالة الأصليّة. القيم الافتراضيّة لهذه المُعاملات هي الثّوابت المُتاحة على مستوى الوحدة: WRAPPER_ASSIGNMENTS‎: والتي تُعيّن كلّا من ‎__module__‎، و‎__name__‎، و‎__qualname__‎، و‎__annotations__‎‎، و‎__doc__‎‎، التي تُعدّ خاصيّاتٍ تُضيف معلومات حول الدّالة. WRAPPER_UPDATES‎: التي تُحدّث خاصيّة ‎__dict__‎ الخاصّة بالدّالة المُحيطة، أي قاموس النّسخة ...

تستدعي الدالة نداء النظام ()getsid الذي يُعيد مُعرِّف جلسة العملية ذات المُعرِّف المُمرَّر. البنية العامة getsid(pid) الدالة متوافرة في أنظمة يونكس. المعاملات pid مُعرِّف العملية المراد الحصول على مُعرِّف جلستها. سيُعيد نداء النظام ()getsid مُعرِّف جلسة العملية المُستدعية له إذا مُرِّرَت القيمة 0 للمعامل pid. القيمة المُعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف جلسة العملية ذات المُعرِّف المُمرَّر للمعامل pid. طالِع صفحة الدليل لنداء النظام ()getsid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import ...

تنسّق الدالة المجلّد الحالي بصيغة HTML. البنية العامة cgi.print_directory() ‎انظر أيضًا الدالة cgi.print_environ()‎: تنسّق الدالة بيئة الصدفة بصيغة HTML. الدالة cgi.print_form()‎: تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_environ_usage()‎: تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

تُعيد الدالة مُعرِّف المجموعة الحقيقي لمُستخدِم العملية الحالية. البنية العامة getgid() القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف (id) المجموعة الحقيقي (real) لمُستخدِم العملية الحالية. أمثلة يعرض المقتطف البرمجي أدناه مثالين للحصول على مُعرِّف مجموعة المستخدم: الأوَّل يكون فيه صاحِب الجلسة مُستخدِم عادي، والثاني مُستخدِم جذر. >>> from os import getgid >>> getgid() 1000 >>> getgid() 0 انظر أيضًا الدالة ()os.geteuid: تُعيد المُعرِّف الفعلي لمُستخدِم العملية الحالية. مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تعيد الدّالة repr()‎ سلسلة نصيّة تحتوي على تمثيل قابل للطّباعة للكائن المُعطى. البنية العامة repr(object) المعاملات object الكائن المرغوب الحصول على تمثيله. القيمة المعادة في الكثير من الحالات، تُحاول الدّالة إعادة سلسلة نصيّة تُعيد كائنًا بنفس القيمة عند تمريره إلى الدّالة eval()‎، وفي غير ذلك من حالات، يكون التّمثيل سلسلةً نصيّة، ويكون مُضمّنًا داخل قوسي <>‎ يحتوي على اسم نوع الكائن إضافةً إلى معلومات أخرى، وعادةً ما تكون هذه المعلومات اسم الكائن وعنوانه في الذّاكرة. يُمكن لصنفٍ أن يتحكّم فيما ...

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

تدمج الدالة عناصر الصفّ الذي يشبه ما تعيده الدالة urlsplit()‎ في عنوان URL كامل على هيئة سلسلة نصية. البنية العامة urllib.parse.urlunsplit(parts) ‎المعاملات part يمكن لهذا المعامل أن يكون أي كائن قابل للتكرار iterable يتكوّن من ستة عناصر. قد يؤدي هذا إلى الحصول على عنوان URL مختلف قليلًا ولكنّه مكافئ للعنوان الأصلي إذا كان الأخير يتضمّن فواصل غير ضرورية (مثل علامة ? مع استعلام فارغ، ينصّ معيار RFC على أنّ العنوانين متكافئان). أمثلة يبين المثال التالي طريقة عمل الدالة: >>> from ...

تعيد الدّالة id()‎ عددًا صحيحًا يُعدّ مُعرّف الكائن. البنية العامة id(object) المعاملات object الكائن المُراد الحصول على مُعرّفه. القيمة المعادة عدد صحيح فريد وثابت يُمثّل مُعرّف الكائن الذي سيبقى مُرتبطًا بالكائن ما دام في الذّاكرة. يُمكن أن تكون قيمة المُعرّف مُتساويّة لكائنين خُزّنا في الذّاكرة في وقتين مُختلفين مع شرط عدم تقاطع مدّة تخزين الكائن الأول مع الآخر، (أي أنّ كائنًا جديدًا قد يملك نفس مُعرّف كائن آخر حُذف من الذّاكرة مُسبقًا). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: ...

تحوّل الدالة كائن ربط mapping object أو تسلسلًا من صفوف ذات عنصرين، والتي قد تحتوي على كائنات str أو bytes إلى سلسلة نصية مرمّزة بالنسبة المئوية ضمن الترميز ASCII. إن كان المطلوب استخدام السلسلة النصية الناتجة كبيانات لعمليات من نوع POST في الدالة urlopen()‎ فيجب ترميز قيمة المعامل إلى بايتات، وإلّا فإنّ النتيجة ستكون الحصول على الاستثناء TypeError. البنية العامة urllib.parse.urlencode(query, doseq=False, safe='', encoding=None, errors=None, quote_via=quote_plus) ‎المعاملات query إن استخدم تسلسل من صفوف ذات عنصرين كقيمة للمعامل query، فيجب أن ...

تُستعمَل الدّالة exec()‎ لتنفيذ شيفرة بايثون ديناميكيًّا. البنية العامة exec(object[, globals[, locals]]) المعاملات object سلسلة نصيّة تُمثّل شيفرة بايثون المُراد تنفيذها أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. إن كان سلسلةً نصيّة، فستُعالج على أنّها جمل بايثون عاديّة وستُنفّذ (إلّا في حالة حدث خطأ في بنية الشّيفرة). إن كان كائنَ شيفرة، فسيُنفّذ فقط. وعلى أية حال، يجب على الشّيفرة المرغوب تنفيذها أن تكون شيفرة بايثون صالحة. وانتبه إلى أنّه لا يجوز استخدام الجملتين return و yield خارج تعريفات الدّوال ...

تعيد الدّالة hash()‎ قيمة تجزئة (hash) الكائن المُعطى (إن امتلك الكائن تجزئةً معروفة). البنية العامة hash(object) المعاملات object الكائن المُراد الحصول على تجزئته. القيمة المعادة عدد صحيح يُمثّل قيمة تجزئة الكائن. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hash(1) 1 >>> hash(1.0) 1 >>> hash('x') # تجزئة محرف واحد مباشرةً 5693259701801553312 >>> a = 'x' >>> hash(a) # تجزئة المحرف نفسه بعد تخزينه في مُتغيّر 5693259701801553312 ملاحظات تُستخدم التّجزئات لمُقارنة مفاتيح القواميس بسرعة أثناء بحث في القاموس. تملك القيم العدديّة التي تُساوي بعضها البعض نفس قيمة ...

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

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

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

يقلب التابع حالة الحروف بترميز ASCII في التسلسل الثنائي. البنية العامة bytes.swapcase() القيمة المعادة يعيد التابع التسلسل الثنائي بعد قلب حالة حروف ASCII فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. ملاحظة: على عكس التابع str.swapcase()‎ يعيد التعبير bin.swapcase()‎.swapcase()‎ تسلسلًا ثنائيًا مطابقًا للتسلسل الثنائي الأصلي. أمثلة يبيّن المثال التالي النتائج المعادة ...

ثبّت الدالة نسخة من الصنف OpenerDirector كفاتح opener افتراضي عام. لن تحتاج إلى تثبيت الفاتح إلّا إن كنت ترغب في أن تستخدم الدالة urlopen ذلك الفاتح بالتحديد، وإلاّ فبالإمكان استدعاء التابع OpenerDirector.open()‎ عوضًا عن ()urlopen. لن تتحقّق الشيفرة من وجود صنف OpenerDirector حقيقي، ويمكن لأيّ صنفٍ يمتلك الواجهة الملائمة أن يؤدي العمل نفسه. البنية العامة urllib.request.install_opener(opener) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.