نتائج البحث

تُعيد الدالة مُعرِّف المجموعة للعملية ذات المُعرِّف المُمرَّر. البنية العامة getpgid(pid) حيث الوسيط pid هو مُعرِّف العملية المُراد الحصول على مُعرِّف المجموعة الخاص بها. الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف المجموعة للعملية ذات المُعرِّف المُمرَّر للوسيط pid. سيُعاد مُعرِّف المجموعة للعملية الحالية في حال مُرِّرَت القيمة 0 للوسيط pid. أمثلة يُوضِّح المقتطف أدناه مثالين لاستخدام الدالة ()os.getpgid للحصول على مُعرِّف مجموعة العملية الحالية: في المثال الأوَّل عبر تمرير القيمة 0 للوسيط pid، بينما ...

تعيد الدّالة isinstance()‎ قيمة منطقيّةً تُشير إلى ما إذا كان الكائن المُعطى نسخة (instance) من الصّنف المُعطى أم لا. البنية العامة isinstance(object, classinfo) المعاملات object الكائن المرغوب التّحقّق من كونه نسخةً من الصّنف (أو النّوع) المُعطى. classinfo الصّنف أو النّوع المرغوب التّحقق من أنّ الكائن نسخة منه. يُمكن كذلك أن يقبل صفًّا (أو عدّة صفوف) من الأصناف أو الأنواع للتحقّق من أنّ الكائن نُسخة من أحدها. القيمة المعادة القيمة True إن كان الكائن نُسخة من الصّنف أو نسخة من أحد ...

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

تعيد الدّالة itertools.chain.from_iterable()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. وتُعدّ الدّالة طريقة بديلة للدّالة itertools.chain()‎، إذ تستقبل هذه الأخيرة عدّة مُعاملات عوضًا عن مُعامل واحد فقط. البنية العامة itertools.chain.from_iterable(iterable) المعاملات iterable الكائن القابل للتّكرار المرغوب تحويل الكائنات التي بداخله إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المتواجدة في ...

تستخدم الدالة الداخلية dir()‎ لمعرفة الأسماء التي تعرّفها الوحدة، وتعيد هذه الدالة قائمة مرتّبة من السلاسل النصية: >>> import fibo, sys >>> dir(fibo) ['__name__', 'fib', 'fib2'] >>> dir(sys) ['__displayhook__', '__doc__', '__excepthook__', '__loader__', '__name__', '__package__', '__stderr__', '__stdin__', '__stdout__', '_clear_type_cache', '_current_frames', '_debugmallocstats', '_getframe', '_home', '_mercurial', '_xoptions', 'abiflags', 'api_version', 'argv', 'base_exec_prefix', 'base_prefix', 'builtin_module_names', 'byteorder', 'call_tracing', 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info', 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info', 'float_repr_style', 'getcheckinterval', 'getdefaultencoding', 'getdlopenflags', 'getfilesystemencoding', 'getobjects', 'getprofile', 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval', 'gettotalrefcount', 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info', 'intern', 'maxsize', ...

تُزيل الدالة مُتغيّر البيئة المُمرَّر. البنية العامة unsetenv(key) الدالة متوافرة في معظم الأنظمة الشبيهة بيونكس وفي أنظمة ويندوز. المعاملات key مُتغيّر البيئة المُراد إزالته. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). التغييرات التي تجريها الدالة على البيئة تؤثِّر على العمليات الفرعيّة المُنشأة من الدوال ()os.system و ()os.popen و ()os.fork و ()os.execv. حذف عنصر من القائمة os.environ، إذا ما كانت الدالة ()os.unsetenv مدعومة على المنصة، سيتحوَّل تلقائيًّا إلى استدعاء مماثل للدالة ()os.unsetenv. لاحظ أنَّ استدعاء الدالة ()os.unsetenv ...

تحول الدالة متغيرات CGI من os.environ إلى سلاسل (bytes in unicode) النصية ضمن المعيار PEP 3333، وتعيد قاموسًا جديدًا. يستخدم المعالجان CGIHandler و IISCGIHandler هذه الدالة عوضًا عن استخدام os.environ مباشرة، والذي يمكن أن لا يكون متوافقًا مع معايير WSGI في جميع المنصات ومخدّمات الويب التي تستخدم الإصدار 3 من بايثون، وعلى وجه الخصوص الأنظمة التي تكون Unicode فيها هي البيئة الفعلية (مثل نظام ويندوز) أو الأنظمة التي تكون البيئة فيها هي البايتات ولكن بايثون لا تستخدم الترميز ISO-8859-1 لفكّ ...

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

تعيد الدّالة itertools.dropwhile()‎ مُكرّرًا يُزيل العناصرَ من الكائن القابل للتّكرار المعطى ما دامت العبارة المنطقيّة المُعطاة (التي تكون دالّة تستقبل العنصر وتُعيد قيمة منطقيّة) تُساوي القيمة المنطقيّة True؛ بعد أن تُخالف العبارة المنطقيّة قيمةً منطقيّة صحيحة، يستمرّ المُكرّر بإعادة العناصر المتبقيّة كلّها. لاحظ أنّ المُكرّر لا يُنتج أي مُخرجات حتى تُساوي العبارة المنطقيّة القيمةَ False، ما يعني أنّه قد يحتاج إلى وقت طويل للبدء في إعادة القيم. البنية العامة itertools.dropwhile(predicate, iterable) المعاملات predicate العبارة المنطقيّة التي ستُحدّد ما إذا كان ...

تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. البنية العامة weakref.getweakrefcount(object) المعاملات object الكائن المراد معرفة الإشارات الضعيفة والوسائط المرتبطة به. القيمة المعادة تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. مصادر صفحة Weak references في توثيق بايثون الرسمي.

تضبط الدالة مُعرِّف مُستخدِم العملية الحالية. البنية العامة setuid(uid) الدالة متوافرة في أنظمة يونكس. المعاملات uid المُعرِّف المُراد إسناده لمُستخدِم العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة يوضَّح المقتطف أدناه مثالًا عن استخدام الدالة ()os.setuid لتغيير مُعرِّف مُستخدِم العملية الحالية والحصول عليه بالدالة ()os.getuid. >>> from os import getuid, setuid >>> getuid() 0 >>> setuid(1) 1 انظر أيضًا الدالة ()os.getuid: تُعيد المُعرِّف الحقيقي لمُستخدِم العملية الحالية. ...

يؤدّي استدعاء هذه الدالة إلى تولّي وحدة cgitb مسؤولية معالجة الاستثناءات عوضًا عن أداة المعالجة الافتراضية في مفسّر بايثون وذلك بتعيين قيمة للدالة sys.excepthook()‎. البنية العامة cgitb.enable(display=1, logdir=None, context=5, format="html") ‎المعاملات ‎display معامل اختياري، يأخذ القيمة الافتراضية 1، ويمكن أن يأخذ القيمة 0 وبذلك تُمنع الدالة من إرسال رسالة الخطأ إلى متصفّح الويب. logdir إن كان المعامل logdir موجودًا، فإنّ رسالة الخطأ ستُكتب إلى ملف، وقيمة هذا المعامل هو المجلّد الذي سيحتوي على هذه الملفات. context معامل اختياري، يحدّد عدد ...

تعيد موقع الإدراج الذي يأتي بعد (إلى الجانب الأيمن) العناصر المماثلة للعنصر المضاف في المصفوفة المعطاة. البنية العامة bisect.bisect(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. إن كان العنصر x موجودًا من قبل في القائمة a، فإنّ موقع الإدراج سيكون بعد (إلى يمين) العناصر الموجودة أصلًا. يمكن استخدام القيمة المعادة كأول معامل في التابع list.insert()‎ على افتراض أنّ القائمة a مفروزة أصلًا. القيمة ...

تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا. البنية العامة calendar.isleap(year) المعاملات year السنة المراد معرفة ما إذا كانت كبيسة أم لا. القيمة المعادة تعيد الدالة القيمة المنطقية True إن كانت السنة المعطاة كبيسة، وإلا تعيد القيمة False. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.isleap(2018) False >>> calendar.isleap(2016) True انظر أيضًا الدالة calendar.leapdays()‎: تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدّد. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تدرج العنصر المحدّد في المصفوفة المعطاة بعد العناصر المماثلة للعنصر المعطى والموجودة أصلًا في المصفوفة. البنية العامة bisect.insort(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. هذه الدالة مشابهة في عملها للدالة insort_left()‎ ولكنّها تدرج العنصر x في المصفوفة a بعد العناصر المماثلة للعنصر x والموجودة أصلًا في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import bisect >>> l = [1, 3, 4, ...

تعيد الدالة قائمة باللهجات المسجّلة. البنية العامة csv.list_dialects()‎ ‎ القيمة المعادة تعيد الدالة قائمة باللهجات المسجّلة. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import csv >>> csv.list_dialects() ['excel', 'excel-tab', 'unix'] انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.unregister_dialect()‎: تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الصنف Dialect. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

تعيد الدالة كائن كتابة وظيفته تحويل بيانات المستخدم إلى سلاسل نصية مفصولة عن بعضها البعض وكتابتها في الكائن المعطى وهو كائن شبيه بالملفات، ويمكن كذلك استخدام أيّ كائن يمتلك التابع write()‎. إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل newline=''‎. ملاحظة: إن لم تحدد القيمة newline=''‎ لن تُفسّر الأسطر الجديدة في الحقول المحاطة بعلامات اقتباس بطريقة صحيحة، وسيضاف رمز ‎\r إضافي إلى الأسطر المنتهية بالرمز ‎\r\n في المنصّات التي تستخدم الرمز الأخير في نهايات الأسطر. ...

تفتح الدالة عنوان URL المعطى. البنية العامة urllib.request.urlopen(url, data=None, [timeout, ]*, cafile=None, capath=None, cadefault=False, context=None) ‎المعاملات ‎url سلسلة نصية أو كائن Request، ويتضمّن عنوان URL الذي ستفتحه الدالة. data يجب أن تكون قيمة هذا المعامل كائنًا يحدّد البيانات الإضافية التي ستُرسل إلى المخدّم، أو يأخذ المعامل القيمة None إن لم تكن هناك حاجة لمثل هذه البيانات. (راجع كائنات Request للمزيد من التفاصيل). تستخدم وحدة urllib.request البروتوكول HTTP/1.1 وتُدرج الترويسة Connection:close في طلبات HTTP الخاصّة بها. timeout معامل اختياري يحدّد الفترة ...

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. البنية العامة 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) ' ...

تُعيد الدالة المُعرِّف الفعلي لمجموعة العملية الحالية. البنية العامة getegid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل المُعرِّف الفعلي لمجموعة العملية الحالية. القيمة المُعادة من الدالة مماثلة لقيمة البت "set id" المرتبطة بالملف الجاري فتحه في العملية الحالية. أمثلة في المقتطف أدناه مثال عن استخدام الدالة للحصول على قيمة المُعرِّف الفعلي لمجموعة العملية الحالية. >>> from os import getegid >>> getegid() 1000 مصادر قسم الصفحة os في توثيق بايثون الرسمي.

تُجمّع الدّالة 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 في توثيق بايثون الرسمي.

تعيّن الدالة اليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.setfirstweekday(weekday) المعاملات weekday يمكن استخدام أعداد صحيحة (0 هو يوم الإثنين و 6 هو يوم الأحد). كذلك يمكن استخدام القيم MONDAY، TUESDAY، WEDNESDAY، THURSDAY، FRIDAY، SATURDAY، SUNDAY لتسهيل اختيار اليوم المطلوب. القيمة المعادة تعيد الدالة القيمة None. أمثلة يبين المثال التالي طريقة استخدام الدالة: import calendar calendar.setfirstweekday(calendar.SUNDAY) calendar.setfirstweekday(6) انظر أيضًا الدالة firstweekday()‎: تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تعيد الدّالة filter()‎ مُكرّرًا (iterator) من عناصر الكائن القابل للتكرار المُعطى حسب شرطٍ تُحدّده الدّالة المُعطاة. وتُستخدم لترشيح عناصر الكائن القابل للتّكرار. البنية العامة filter(function, iterable) المعاملات function الدّالة المُرشّحةُ التي ستُحدّد ما إذا كان العنصر سينضم إلى المُكرّر النّاتج أو لا. ستستقبل الدّالة العنصر وتُعيد إمّا القيمة True أو القيمة False، إن أعادت الدّالة المُرشّحةُ القيمة True للعنصر المُعطى لها، فسينضمّ إلى المُكرّر النّاتج، ولن ينضمّ عكسَ ذلك. إن كانت قيمة هذا المُعاملِ القيمةَ None، فسيُعمل بقواعد التّحقّق من ...

تفكّ الدالة ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. البنية العامة bytes.fromhex() المعاملات string سلسلة نصية يجب أن تتضمّن عددين ستّ عشريين لكل بايت، وتتجاهل الدالة المسافات البيضاء في الترميز ASCII. القيمة المعادة تعيد الدالة كائن bytes الناتج من فك ترميز السلسلة النصية التي تتضمن أعدادًا ست عشرية. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes.fromhex('2Ef0 F1f2 ') b'.\xf0\xf1\xf2' انظر أيضًا الدالة bytes.hex()‎: ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. ...

صنف فرعي خاصّ من الصنف ref يحاكي إشارة ضعيفة إلى تابع مرتبط bound method (أي تابع معرف في صنف وجرى البحث عنه في نسخة من ذلك الصنف). ملاحظة: هذا الصنف جديد في الإصدار 3.4. البنية العامة class weakref.WeakMethod(method) المعاملات dict التابع المراد إنشاء محاكاة لإشارة ضعيفة إليه. التوابع المرتبطة سريعة الزوال ما يمنع من تمسّك الإشارات الضعيفة العادية بها. يمتلك الصنف WeakMethod طريقة خاصة لإعادة إنشاء التابع المرتبط والإبقاء عليه إلى أن يموت الكائن أو الدالة الأصلية: >>> class C: ... ...

تعيد الدّالة tuple()‎ صفًّا يُولَّد من الكائن القابل للتّكرار المُعطى. البنية العامة tuple([iterable]) المعاملات iterable مُعامل اختياريّ، الكائن القابل للتّكرار (كالقوائم، والمجموعات، والسّلاسل النّصيّة وغيرها) المُراد تحويله إلى صفّ. القيمة المعادة صفّ جديد فارغ (إن لم تُمرّر للدّالة أيّة مُعاملات) أو صفّ تكون عناصره هي عناصر الكائن القابل للتّكرار iterable. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> tuple() # صفّ فارغ () >>> tuple('123') # صفّ من سلسلة نصيّة ('1', '2', '3') >>> tuple([1, 2, 3]) # صفّ من قائمة (1, 2, 3) >>> ...

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

تعيد الدالة اللهجة المرتبطة بالاسم المعطى. البنية العامة 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()‎: تربط الدالة ...

تعيد الدّالة itertools.chain()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. البنية العامة itertools.chain(*iterables) المعاملات iterables الكائنات القابلة للتّكرار المرغوب تحويلها إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المُعطاة حسب التّرتيب التي مُرّرت فيها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> c = itertools.chain([1, 2, 3], 'abc') >>> c <itertools.chain ...

تحلل الدالة سلسلة الاستعلام المعطاة كسلسلة من المعاملات (بيانات من نوع application/x-www-form-urlencoded). تعاد البيانات على هيئة قاموس، تكون مفاتيحه أسماء متغيرات الاستعلام وقيمه قوائم تضمّ قيم كل اسم من أسماء المتغيرات. البنية العامة urllib.parse.parse_qs(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) ‎المعاملات keep_blank_values راية تحدد إذا ما كان المطلوب معاملة القيم الفارغة في سلاسل الاستعلام المرمّزة بالنسبة المئوية percent-encoded queries على أنّها سلاسل نصية فارغة. تشير القيمة الصحيحة لهذا المعامل إلى أنّ الفراغات ستبقى سلاسل نصية فارغة، أما القيمة الخاطئة (وهي القيمة ...

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

الدّالة classmethod()‎ مُزخرفٌ يُحوّل تابعًا عاديًّا في صنف ما إلى تابع صنف (class method) ليُمكن الوصول إلى الصّنف الذي عُرّف فيه التّابع. يستقبل تابع الصّنفِ الصّنفَ كمُعاملٍ أول، تمامًا كما يستقبل التّابع العاديّ النّسخة (instance) كمُعامل أولٍ (أي الكائن الذي نُشير إليه عادةً بالاسم self). البنية العامة class C: @classmethod def f(cls, arg1, arg2, ...): ... المعاملات لا توجد مُعاملات. لكنّ الدّالة المُزخرَفَة f تستقبل المُعامل cls الذي يُشير إلى الصّنف الذي عُرّف عليه ...

تفكّ الدالة ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. البنية العامة bytes.fromhex() المعاملات string سلسلة نصية يجب أن تتضمّن عددين ستّ عشريين لكل بايت، وتتجاهل الدالة المسافات البيضاء في الترميز ASCII. القيمة المعادة تعيد الدالة كائن bytes الناتج من فك ترميز السلسلة النصية التي تتضمن أعدادًا ست عشرية. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes.fromhex('2Ef0 F1f2 ') b'.\xf0\xf1\xf2' انظر أيضًا الدالة bytes.hex()‎: ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. ...

تُعيد الدالة سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. البنية العامة getcwd() القيمة المعادة تُعيد الدالة سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. أمثلة يُظهِر المقتطف أدناه محاولتين لاستخدام الدالة ()os.chdir لتغيير مُجلَّد العمل الحالي، ومن ثمَّ طباعته باستخدام الدالة ()os.getcwd. >>> from os import chdir, getcwd >>> chdir("/") >>> getcwd() '/' >>> chdir("/home") >>> getcwd() '/home' انظر أيضًا الدالة ()os.chdir: تُغيّر مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تتحقّق الدالة من أنّ البيانات الثنائية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة b.startswith() المعاملات prefix التسلسل الذي ستبحث عنه الدالة، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). start الموقع الذي تبدأ منه الدالة عملية الاختبار ضمن التسلسل الأصلي. end الموقع الذي تنهي فيه الدالة عملية المقارنة ضمن التسلسل الأصلي. القيمة المعادة تعيد الدالة startswith()‎ القيمة True إن كان التسلسل الأصلي يبدأ بالقيمة الممرّرة إلى المعامل prefix، وتعيد القيمة False فيما عدا ذلك. أمثلة >>> name = b'Hsoub ...

تفتح الدالة قاعدة بيانات gdbm وتعيد كائن gdbm. البنية العامة dbm.gnu.open(filename[, flag[, mode]]) المعاملات filename حدّد المعامل filename اسم ملف قاعدة البيانات المراد فتحها. flag يأخذ المعامل الاختياري flag إحدى القيم التالية: القيمة الوصف 'r' فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية). 'w' فتح قاعدة البيانات للكتابة والقراءة. 'c' فتح قاعدة البيانات للكتابة والقراءة، وإنشائها في حال عدم وجودها. 'n' تنشئ الدالة قاعدة بيانات جديدة وفارغة، وتفتحها للكتابة والقراءة. يمكن كذلك إلحاق الحروف الإضافية التالية إلى المعامل flag للتحكم في ...

تُعيد الدالة سلسلة بايت (bytestring) تحتوي على مُجلَّد العمل الحالي. البنية العامة getcwdb() القيمة المعادة تُعيد الدالة سلسلة بايت تحتوي على مُجلَّد العمل الحالي. أمثلة يُظهِر المقتطف أدناه محاولتين لاستخدام الدالة ()os.chdir لتغيير مُجلَّد العمل الحالي، ومن ثمَّ طباعته باستخدام الدالة ()os.getcwdb. >>> from os import chdir, getcwd >>> chdir("/") >>> getcwd() b'/' >>> chdir("/home") >>> getcwd() b'/home' انظر أيضًا الدالة ()os.chdir: تُغيّر مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. الدالة ()os.getcwd: تُعيد سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. مصادر قسم الوحدة os في توثيق بايثون ...

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

تُحدّث الدّالة locals()‎ قاموسًا يُمثّل جدول الرموز المحليّ (local symbol table) وتُعيده. البنية العامة locals() المعاملات لا توجد مُعاملات. القيمة المعادة قاموس يُمثّل المتغيّرات المحليّة. ملاحظات تُعاد المُتغيّرات الحرّة (free variables) من طرف الدّالة عند استدعائها داخل الدّوال وليس داخل الأصناف. لا يجب تعديل مُحتويات القاموس المُعاد، إذ أنّ التّعديلات قد لا تُؤثّر على المتغيّرات المحليّة والحرّة المُستخدمة من طرف المُفسّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> y = 1 # هذا المتغيّر لن يكون محليّا نسبة ...

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

تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد. البنية العامة pprint.pprint(object, stream=None, indent=1, width=80, depth=None, *, compact=False) المعاملات إن أخذ المعامل stream القيمة None فستستخدم الدالة sys.stdout. يمكن استخدام هذه الدالة في مفسر بايثون التفاعلي عوضًا عن الدالة print()‎ لتفحّص القيم (يمكن كذلك إعادة إسناد print = pprint.pprint لاستخدامها ضمن نطاق معين). تُمرّر المعاملات indent و width و depth و compact إلى الدالة البانية للصنف PrettyPrinter كمعاملات تنسيق. ملاحظة: أضيف المعامل compact في الإصدار 3.4 من ...

تحذف الدالة الملفات المؤقتة التي خلّفتها الاستدعاءات السابقة للدالة urlretrieve()‎. البنية العامة urllib.request.urlcleanup() انظر أيضًا الدالة urllib.request.urlretrieve()‎: تنسخ الدالة كائن شبكة network object المشار إليه بواسطة عنوان URL إلى ملف محلّي. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تضغط الدالة البايتات المعطاة، وتعيد كائن bytes يتضمّن البيانات المضغوطة. البنية العامة zlib.compress(data, level=-1) ‎المعاملات level المعامل level هو عدد صحيح ضمن النطاق 0 إلى 9 أو ‎-1 ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة 1 تقابل المستوى(Z_BEST_SPEED) وهو الأسرع ويعطي أقل مقدار من الضغط، والقيمة 9تقابل المستوى(Z_BEST_COMPRESSION) وهو الأبطأ وينتج أكبر مقدار من الضغط. أما القيمة 0 فتقابل المستوى (Z_NO_COMPRESSION) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل هي ‎-1 وتقابل ‎(Z_DEFAULT_COMPRESSION)‎ وتقدّم هذه القيمة حالة من التوازن ...

تعيد موقع الإدراج الذي يأتي بعد (إلى الجانب الأيمن) العناصر المماثلة للعنصر المضاف في المصفوفة المعطاة. البنية العامة bisect.bisect_right(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. إن كان العنصر x موجودًا من قبل في القائمة a، فإنّ موقع الإدراج سيكون بعد (إلى يمين) العناصر الموجودة أصلًا. يمكن استخدام القيمة المعادة كأول معامل في التابع list.insert()‎ على افتراض أنّ القائمة a مفروزة أصلًا. القيمة ...

تعيد الدّالة reversed()‎ مُكرّرًا معكوسًا يحتوي على كائن التّسلسل (sequence) المُعطى بالتّرتيب المُعاكس. البنية العامة reversed(seq) المعاملات seq تسلسل القيم المرغوب الحصول على مُكرّر مُعاكس لها. يجب أن تكون قيمة المُعامل كائنًا يمتلك صنفه التّابع الخاصّ ‎_‎_‎reversed‎_‎_‎(‎)‎ أو أن يدعم بروتوكول التّسلسل (أي أن يحتوي صنفه على التّابع ‎_‎_‎len‎_‎_‎(‎)‎ والتّابع ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات أعداد صحيحة تبدأ من الصّفر). القيمة المعادة مُكرّر تكون عناصره نتيجة عكس ترتيب العناصر المُعطاة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّنا نُحوّل المُكرّر ...

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

تفك الدالة ترميز شبيه المسار (path-like) المُمرَّر من ترميز نظام الملفات، مُستخدِمةً مُعالِج الأخطاء 'surrogateescape' أو المُعالِج 'strict' في أنظمة ويندوز. البنية العامة fsdecode(filename) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. 3.6 دُعِمَ استقبال الكائِنات المُنفِّذة للواجهة os.PathLike. المعاملات filename شبيه المسار المُراد فك ترميزه من ترميز نظام الملفات. القيمة المعادة تُعيد الدالة سلسلة نصيّة غير مُغيّرة من الأصل، مفكوكة الترميز من ترميز نظام الملفات الخاص بالنظام. تقوم الدالة ()os.fsencode بالعملية العكس للدالة ()os.fsdecode. أمثلة يُبيّن المثال ...

تُرمِّز الدالة شبيه المسار (path-like) المُمرَّر بترميز نظام الملفات، مُستخدِمةً مُعالِج الأخطاء 'surrogateescape' أو المُعالِج 'strict' في أنظمة ويندوز. البنية العامة fsencode(filename) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. 3.6 دُعِمَ استقبال الكائِنات المُنفِّذة للواجهة os.PathLike. المعاملات filename شبيه المسار المُراد ترميزه بترميز نظام الملفات. القيمة المعادة تُعيد الدالة سلسلة بايتات غير مُغيّرة من الأصل، مُرمَّزة بترميز نظام الملفات الخاص بالنظام. تقوم الدالة ()os.fsdecode بالعملية العكس للدالة ()os.fsencode. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from ...

هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  البنية العامة cgi.parse_qs(qs, keep_blank_values=False, strict_parsing=False) انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). الدالة cgi.parse_header()‎: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة ...

تعيد الدّالة map()‎ مُكرّرًا (iterator) يُطبّق الدّالة المُعطاة على كل عنصر من عناصر الكائن القابل للتّكرار المُعطى وتعاد نتيجة الاستدعاء في كلّ مرّة. البنية العامة map(function, iterable, ...) المعاملات function الدّالة المرغوب تطبيقها على كلّ عنصر من عناصر المُعامل iterable. iterable الكائن القابل للتّكرار المُراد استدعاء الدّالة function على كلّ عنصر من عناصره. يُمكن كذلك تمرير أكثر من كائن واحد قابل للتّكرار، وإن كان الأمر كذلك، فستُطبّق الدّالة على كلّ عنصر من عناصر الكائنات القابلة للتّكرار على التّوازي، وسيتوقّف المُكرّر ...

تعيد الدّالة min()‎ أصغر عنصر من عناصر كائن قابل للتّكرار أو أصغر مُعامل من مُعاملين أو أكثر. البنية العامة min(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل min(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أضغر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

تدرج الدالة العنصر المحدّد في المصفوفة المعطاة بترتيب مفروز. البنية العامة bisect.insort_left(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. هذه الدالة مكافئة للتعبير a.insert(bisect.bisect_left(a, x, lo, hi), x)‎ على فرض أنّ المصفوفة a مفروزة أصلًا. يجب الانتباه إلى أنّ عملية البحث ذات السرعة O(log n)‎ تكون محكومة بعملية الإدراج البطيئة ذات السرعة O(n)‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import bisect >>> ...

تعيد الدّالة ord()‎ عددًا صحيحًا يُمثّل نقطة رمز Unicode المحرف المُعطى. البنية العامة ord(c) المعاملات c سلسلة نصيّة تُمثّل المحرف المرغوب الحصول على نقطة رمز Unicode الخاصّة به. القيمة المعادة عدد صحيح يُمثّل نقطة رمز Unicode الخاصّة بالمحرف المُعطى. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> ord('a') 97 >>> ord('€') 8364 انظر أيضًا الأعداد الصحيحة في بايثون. السلاسل النصية في بايثون. الدالة chr()‎: الحصول على المحرف الموافق لنقطة الرّمز. مصادر قسم الدالة ord في صفحة Functions في توثيق Python الرسمي.

تتعامل هذه الدالة مع الاستثناء الموصوف في المعاملات، وتنسّق رسالة الخطأ بصيغة HTML وتعيد النتيجة كسلسلة نصية. البنية العامة cgitb.html(info, context=5) ‎المعاملات info تصف قيمة هذا المعامل الاستثناء الذي ستتعامل معه الدالة، وقيمته عبارة عن صفٍّ tuple ذي ثلاثة عناصر وهو نتيجة استدعاء الدالة sys.exc_inf()‎. context معامل اختياري، يحدّد عدد الأسطر التي ستُعرض في رسالة الخطأ والتي تحيط بالسطر الذي يحتوي على الخطأ في الشيفرة المصدرية، ويأخذ هذا المعامل القيمة الافتراضية 5. القيمة المعادة تعيد الدالة رسالة الخطأ على هيئة ...

تُعيد الدالة عدد المُعالجات المتوفرة في النظام. البنية العامة cpu_count() سجل التغييرات الإصدار التغييرات 3.4 أُضيفَت الدالة في هذا الإصدار. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل عدد المُعالجات المتوفرة في النظام. ستُعيد الدالة القيمة None في حال لم تستطع تحديد عدد المعالجات. ملاحظة: لا يُساوي عدد المُعالجات المُعاد من هذه الدالة عدد المعالجات التي يُمكِن للعملية استخدامها. يُمكِنك الحصول على الأخير عبر استخدام التعبير len(os.sched_getaffinity(0))‎. أمثلة في المقتطف أدناه مثال عن استخدام الدالة في جهاز ثنائي المعالِج. >>> ...

تعيد الدالة يوم الأسبوع في اليوم المعطى في الشهر المعطى في السنة المعطاة. البنية العامة calendar.weekday(year, month, day) المعاملات year السنة المطلوبة. month الشهر المطلوب. day اليوم المطلوب. القيمة المعادة تعيد الدالة يوم الأسبوع (0 هو يوم الإثنين و 6 هو يوم الأحد) للسنة year (من 1970 وما بعدها) في الشهر month (يأخذ القيم 1-12) واليوم day (يأخذ القيم 1-31). أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekday(1988, 2, 7) 6 مصادر صفحة General calendar-related functions في توثيق ...

تُحوّل الدّالة bin()‎ عددًا صحيحًا (integer number) إلى سلسلةٍ نصيّةٍ ثنائيّة (binary string) مسبوقة بالمقطع النّصيّ "0b". البنية العامة bin(x) المعاملات x عدد صحيح، إن لم يكن كائنًا من النّوع int، فيجب على الكائن أن يحتوي على التّابع الخاصّ ‎_‎_index‎_‎_()‎ الذي يجب عليه أن يُعيد عددًا صحيحًا. القيمة المعادة سلسلة نصيّة ثنائيّة مسبوقة بالمقطع النّصيّ "0b". أمثلة تُوضّح الأمثلة التّالية كيفيّة عمل هذه الدّالة: >>> bin(3) '0b11' >>> bin(-10) '-0b1010' ملاحظات إن لم ترغب بالحصول على السّابقة "0b"، يُمكنك استعمال أحد الطرائق التّاليّة: ...

تعيد الدّالة slice()‎ كائن slice يُمثّل مجموعة فهارس (indices) تُحدّد من طرف الاستدعاء ‎range‎(‎start‎,‎ stop‎, ‎step‎)‎‎. البنية العامة class slice(stop) class slice(start, stop[, step]) المعاملات start مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل بداية الفهارس. stop المُعامل المطلوب الوحيد، والذي يُمثّل نقطة توقّف الفهارس. step مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل الخطوة التي بين كل فهرس وآخر. القيمة المعادة كائن slice‎ يحتوي على خصائص start، وstop، وstep قابلة للقراءة فقط، والتي تُعيد قيمة المُعامل المُرتبط بها. الكائن المُعاد لا يمتلك ...

تضبط الدالة المُعرَّف الحقيقي والفعلي لمجموعة العملية الحالية. البنية العامة setregid(rgid, egid) الدالة متوافرة في أنظمة يونكس. المعاملات rgid المُعرِّف الحقيقي الجديد المُراد إسناده لمجموعة العملية الحالية. egid المُعرِّف الفعلي الجديد المُراد إسناده لمجموعة العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import setregid >>> setregid(1,2) مصادر قسم الوحدة os في توثيق بايثون الرسمي. ...

تضبط الدالة المُعرِّف الحقيقي والفعلي والمحفوظ لمجموعة العملية الحالية. البنية العامة setresgid(rgid, egid, sgid) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. الدالة متوافرة في أنظمة يونكس. المعاملات rgid المُعرِّف الحقيقي الجديد المُراد إسناده لمجموعة العملية الحالية. egid المُعرِّف الفعلي الجديد المُراد إسناده لمجموعة العملية الحالية. sgid المُعرِّف المحفوظ الجديد المُراد إسناده لمجموعة العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. ...

تحذف الدالة وتعيد أصغر عنصر في الكومة مع الحفاظ على ثبات الكومة. البنية العامة heapq.heappop(heap) المعاملات heap اسم الكومة التي سيُحذف أصغر عنصر منها. القيمة المعادة تحذف الدالة وتعيد أصغر عنصر في الكومة heap، مع الحفاظ على ثبات الكومة. إن كانت الكومة فارغة، تطلق الدالة الخطأ IndexError. للوصول إلى أصغر عنصر دون حذفه، يمكن استخدام heap[0]‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print(list(li)) [1, 3, 9, 7, 5] >>> heapq.heappop(li) 1 >>> ...

تُنشئ الدّالة setattr()‎ قيمة لخاصيّة كائن مُعيّن. البنية العامة setattr(object, name, value) المعاملات object الكائن المُراد تعديل خاصيّة من خاصيّاته أو إضافة خاصّية جديدة إليه إن لم تكن موجودة مُسبقًا. name سلسلة نصيّة تُمثّل اسم الخاصيّة، يُمكن أن تكون الخاصيّة موجودة مُسبقًا (ستُغيّر قيمتها) أو غير موجودة (ما يعني أنّها ستُنشأ). value القيمة المرغوب إسنادها للخاصيّة. القيمة المعادة القيمة None. ملاحظات يجب على الكائن أن يسمح بتعديل خاصيّاته. الاستدعاء ‎setattr‎(‎x,‎ ‎'foobar'‎, 123‎)‎ مُكافئ للجملة ‎x.‎‎foobar‎ ‎=‎‎ 123‎. أمثلة المثال التّالي ...

تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر. البنية العامة fdopen(fd, [, mode[, bufsize]]) المعاملات fd واصِف الملفات المُراد ربط كائِن الملف المُعاد به. mode مُعطى اختياري ينبغي تمرير سلسلة نصيّة له تحوي الوضع المُراد فتح الملف به. bufsize مُعطى اختياري يُحدِّد حجم الصِوان (buffer) المُراد استخدامه. القيمة المعادة تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر للمعامِل fd. هذه الدالة مُكافِئة للدالة ()open المُضمَّنة داخليًّا في بايثون، وكذلك تستقبل نفس مُعطياتها. الفرق الوحيد بين الدالة ()fdopen والدالة ...

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

تُعيد الدالة صفًّا يحتوي على المُعرِّف الحقيقي والفعلي والمحفوظ لمجموعة العملية الحالية. البنية العامة getresuid() القيمة المعادة تُعيد الدالة صفًّا يحتوي (بالترتيب المذكور) على المُعرِّف الحقيقي (real) والفعلي (effective) والمحفوظ (saved) لمجموعة العملية الحالية. أمثلة في المقتطف أدناه مثالين على استخدام الدالة للحصول على المُعرِّفات الثلاث لمجموعة العملية الحالية. >>> from os import getresuid >>> getresuid() (1000, 1000, 1000) >>> getresuid() (0, 0, 0) مصادر قسم الصفحة os في توثيق بايثون الرسمي.

تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. البنية العامة pprint.isreadable(object) القيمة المعادة تعيد هذه الدالة القيمة False دائمًا مع الكائنات التعاودية Recursive objects. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pprint.pprint(stuff) [<Recursion on list with id=...>, 'spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> pprint.isreadable(stuff) False انظر أيضًا التابع PrettyPrinter.isreadable()‎: يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا ...

تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. البنية العامة copyreg.pickle(type, function, constructor=None) ‎المعاملات type نوع الكائنات التي ستعمل دالة الاختزال عليها. function الدالة التي ستستخدم كدالة اختزال. يجب أن تعيد الدالة المعطاة سلسلة نصية أو صفًّا يتضمّن عنصرين أو ثلاثة. constructor يجب أن يكون هذا المعامل الاختياري كائنًا قابلًا للاستدعاء يمكن استخدامه لإعادة بناء الكائن عند استدعاءه مع صفّ المعاملات المعاد بواسطة الدالة المعطاة عند إجراء عملية السَلسَلة. القيمة المعادة راجع وحدة ...

تُغيّر الدالة مُجلَّد الجذر للعملية الحالية إلى المسار المُمرَّر. البنية العامة chroot(path) الدالة متوافرة في أنظمة يونكس. المعاملات path المسار المراد تغيير مُجلَّد الجذر للعملية الحالية إليه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة ينبغي تنفيذها بصلاحية الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import chroot >>> chroot("/home") مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تُحوّل الدّالة functools.singledispatch()‎ دالّةً عاديّة إلى دالّة عموميّة وحيدة الإرسال (single-dispatch generic function). الدّالة العموميّة هي كلّ دالّة تتكوّن من عدّة دوال تُنفّذ نفس العمليّة لعدّة أنواع. تُحدّد الدّالة التي ستُنفّذ عبر خوارزميّة الإرسال (dispatch algorithm). تكون الدّالة العموميّة وحيدةَ إرسالٍ إذا كان نوع مُعامل واحد هو الذي يُحدّد الدّالة التي ستُنفَّذ. البنية العامة @functools.singledispatch المعاملات لا توجد مُعاملات القيمة المعادة دالّة عموميّة وحيدة الإرسال. أمثلة لإنشاء دالّة عموميّة، زخرِفها بالمُزخرِف ‎@singledispatch‎. لاحظ أنّ الإرسال يحدث عند نوع أوّل مُعامل: ...

تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلّا فإنّ الدالة تكون مكافئة للدالة webbrowser.open_new()‎. البنية العامة webbrowser.open_new_tab(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new_tab("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new()‎: تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون الرسمي.

يضيف التابع صنف معالجة إلى كائن OpenerDirector. البنية العامة OpenerDirector.add_handler(handler) ‎المعاملات ‎يبحث التابع في التوابع التالية وتُضاف إلى سلاسل التوابع المحتملة (لاحظ أنّ أخطاء HTTP تعدّ حالة خاصة). protocol_open()‎: إشارة إلى أنّ المعالج يعرف كيف يفتح عناوين URL الخاصة بالبروتوكول. http_error_type()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء HTTP مع شيفرة أخطاء HTTP ‏type. protocol_error()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء من بروتوكول (غير http). protocol_request()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج طلبات protocol مسبقًا. protocol_response()‎: ...

تدرج الدالة القيمة المعطاة في الكومة، مع الحفاظ على ثبات الكومة. البنية العامة ‎heapq.heappush(heap, item) المعاملات item القيمة المراد إدراجها في الكومة. heap الكومة التي ستُدرج فيها قيمة المعامل item. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print (list(li)) [1, 3, 9, 7, 5] >>> heapq.heappush(li, 4) >>> print(list(li)) [1, 3, 4, 7, 5, 9] انظر أيضًا الدالة heappop()‎: تحذف الدالة وتعيد أصغر عنصر في الكومة، مع الحفاظ على ثبات الكومة. الدالة heappushpop()‎: ...

تُغلِق الدالة واصفات الملفات بدءً من الواصِف المُمرَّر للمعامل fd_low وصولًا إلى الواصِف الذي يَسبُق الواصِف المُمرَّر للمعامل fd_high، مُتجاهلةً الأخطاء التي قد تَحدُث. البنية العامة closerange(fd_low, fd_high) المعاملات fd_low العدد البادِئ لمجال الواصِفات التي ستُغلَق (سيُغلَق الواصِف المُقابِل لهذا العدد). fd_high العدد المُمثِّل لنهاية مجال الواصِفات التي ستُغلَق (لن يُغلَق الواصِف المُقابِل لهذا العدد). القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). أمثلة يُكافِئ استخدام الدالة تنفيذ الكود (ولكن الدالة تفعل ذلك بشكل أسرع): import ...

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

تعيد الدّالة itertools.product()‎ حاصل الضرب الديكارتي (أو الضرب المباشر) للكائنات القابلة للتّكرار المُعطاة. طريقة العمل مُكافئة لحلقات for المُتداخلة في تعبير مُولّد. مثلًا، الاستدعاء product(A, B)‎ يُعيد ما يُعيده التّعبير ‎((x,y)‎ for‎ x‎ in A‎ for y in B‎)‎. تدور الحلقات المُتداخلة مثل عدّاد مسافة (odometer) من العنصر على أقصى اليمين مُتقدّمةً عند كلّ تكرار. يُنشئ هذا النّسق ترتيبًا مُعجميًّا (lexicographic)، لذا فإن كانت الكائنات القابلة للتّكرار المُعطاة مُرتّبةً، فستُنتج صفوف الضّرب المُباشر مُرتّبةً. البنية العامة itertools.product(*iterables, repeat=1) المعاملات iterables ...

تُحوّل الدّالة functools.cmp_to_key()‎ دالّة مُقارنة (comparison function) إلى دالّة مفتاح (key function). تُستعمل مع الأدوات التي تقبل دوالّ مفتاح مثل sorted()‎، وmin()‎، وmax()‎، وheapq.nlargest()‎، وheapq.nsmallest()‎، وitertools.groupby()‎. تُستعمل هذه الدّالة أساسًا كأداة لنقل البرامج من Python 2 التي دعمت استعمال دوال المُقارنة. دالّة المُقارنة هي كلّ كائن قابل للاستدعاء يستقبل مُعاملين ويُقارن بينهما، ويُعيد عددًا سالبًا في حالة أصغر من، الصّفر في حالة التّساوي، وعددًا موجبًا في حالة أكبر من. ودالّة مفتاح هي كائن قابل للاستدعاء يستقبل مُعاملًا واحدًا ويُعيد قيمةً ...

هذه الدالة مشابهة للدالة quote()‎ ولكنّها تستبدل المسافات الفارغة بعلامات +، وهذا هو المطلوب لاقتباس قيم نماذج HTML عند بناء سلاسل الاستعلام النصية التي ستُستخدم في عنوان URL. البنية العامة urllib.parse.quote_plus(string, safe='', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. تُهرّب علامات + في السلسلة النصية الأصلية إلا إذا أدرجت كقيمة للمعامل safe. لا يأخذ المعامل safe القيمة الافتراضية '/' كما هو الحال مع الدالة quote()‎. string يمكن أن ...

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

تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. البنية العامة marshal.load(file) ‎المعاملات file الملف الذي ستقرأ الدالة منه قيمة واحدة. يجب أن يكون الملف المعطى ملفًّا ثنائيًا قابلًا للقراءة. القيمة المعادة تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. في حال عدم تمكّن الدالة من قراءة أيّ قيمة سليمة (كأن يكون السبب هو أنّ البيانات تمتلك نسخة ترتيب مختلفة وغير متوافقة مع نسخة الترتيب في إصدار بايثون المستخدم) تطلق اللغة الخطأ EOFError أو ValueError أو TypeError. أمثلة يبين المثال التالي ...

تختبر الدالة ما إذا كان اختبار السلامة مدعومًا من قبل نظام التشغيل أم لا. البنية العامة lzma.is_check_supported(check) المعاملات ‎check الاختباران CHECK_NONE و CHECK_CRC32 مدعومان دائمًا، أما الاختباران CHECK_CRC64 و CHECK_CRC256 فقد لا يكونان متوفّرين إن كنت تستخدم نسخة من liblzma بنيت مع مجموعة محدّدة من الميزات. القيمة المعادة تعيد الدالة القيمة True إن كان اختبار السلامة مدعومًا من قبل نظام التشغيل. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

الدّالة functools.lru_cache()‎ مُزخرفٌ يُحيط دالّة بكائن قابل للاستدعاء مُتذكّر (memoizing callable). الكائن المُتذكِّر يحتفظ بعددٍ من آخر الاستدعاءات حسب قيمة المُعامل maxsize. ويُمكن أن تختصر الوقت إن كانت دالّة تأخذ الكثير من الوقت تُستدعَى بنفس المُعاملات عدّة مرّات. ولأنّ النّتائج تُخبّأ (cache) في قاموس، فيجب على المُعاملات المُمرّرة للدّالة المُزخرَفة أن تكون قابلة للتّجزئة (hashable). البنية العامة @functools.lru_cache(maxsize=128, typed=False) المعاملات maxsize عدد الاستدعاءات التي ستُخبّأ، إن مُرّرت له القيمة None، تُعطّل ميّزة LRU (الأقلّ استخدامًا مؤخّرًا، Least recently used) ويُمكن ...