نتائج البحث

تُعيد الدالة مُعرِّف المجموعة للعملية ذات المُعرِّف المُمرَّر. البنية العامة 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)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...