نتائج البحث

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

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time()‎. البنية العامة ‎datetime.fromtimestamp(timestamp, tz=None) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. tz صنف فرعي من الصنف tzinfo، يحدّد المنطقة الزمنية. يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له. إن لم يأخذ المعامل tz القيمة None، فيجب ...

يحذف التابع الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. البنية العامة x.lstrip() المعاملات chars سلسلة نصية تحدّد مجموعة الحروف المراد حذفها من السلسلة النصية الهدف. في حال عدم تمرير هذا المعامل أو تمرير القيمة None، تحذف الدالة المسافات البيضاء من بداية السلسلة النصية. يحذف التابع أي مزيج من الحروف الموجودة في chars. القيمة المعادة يعيد التابع نسخةً من السلسلة النصية بعد حذف الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. أمثلة يوضح المثال التالي النتائج المعادة من تطبيق هذا ...

تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى. البنية العامة csv.reader(csvfile, dialect='excel', **fmtparams) ‎المعاملات csvfile ملف csv المراد قراءة محتوياته، ويمكن أن تكون قيمة هذا المعامل أيّ كائن يدعم بروتوكول المكرِّر iterator protocol ويعيد سلسلة نصية في كلّ مرة يجري فيها استدعاء التابع ‎__next__()‎، وعادة ما تكون كائنات الملفات وكائنات القوائم ملائمة لهذا الغرض. إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل ''newline=‎. ملاحظة: إن لم تحدد القيمة ''newline=‎ ...

هذا التابع من التوابع غير المعيارية والذي يسهل عملية تنفيذ جمل SQL متعددة دفعة واحدة. ينفّذ هذا التابع جملة COMMIT في البداية، ثم ينفّذ بعدها شيفرة SQL المعطاة في المعاملات. البنية العامة executescript(sql_script) ‎المعاملات sql_script يمكن لهذا المعامل أن يكون نسخة من الكائن str. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 con = sqlite3.connect(":memory:") cur = con.cursor() cur.executescript(""" create table person( firstname, lastname, ...

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

تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. البنية العامة marshal.dumps(value[, version]) ‎المعاملات value القيمة المطلوبة. version يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version). القيمة المعادة تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. يجب أن تكون القيمة المعطاة مدعومة، وتطلق اللغة الاستثناء ValueError إن كانت القيمة غير مدعومة أو تتضمّن كائنًا غير مدعوم. أمثلة يبين المثال التالي آلية عمل الدالة: >>> ...

تقدّم كائنات الاتصال Connection عددًا من الخصائص والتوابع التي تساعد المستخدم في التعامل مع قواعد بيانات SQLite، كالاتصال بقاعدة البيانات وتحميل الملحقات وإنشاء النسخ الاحتياطية وغيرها. تنشأ كائنات الاتصال كنتيجة لاستدعاء الدالة sqlite3.connect()‎. خصائص كائنات الاتصال تمتلك كائنات الاتصال بقواعد البيانات SQLite الخصائص التالية: الخاصية isolation_level يمكن استخدام هذه الخاصية لمعرفة مستوى العزل الافتراضي الحالي أو تعيينه. تأخذ الخاصية القيمة None لنمط الحفظ التلقائي autocommit أو إحدى القيم "DEFERRED" أو "IMMEDIATE" أو "EXCLUSIVE". راجع قسم التحكم بالإجراءات للمزيد من المعلومات. ...

يقسم هذا التابع التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم. البنية العامة str.partition(sep) المعاملات sep كائن شبيه بالبايتات (bytes-like object) يحدّد الفاصل الذي ستعتمده الدالة في تقسيم التسلسل. القيمة المعادة تعيد هذه الدالة صفًّا مكوّنًا من ثلاثة عناصر، الأول هو جزء التسلسل الذي يسبق الفاصل، والثاني هو الفاصل نفسه أو نسخة عنه من نوع مصفوفة البايتات، والثالث هو الجزء الذي يلي الفاصل. في حال عدم العثور على الفاصل يعيد التابع صفًّا مكوّنًا من ثلاثة عناصر، الأوّل هو نسخة عن ...

تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ...