نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

البايتات byte في بايثون

البايتات هي تسلسلات لبايتات مفردة غير قابلة للتغيير (immutable)، وهي مشابهة إلى حدّ كبير للسلاسل النصية. توفّر هذه الكائنات توابع تكون صالحة للاستخدام مع البيانات ذات الترميز ASCII نظرًا لأنّ الكثير من البروتوكولات الثنائية الرئيسية مستندة إلى هذا الترميز. تعريف البايتات صيغة تعريف البايتات مماثلة لصيغة تعريف السلاسل النصية، باستثناء إضافة السابقة b إلى عبارة التعريف وكما يلي: b'still allows embedded "double" quotes' # علامات اقتباس مفردة b"still allows embedded 'single' quotes". ...

Python/pathlib/Path/write bytes

التابع Path.write_bytes يفتح الملف المُشار إليه في نمط bytes، ويكتب البيانات فيه ثم يُغلقه. >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' إن كان المسار يشير إلى ملف موجود مسبقًا، فإن الكتابة عليه تؤدي إلى حذف المحتوى السابق. تابع مُستحدث في السخة 3.5.

Python/pathlib/Path/read bytes

التابع PurePath.read_bytes في بايثون يعيد هذا التابع المحتوى المرمّز للملف المُشار إليه ككائن من النوع bytes تم استحداث هذا التابع في النسخة 3.5 البنية العامة >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' المعاملات بدون معاملات القيمة المعادة يعيد هذا التابع المحتوى المرمّز للملف المُشار إليه ككائن من النوع bytes أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = Path('my_binary_file') >>> p.write_bytes(b'Binary file contents') 20 >>> p.read_bytes() b'Binary file contents' انظر أيضًا مصادر

الدالة byte()‎ في أردوينو

تحول الدالة byte()‎ القيمة المُمرَّرة إليها إلى النوع «بايت» (byte). البنية العامة byte(x) المعاملات x القيمة المراد تحويلها، ويمكن أن تكون أيَّ نوعٍ من البيانات. القيم المعادة يعاد بايتٌ يمثِّل ناتج تحويل القيمة x. أمثلة مثال على استعمال الدالة byte()‎: void setup() { Serial.begin(9600); } void loop() { Serial.println(byte('a')); // 97 Serial.println(byte(10)); // 10 } انظر أيضًا الدالة char()‎: تحول القيمة المُمرَّرة إليها إلى النوع «محرف» (char). الدالة float()‎: تحول القيمة المُمرَّرة إليها إلى النوع «عدد عشري» (float). ...

النوع byte في أردوينو

يُخزِّن النوع byte عددًا عديم الإشارة بحجم 8 بت؛ أي من القيمة 0 إلى القيمة 255. البنية العامة byte var_name; byte var_name = Number; // 0 - 255 أمثلة مثال على تعريف متغير من النوع byte: byte myNumber = 125; byte result = myNuber / 5; انتبه إلى أنَّه ستُهمَل الأعداد التي بعد الفاصلة في الحالة الثانية إن نتج عن عملية القسمة (أو أية عملية حسابية) عددًا عشريًّا. انظر أيضًا النوع array: يمثِّل مصفوفة من المتغيرات الموضوعة في وعاء واحد والتي يمكن الوصول ...

الدالة lzma.compress()‎ في بايثون

تضغط الدالة البيانات المعطاة (كائن bytes) وتعيد البيانات المضغوطة على هيئة كائن bytes. البنية العامة lzma.compress(data, format=FORMAT_XZ, check=-1, preset=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMACompressor للاطلاع على وصف مفصّل للمعاملات format و check و preset و filters. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات المضغوطة. أمثلة يبين المثال التالي طريقة ضغط البيانات في الذاكرة: import lzma data_in = b"Insert Data Here" data_out = lzma.compress(data_in) انظر أيضًا الدالة lzma.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات ...

الدالة lzma.decompress()‎ في بايثون

تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات غير المضغوطة على هيئة كائن bytes. تفكّ الدالة الضغط عن كل تدفّقات البيانات المعطاة إن كانت ناتجة عن ربط مجموعة من التدفّقات المضغوطة، وتعيد حاصل عملية ربط النتائج بعضها ببعض. البنية العامة lzma.decompress(data, format=FORMAT_AUTO, memlimit=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMADecompressor للاطلاع على وصف مفصّل للمعاملات format و memlimit و filters. القيمة المعادة تعيد الدالة البيانات غير المضغوطة على هيئة كائن bytes. انظر أيضًا الدالة lzma.compress()‎: تضغط ...

الدالة urllib.parse.quote_from_bytes()‎‎ في بايثون

هذه الدالة مشابهة للدالة quote()‎ ولكنّها تستقبل كائنات bytes عوضًا عن كائنات str، ولا تؤدي عمليات الترميز من السلاسل النصية إلى البايتات. البنية العامة urllib.parse.quote_from_bytes(bytes, safe='/') ‎المعاملات bytes كائن bytes. safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يأخذ هذا المعامل القيمة الافتراضية '/'. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.parse >>> urllib.parse.quote_from_bytes(b'a&\xef') 'a%26%EF' انظر أيضًا الدالة urllib.parse.quote()‎: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. الدالة ...

التابع bytes.count()‎ في بايثون

يعيد هذا التابع عدد مرات ظهور تسلسل فرعي ضمن كائن bytes. البنية العامة bytes.count(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة عدد مرات ظهوره ضمن كائن bytes. يمكن للتسلسل الفرعي أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). ملاحظة: في الإصدار 3.3 من بايثون، أصبح بالإمكان استخدام الأعداد الصحيحة من 0 إلى 255 كقيمة لهذا المعامل. start معامل اختياري، يحدد الموقع الذي يبدأ منه التابع عملية البحث ضمن كائن bytes. end معامل اختياري، يحدد الموقع الذي ينهي فيه التابع ...

التابع bytes.count()‎ في بايثون

يعيد هذا التابع عدد مرات ظهور تسلسل فرعي ضمن كائن bytes. البنية العامة bytes.count(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة عدد مرات ظهوره ضمن كائن bytes. يمكن للتسلسل الفرعي أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). ملاحظة: في الإصدار 3.3 من بايثون، أصبح بالإمكان استخدام الأعداد الصحيحة من 0 إلى 255 كقيمة لهذا المعامل. start معامل اختياري، يحدد الموقع الذي يبدأ منه التابع عملية البحث ضمن كائن bytes. end معامل اختياري، يحدد الموقع الذي ينهي فيه التابع ...

الدالة gzip.decompress()‎ في بايثون

تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. البنية العامة gzip.decompress(data) المعاملات ‎data البيانات المراد ضغطها. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات غير المضغوطة. انظر أيضًا الدالة gzip.compress()‎: تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. مصادر صفحة Support for gzip files في توثيق بايثون الرسمي.

الدالة bytes.hex()‎ في بايثون

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

الدالة bytes.hex()‎ في بايثون

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

التابع Decompress.flush()‎ في بايثون

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. البنية العامة Decompress.flush([length]) المعاملات length معامل اختياري يحدّد الحجم الابتدائي لذاكرة المخرجات output buffer. لا يمكن استدعاء التابع decompress()‎ مرة أخرى بعد استدعاء التابع flush()‎، وما يمكن فعله في هذه الحالة هو حذف الكائن فقط. القيمة المعادة يعيد التابع كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. انظر أيضًا التابع Compress.flush()‎: يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ...

الدالة bytes.fromhex()‎ في بايثون

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

الدالة bytes.fromhex()‎ في بايثون

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

التابع bytes.decode()‎ في بايثون

يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية. البنية العامة bytes.decode(encoding="utf-8", errors="strict") المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة ...

التابع bytes.decode()‎ في بايثون

يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية. البنية العامة bytes.decode(encoding="utf-8", errors="strict") المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة ...

الدالة urllib.parse.unquote_to_bytes()‎‎ في بايثون

تستبدل الدالة الحروف المهرّبة بالصيغة ‎%xx إلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائن bytes. البنية العامة urllib.parse.unquote_to_bytes(string) ‎المعاملات string يجب أن يكون سلسلة نصية أو كائن bytes. إن كانت قيمة هذا المعامل سلسلة نصية، فإنّ الحروف غير المهرّبة والتي تكون خارج نطاق الترميز ASCII سترمّز إلى بايتات في الترميز UTF-8. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.parse >>> urllib.parse.unquote_to_bytes('a%26%EF') b'a&\xef' انظر أيضًا الدالة urllib.parse.quote()‎: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. الدالة urllib.parse.quote_plus()‎: ...

الدالة urllib.parse.quote()‎‎ في بايثون

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. البنية العامة urllib.parse.quote(string, safe='/', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يحمل هذا المعامل القيمة الافتراضية '/'. string يمكن أن يكون سلسلة نصية أو كائن bytes. ملاحظة: اعتُمد المعيار RFC 3986 عوضًا عن المعيار RFC 2396 لاقتباس سلاسل URL النصية في الإصدار 3.7 من بايثون، وقد أضيف الرمز "~" إلى مجموعة المحارف المحجوزة. encoding و errors ...

الدالة marshal.loads()‎ في بايثون

تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. البنية العامة marshal.loads(bytes) ‎المعاملات bytes كائن شبيه بالبايتات. القيمة المعادة تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. في حال عدم عثور الدالة على أي قيمة سليمة، تطلق اللغة الاستثناء EOFError أو ValueError أو TypeError، وتتجاهل الدالة البايتات الإضافية في المدخلات. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import marshal >>> b1 = marshal.dumps('Hello World') >>> print(b1) b'\xfa\x0bHello World' >>> marshal.loads(b1) 'Hello World' انظر أيضًا الدالة marshal.load()‎: تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة ...

الوحدة zlib‎ في بايثون

تتطلب بعض التطبيقات استخدام البيانات المضغوطة، وتتيح الدوال المتوفّرة في هذه الوحدة إجراء عمليات الضغط وفك الضغط على البيانات باستخدام مكتبة zlib، ولهذه المكتبة موقع إلكتروني خاص. يجدر التنبيه إلى وجود بعض المشاكل في التوافقية بين وحدة بايثون والإصدارات 1.1.3 وما دونها من مكتبة zlib، إضافة إلى أنّ الإصدار 1.1.3 يعاني من مشاكل أمنية؛ لذا يُنصح باستخدام الإصدار 1.1.4 أو ما بعده من المكتبة. تقدّم دوال zlib الكثير من الخيارات وغالبًا ما يجب استخدام هذه الدوال في ترتيب معين. لا ...

الوحدة urllib.parse‎‎ في بايثون

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد Uniform Resource Locator (‏URL اختصارًا) إلى مكوّنات (نظام العنونة addressing scheme، موقع الشبكة network location، المسار path ... الخ)، ولدمج هذه المكونات مرّة أخرى في سلسلة URL، ولتحويل "URL نسبي" إلى URL مطلق بالاعتماد على "URL أساسي". صمّمت هذه الوحدة لتطابق معايير RFC للإنترنت الخاصّة بالمحدّدات النسبية لمواقع الموارد المحدّدة Relative Uniform Resource Locators. وتدعم الوحدة الأنواع التالية من مخطّطات URL: file, ftp, gopher, hdl, http, https, imap, mailto, ...

الوحدة urllib.parse‎‎ في بايثون

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد Uniform Resource Locator (‏URL اختصارًا) إلى مكوّنات (نظام العنونة addressing scheme، موقع الشبكة network location، المسار path ... الخ)، ولدمج هذه المكونات مرّة أخرى في سلسلة URL، ولتحويل "URL نسبي" إلى URL مطلق بالاعتماد على "URL أساسي". صمّمت هذه الوحدة لتطابق معايير RFC للإنترنت الخاصّة بالمحدّدات النسبية لمواقع الموارد المحدّدة Relative Uniform Resource Locators. وتدعم الوحدة الأنواع التالية من مخطّطات URL: file, ftp, gopher, hdl, http, https, imap, mailto, ...

الدالة marshal.dumps()‎ في بايثون

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

الدالة urllib.parse.quote_plus()‎‎ في بايثون

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

التابع Decompress.decompress()‎ في بايثون

يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. البنية العامة Decompress.decompress(data, max_length=0) المعاملات data البيانات المراد فك الضغط عنها. max_length معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية unconsumed_tail. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع ...

التابع LZMACompressor.compress()‎ في بايثون

يضغط التابع البيانات المعطاة (كائن bytes) ويعيد كائن bytes يتضمّن البيانات المضغوطة لجزء من المدخلات على الأقل. البنية العامة compress(data) ‎المعاملات data البيانات المراد ضغطها. القيمة المعادة يمكن لبعض البيانات أن تُخزّن داخليًا buffered internally لاستخدامها في الاستدعاءات اللاحقة للدالة compress()‎ والتابع flush()‎. يجب أن تكون البيانات المعادة مترابطة مع المخرجات الناتجة عن الاستدعاءات السابقة للدالة compress()‎. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

Python/os/path

تنفّذ هذه الوحدة بعض التوابع المهمة على أسماء المسارات، حيث يمكن تمرير معالملات المسار كنص أو كائن من نوع bytes، ويُستحسن للتطبيقات أن تقوم بتمثيل أسماء المسارات كسلسلة حروف بترميز Unicode. إلا أن بعض أسماء الملفات لا يمكن تمثيلها كسلاسل نصية في يونكس، لذلك تحتاج التطبيقات التي تدعم أسماء الملفات العشوائية في يونكس إلى تمثيلها باستخدام كائنات من نوع bytes. وبالعكس أيضًا، فاستخدام  كائنات من نوع bytes لا يمكنه تمثيل جميع أسماء الملفات في ويندوز (باستخدام ترميز mbcs المعياري)، لذلك ...

التابع Compress.compress()‎ في بايثون

يضغط التابع البيانات المعطاة ويعيد كائن bytes يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل. البنية العامة Compress.compress(data) المعاملات data البيانات المراد ضغطها. يجب أن تكون هذه البيانات مرتبطة concatenated بالمخرجات الناتجة من أي استدعاءات سابقة للتابع compress()‎. قد يحتفظ التابع ببعض المدخلات في ذواكر داخلية لغرض المعالجة في وقت لاحق. انظر أيضًا التابع Decompress.decompress()‎: يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. ...

الدالة gzip.compress()‎ في بايثون

تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. البنية العامة gzip.compress(data, compresslevel=9) المعاملات ‎data البيانات المراد ضغطها. compresslevel يحدّد المعامل compresslevel مستوى الضغط بنفس الطريقة المعتمدة في الدالة البانية لكائنات GzipFile. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. أمثلة يبين المثال التالي طريقة ضغط سلسلة نصية ثنائية: import gzip s_in = b"Lots of content here" s_out = gzip.compress(s_in) انظر أيضًا الدالة gzip.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. مصادر صفحة Support ...

الدالة urllib.parse.unquote_plus()‎‎ في بايثون

هذه الدالة مشابهة للدالة unquote()‎ ولكنّها تستبدل علامات + بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML. البنية العامة urllib.parse.unquote_plus(string, encoding='utf-8', errors='replace') ‎المعاملات string السلسلة النصية المراد فكّ ترميزها. encoding و errors يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode()‎. يأخذ المعامل encoding القيمة الافتراضية ‎'‎utf-8'‎، أما المعامل 'errors' فيأخذ القيمة الافتراضية 'replace' والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى. ...

الدالة urllib.parse.unquote()‎‎ في بايثون

تحوّل الدالة الحروف المهرّبة بالصيغة ‎%xx إلى الحروف الأصلية المكافئة لها. البنية العامة urllib.parse.unquote(string, encoding='utf-8', errors='replace') ‎المعاملات string السلسلة النصية المراد فكّ ترميزها. encoding و errors يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode()‎. يأخذ المعامل encoding القيمة الافتراضية ‎'‎utf-8'‎، أما المعامل 'errors' فيأخذ القيمة الافتراضية 'replace' والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.parse >>> ...

التابع Compress.flush()‎ في بايثون

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن bytes يحتوي على المخرجات المضغوطة المتبقية. البنية العامة Compress.flush([mode]) المعاملات mode يمكن أن يأخذ المعامل mode إحدى القيم الثابتة التالية: Z_NO_FLUSH، Z_PARTIAL_FLUSH، Z_SYNC_FLUSH، Z_FULL_FLUSH، Z_BLOCK (في الإصدار 1.2.3.4 من zlib) أو ‎Z_FINISH، ويأخذ القيمة الافتراضية Z_FINISH. تسمح جميع الثوابت -باستثناء الثابت Z_FINISH- بضغط سلاسل بايتات إضافية من البيانات، في حين ينهي الثابت Z_FINISH تدفق البيانات المضغوطة ويمنع ضغط المزيد من البيانات. لا يمكن استدعاء التابع compress()‎ مرة أخرى ...

التابع Compress.flush()‎ في بايثون

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن bytes يحتوي على المخرجات المضغوطة المتبقية. البنية العامة Compress.flush([mode]) المعاملات mode يمكن أن يأخذ المعامل mode إحدى القيم الثابتة التالية: Z_NO_FLUSH، Z_PARTIAL_FLUSH، Z_SYNC_FLUSH، Z_FULL_FLUSH، Z_BLOCK (في الإصدار 1.2.3.4 من zlib) أو ‎Z_FINISH، ويأخذ القيمة الافتراضية Z_FINISH. تسمح جميع الثوابت -باستثناء الثابت Z_FINISH- بضغط سلاسل بايتات إضافية من البيانات، في حين ينهي الثابت Z_FINISH تدفق البيانات المضغوطة ويمنع ضغط المزيد من البيانات. لا يمكن استدعاء التابع compress()‎ مرة أخرى ...

التابع bytes.isspace()‎ في بايثون

يتحقق هذا التابع ممّا إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، ومن أنّ التسلسل ليس فارغًا. البنية العامة bytes.isspace() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، وإذا كان التسلسل غير فارغٍ. بايتات المسافة البيضاء في ترميز ASCII هي البايتات التي تقع ضمن التسلسل: ‎b' \t\n\r\x0b\f'‎، والموضح في الجدول التالي: قيمة البايت الوصف b' '‎ مسافة (space). ‎b'\t'‎ علامة جدولة (tab). ...

التابع bytes.isspace()‎ في بايثون

يتحقق هذا التابع ممّا إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، ومن أنّ التسلسل ليس فارغًا. البنية العامة bytes.isspace() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، وإذا كان التسلسل غير فارغٍ. بايتات المسافة البيضاء في ترميز ASCII هي البايتات التي تقع ضمن التسلسل: ‎b' \t\n\r\x0b\f'‎، والموضح في الجدول التالي: قيمة البايت الوصف b' '‎ مسافة (space). ‎b'\t'‎ علامة جدولة (tab). ...

الصنف pickle.Unpickler()‎ في بايثون

يستخدم هذا الصنف ملفًّا ثنائيًا يقرأ منه تدفق البيانات المسلسلة. يجري الكشف عن رقم البروتوكول المستخدم تلقائيًا؛ لذا لا حاجة لأي معامل لتحديده. البنية العامة class pickle.Unpickler(file, *, fix_imports=True, encoding="ASCII", errors="strict") ‎المعاملات file يجب أن يمتلك المعامل file تابعين، الأول هو تابع read()‎ والذي يأخذ معاملًا عدديًا، وتابع readline()‎ والذي لا يحتاج إلى أيّ معاملات. يجب أن يعيد كلا المعاملين كائنات bytes، ولهذا يمكن أن يكون file كائن ملف مخزّنًا على القرص الصلب ومفتوحًا للقراءة الثنائية، أو كائن io.BytesIO أو ...

التابع bytes.endswith()‎ في بايثون

يتحقق التابع من وجود تسلسل فرعي في نهاية البيانات الثنائية الأصلية. البنية العامة bytes.endswith(suffix[, start[, end]]) المعاملات suffix التسلسل الذي يختبر التابع وجوده في نهاية البيانات الثنائية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن البيانات الثنائية. القيمة المعادة يعيد التابع endswith()‎ القيمة True إن كانت البيانات الثنائية تنتهي بالقيمة الممرّرة إلى المعامل suffix، ويعيد القيمة False فيما عدا ذلك، ويمكن للمعامل suffix أن يكون أي كائن شبيه ...

التابع bytes.endswith()‎ في بايثون

يتحقق التابع من وجود تسلسل فرعي في نهاية البيانات الثنائية الأصلية. البنية العامة bytes.endswith(suffix[, start[, end]]) المعاملات suffix التسلسل الذي يختبر التابع وجوده في نهاية البيانات الثنائية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن البيانات الثنائية. القيمة المعادة يعيد التابع endswith()‎ القيمة True إن كانت البيانات الثنائية تنتهي بالقيمة الممرّرة إلى المعامل suffix، ويعيد القيمة False فيما عدا ذلك، ويمكن للمعامل suffix أن يكون أي كائن شبيه ...

الدالة wsgiref.handlers.read_environ في بايثون

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

الدالة zlib.compress()‎ في بايثون

تضغط الدالة البايتات المعطاة، وتعيد كائن 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)‎ وتقدّم هذه القيمة حالة من التوازن ...

التابع bytes.rpartition()‎ في بايثون

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

التابع bytes.replace()‎ في بايثون

يبدّل هذا التابع العبارة التي يختارها المستخدم - مهما تكرّرت في تسلسل البيانات الثنائية - إلى القيمة الجديدة التي يحدّدها. البنية العامة str.replace(old, new[, count]) المعاملات old كائن شبيه بالبايتات يمثّل التسلسل الفرعي الفرعية المراد استبداله. new كائن شبيه بالبايتات يمثّل التسلسل الفرعي الذي سيحلّ محلّ التسلسل القديم. count معامل اختياري، وفي حال تمريره تجري الدالة عمليات استبدال بالعدد المحدّد في هذا المعامل فقط. القيمة المعادة يعيد التابع نسخة من التسلسل الأصلي بعد استبدال التسلسل الفرعي الذي يحدّده المستخدم - ...

التابع bytes.rpartition()‎ في بايثون

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

التابع bytes.replace()‎ في بايثون

يبدّل هذا التابع العبارة التي يختارها المستخدم - مهما تكرّرت في تسلسل البيانات الثنائية - إلى القيمة الجديدة التي يحدّدها. البنية العامة str.replace(old, new[, count]) المعاملات old كائن شبيه بالبايتات يمثّل التسلسل الفرعي الفرعية المراد استبداله. new كائن شبيه بالبايتات يمثّل التسلسل الفرعي الذي سيحلّ محلّ التسلسل القديم. count معامل اختياري، وفي حال تمريره تجري الدالة عمليات استبدال بالعدد المحدّد في هذا المعامل فقط. القيمة المعادة يعيد التابع نسخة من التسلسل الأصلي بعد استبدال التسلسل الفرعي الذي يحدّده المستخدم - ...

الدالة urllib.parse.urlencode()‎‎ في بايثون

تحوّل الدالة كائن ربط 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، فيجب أن ...

التابع bytes.join()‎ في بايثون

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). البنية العامة str.join(iterable) المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والمجموعات. القيمة المعادة يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية. أمثلة يبين المثال التالي القيم المعادة من تطبيق ...

التابع bytes.join()‎ في بايثون

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). البنية العامة str.join(iterable) المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والمجموعات. القيمة المعادة يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية. أمثلة يبين المثال التالي القيم المعادة من تطبيق ...

الدالة zlib.decompress()‎ في بايثون

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

الوحدة gzip في بايثون

تقدّم هذه الوحدة واجهة بسيطة لضغط الملفات وفك ضغطها بنفس الأسلوب المتّبع في برنامجي gzip و gunzip في GNU. وتجري عملية ضغط البيانات بواسطة وحدة zlib. تقدّم وحدة gzip الصنف GzipFile إضافة إلى الدوال open()‎ و compress()‎ و decompress()‎. يدعم برنامجا gzip و gunzip صيغ ملفات أخرى مثل تلك التي تنتج من compress و pack، ولكن يجدر التنبيه إلى أنّ هذه الصيغة غير مدعومة من قبل هذه الوحدة. تعرّف الوحدة العناصر التالية: الدالة gzip.open()‎ تفتح الدالة ملفًّا مضغوطًا بواسطة gzip ...

التابع bytes.rfind()‎ في بايثون

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

التابع bytes.rfind()‎ في بايثون

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

التابع LZMACompressor.flush()‎ في بايثون

ينهي التابع عملية الضغط، ويعيد كائن bytes يتضمّن البيانات المخزّنة في الذواكر الداخلية. البنية العامة flush() لا يمكن ضغط البيانات بعد استدعاء هذا التابع. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

الدالة bytes.find()‎ في بايثون

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

الدالة bytes.find()‎ في بايثون

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

التابع bytes.rindex()‎ في بايثون

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

التابع bytes.rindex()‎ في بايثون

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

التابع ConfigParser.read()‎‎ في بايثون

يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات المعطاة. البنية العامة read(filenames, encoding=None) المعاملات ‎filenames سلسلة نصية أو كائن bytes أو كائن شبيه بالملفات، ويعامل كاسم ملف واحد. إن لم يتمكن التابع من فتح الملف المحدد في المعامل filenames فإن التابع سيتجاهل ذلك الملف. صُمّم هذا التابع بطريقة تتيح للمسختدم تحديد مكرّر يتضمن المواقع المحتملة لملفات الإعدادات (مثل: المجلد الحالي، المجلد الرئيسي للمستخدم، وبعض مجلدات النظام) وسيقرأ التابع كل ملفات الإعدادات التي يعثر عليها في هذه المواقع. ملاحظات: أضيف ...

التابع ZipFile.setpassword()‎‎ في بايثون

يعيّن التابع كلمة المرور المعطاة ككلمة مرور الافتراضية لاستخراج الملفات المعمّاة من الأرشيف. البنية العامة ZipFile.setpassword(pwd) ‎المعاملات ‎pwd كائن bytes يحتوي كلمة المرور. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.setpassword(b'1234') None مصادر صفحة Work with ZIP archives في توثيق بايثون الرسمي.

Python/Examples

هذه الصفحة هي تجميع منظم ومرتب لأمثلة بلغة بايثون الاستثناءات تحتوي هذه الفقرة على أمثلة يصدر فيها استثناءات. الاستثناء FileNotFoundError تُصدره بعض التوابع القارئة للملفات عند عدم وجود الملف >>> f=open('D:\\file.txt') Traceback (most recent call last): File "<pyshell#123>", line 1, in <module> f=open('D:\\file.txt') FileNotFoundError: [Errno 2] No such file or directory: 'D:\\file.txt' الاستثناء KeyError  يصدر عند محاولة الوصول إلى عنصر عن طريق مفتاح غير موجود في القاموس >>> a=dict() >>> a["test"]="good" >>> print(a["no key"]) Traceback ...

Python/pathlib/PurePath

 الصنف pathlib.PurePath في بايثون يحوي هذا الصنف التوابع والعمليات الأساسية للتعامل مع المسارات، إلا أنها لا تحوي أي وصول حقيقي إلى نظام الملفات، ومن ثمّ فليس فيها أي عملية إدخال أو إخراج بل تقتصر على العمليات النصية على المسارات، ويمكننا تلخيص عملها بأنها توابع لمعالجة السلاسل النصية التي تمثل مسارات الملفات. يمكن للمسارات النقية أن تكون مفيدةٌ في بعض الحالات الخاصة المماثلة لما يلي: لمعالجة مسارات نظام ويندوز أثناء العمل على جهاز يعمل بنظام يونكس (والعكس بالعكس)، حيث لا يمكنك ...

التابع bytes.maketrans()‎ في بايثون

يعيد هذا التابع الساكن جدول تحويل (translation table) يمكن استخدامه بواسطة التابع bytes.translate()‎. البنية العامة str.maketrans(x[, y[, z]]) المعاملات from كائن شبيه بالبايتات (bytes-like object) يتضمّن الحروف التي ستربطها الدالة بحروف المعامل to. to كائن شبيه بالبايتات يتضمن الحروف التي ستربط بها الدالة حروف المعامل from. ملاحظة: يجب أن يمتلك المعاملان الطول نفسه، ويجب أن يكون المعاملان كائنين شبيهين بالبايتات. ملاحظة: هذه الدالة موجودة في الإصدار 3.1 وما بعده من بايثون. القيمة المعادة يعيد التابع جدول تحويل يمكن استخدامه بواسطة ...

التابع bytes.translate()‎ في بايثون

يعيد التابع تسلسل البيانات الثنائية بعد إجراء عمليات الربط والحذف بالاعتماد على جدول التحويل. البنية العامة bytes.translate(table, delete=b'') المعاملات table جدول تحويل يمكن إنشاؤه باستخدام التابع bytes.maketrans()‎، ويجب أن يكون كائن بايتات بطول 256. يمكن أن يأخذ هذا المعامل القيمة None وحينئذ سيتقصر عمل التابع على حذف القيم المحددة في المعامل delete. delete معامل اختياري يحدد البيانات التي سيحذفها التابع من التسلسل الأصلي. ملاحظة: في الإصدار 3.6 من بايثون أصبح هذا المعامل معاملًا مفتاحيًا. القيمة المعادة يعيد التابع نسخة من ...

التابع bytes.translate()‎ في بايثون

يعيد التابع تسلسل البيانات الثنائية بعد إجراء عمليات الربط والحذف بالاعتماد على جدول التحويل. البنية العامة bytes.translate(table, delete=b'') المعاملات table جدول تحويل يمكن إنشاؤه باستخدام التابع bytes.maketrans()‎، ويجب أن يكون كائن بايتات بطول 256. يمكن أن يأخذ هذا المعامل القيمة None وحينئذ سيتقصر عمل التابع على حذف القيم المحددة في المعامل delete. delete معامل اختياري يحدد البيانات التي سيحذفها التابع من التسلسل الأصلي. ملاحظة: في الإصدار 3.6 من بايثون أصبح هذا المعامل معاملًا مفتاحيًا. القيمة المعادة يعيد التابع نسخة من ...

التابع bytes.maketrans()‎ في بايثون

يعيد هذا التابع الساكن جدول تحويل (translation table) يمكن استخدامه بواسطة التابع bytes.translate()‎. البنية العامة str.maketrans(x[, y[, z]]) المعاملات from كائن شبيه بالبايتات (bytes-like object) يتضمّن الحروف التي ستربطها الدالة بحروف المعامل to. to كائن شبيه بالبايتات يتضمن الحروف التي ستربط بها الدالة حروف المعامل from. ملاحظة: يجب أن يمتلك المعاملان الطول نفسه، ويجب أن يكون المعاملان كائنين شبيهين بالبايتات. ملاحظة: هذه الدالة موجودة في الإصدار 3.1 وما بعده من بايثون. القيمة المعادة يعيد التابع جدول تحويل يمكن استخدامه بواسطة ...

الدالة bytes.startswith()‎ في بايثون

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

الدالة bytes.startswith()‎ في بايثون

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

الدالة ()os.fspath في بايثون

تُعيد الدالة تمثيل نظام الملفات من المسار المُمرَّر. البنية العامة fspath(path) سجل التغييرات الإصدار التغييرات 3.6 أُضيفت الدالة في هذا الإصدار. المعاملات path المسار المُراد الحصول على تمثيله بنظام الملفات. القيمة المعادة ستُعيد الدالة قيمة غير مُغيَّرة من الأصل إن مُرِّرَ لها سلسلة نصيّة أو سلسلة بايتات تُمثِّل تمثيل المسار المُمرَّر بنظام الملفات. سيُستدعى التابِع ()__fspath__ إن مُرِّرَ للدالة مُعطىً من نوع آخر، وسيُعيد التابِع قيمته فقط إن كان كائِنه سلسلةً نصيّة أو سلسلة بايتات. ستُصدِر الدالة الاستثناء TypeError إن ...

مصفوفات البايتات في بايثون

مصفوفات البايتات bytearray هي الكائنات القابلة للتغيير والتي تقابل كائنات البايتات bytes. يُعيد الصّنف bytearray()‎ (والذي يُعامَل مُعاملة الدّالة) مصفوفة بايتات جديدة، ويكون الصّنف تسلسُلًا قابلًا للتّغيير يحتوي على الأعداد الصّحيحة ضمن المدى ‎0 <= x < 256. ويملك مُعظم التّوابع التي تملكها التّسلسلات الأخرى (كالقوائم والصّفوف مثلًا)، والمشروحة في صفحة أنواع التسلسلات القابلة للتّغيير، إضافةً إلى امتلاك مُعظم التّوابع التي يملكها النّوع bytes. البنية العامة bytearray([source[, encoding[, errors]]]) المعاملات source مُعامل اختياريّ يُستعمل لتهيئة المصفوفة عبر عدّة طُرق مختلفة: ...

الدالة zlib.compressobj()‎ في بايثون

تعيد الدالة كائن ضغط يمكن استخدامه لضغط البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة. البنية العامة zlib.compressobj(level=-1, method=DEFLATED, wbits=MAX_WBITS, memLevel=DEF_MEM_LEVEL, strategy=Z_DEFAULT_STRATEGY[, zdict]) ‎المعاملات level المعامل level هو عدد صحيح ضمن النطاق 0 إلى 9 أو ‎-1 ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة 1 تقابل المستوى(Z_BEST_SPEED) وهو الأسرع ويعطي أقل مقدار من الضغط، والقيمة 9تقابل المستوى(Z_BEST_COMPRESSION) وهو الأبطأ وينتج أكبر مقدار من الضغط. أما القيمة 0 فتقابل المستوى (Z_NO_COMPRESSION) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل ...

التابع bytes.partition()‎ في بايثون

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

التابع bytes.partition()‎ في بايثون

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

كائنات Connection‎ في بايثون

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

كائنات Connection‎ في بايثون

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

التابع bytes.center()‎ في بايثون

يعيد التابع center()‎ البيانات الثنائية مزاحة نحو الوسط ضمن تسلسل يحمل طولًا يحدّده المستخدم. البنية العامة bytes.center(width[, fillbyte]) المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillbytes يحدّد هذا المعامل البايتات التي سيستخدمها التابع لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII.  القيمة المعادة يعيد التابع التسلسل الأصلي مزاحًا نحو الوسط ضمن تسلسل ذي عرض محدّد، وتزاح البيانات الثنائية باستخدام البايتات التي يحدّدها المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

التابع bytes.rsplit()‎ في بايثون

يقسم التابع التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل. البنية العامة bytes.rsplit(sep=None, maxsplit=-1) المعاملات sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم التسلسل الثنائي. إن لم يحمل هذا المعامل قيمة أو كان يحمل القيمة None فإنّ الفاصل يكون مسافة بيضاء. maxsplit يحدد هذا المعامل الحد الأقصى لعمليات التقسيم التي سيجريها التابع من الجهة اليمنى في التسلسل الثنائي. القيمة المعادة يعيد التابع قائمة من التسلسلات الثنائية الفرعية الناتجة من تقسيم التسلسل الثنائي ...

التابع bytes.center()‎ في بايثون

يعيد التابع center()‎ البيانات الثنائية مزاحة نحو الوسط ضمن تسلسل يحمل طولًا يحدّده المستخدم. البنية العامة bytes.center(width[, fillbyte]) المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillbytes يحدّد هذا المعامل البايتات التي سيستخدمها التابع لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII.  القيمة المعادة يعيد التابع التسلسل الأصلي مزاحًا نحو الوسط ضمن تسلسل ذي عرض محدّد، وتزاح البيانات الثنائية باستخدام البايتات التي يحدّدها المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

التابع bytes.rsplit()‎ في بايثون

يقسم التابع التسلسل الثنائي إلى تسلسلات فرعية من النوع ذاته بالاعتماد على تسلسل ثنائي يحدّد الفاصل. البنية العامة bytes.rsplit(sep=None, maxsplit=-1) المعاملات sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم التسلسل الثنائي. إن لم يحمل هذا المعامل قيمة أو كان يحمل القيمة None فإنّ الفاصل يكون مسافة بيضاء. maxsplit يحدد هذا المعامل الحد الأقصى لعمليات التقسيم التي سيجريها التابع من الجهة اليمنى في التسلسل الثنائي. القيمة المعادة يعيد التابع قائمة من التسلسلات الثنائية الفرعية الناتجة من تقسيم التسلسل الثنائي ...

الدالة marshal.dump()‎ في بايثون

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

الوحدة os في بايثون

توفر هذه الوحدة آلية محمولة لاستخدام الوظائف والأدوات التي تعتمد على نوع نظام التشغيل. ‎‎>>> import os >>> os.getcwd() '/home/username' ملاحظات تستخدم وظائِف جميع الوحدات المبنيّة في بايثون، والمعتمدة على نوع نظام التشغيل، في جميع الأنظمة المتوافرة فيها نفس الواجهة (interface). فعلى سبيل المثال، تُعيد الدالة os.stat(path)‎‎ معلومات حول المسار المُدخَل بنفس التنسيق على جميع الأنظمة التي تتوافر فيها الدالة (الواجهة المُستخدمة هنا مماثلة لتلك المُستخدمة في واجهة POSIX). تتوفر أيضًا إمكانيّة إضافة إضافات خاصة لنظام تشغيل مُعين عبر الوحدة os، ولكن ...

الدالة zlib.decompressobj()‎ في بايثون

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

الدالة zlib.decompressobj()‎ في بايثون

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

الدالة compile()‎ في بايثون

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

الدالة sqlite3.register_adapter()‎ في بايثون

تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة البيانات إلى نوع خاص من أنواع بيانات بايثون. البنية العامة sqlite3.register_adapter(type, callable) المعاملات type نوع بيانات بايثون الذي ستحوّله الدالة إلى إحدى الأنواع التي تدعمها قواعد بيانات SQLite. callable كائن قابل للاستدعاء يأخذ معاملًا واحدًا هو نوع بيانات بايثون، ويجب أن يعيد إحدى الأنواع التالية: int أو float أو str أو bytes. انظر أيضًا الدالة register_converter()‎: تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة ...

التابع bytes.index()‎ في بايثون

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

التابع int.from_bytes()‎ في بايثون

يعيد التابع from_bytes()‎ العدد الصحيح الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة. البنية العامة x.from_bytes() المعاملات bytes يجب أن يكون هذا الوسيط كائنًا شبيهًا بالبايتات أو كائنًا يمكن المرور على عناصره (iterable) وينتج البايتات. bytesorder يحدد هذا الوسيط ترتيب البايتات المستخدمة لتمثيل العدد الصحيح. يأخذ هذا المعامل القيمة "big" ويصبح البايت الأكثر أهمّية في بداية مصفوفة البايتات، ويأخذ القيمة "little" فيصبح البايت الأكثر أهمّية في نهاية مصفوفة البايتات. وللحصول على الترتيب المعتمد في النظام المضيف يمكن استخدام sys.byteorder كقيمة لهذا ...

التابع bytes.index()‎ في بايثون

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

التابع BZ2Decompressor.decompress()‎ في بايثون

يفكّ التابع الضغط عن البيانات المعطاة (كائن شبيه بالبايتات bytes-like) ويعيد البيانات الناتجة عن عملية فك الضغط على هيئة بايتات. البنية العامة decompress(data, max_length=-1) ‎المعاملات data البيانات المراد فك ضغطها. max_length ن كانت قيمة المعامل max_length عددًا لا يحمل الإشارة السالبة فإنّ التابع سيعيد على الأكثر العدد المحدّد في هذا المعامل من البايتات من البيانات التي جرى فك الضغط عنها. إن وصل التابع إلى القيمة المحدّدة في هذا المعامل وكان هناك المزيد من المخرجات التي يمكن إنتاجها، تُسند القيمة False ...

التابع LZMADecompressor.decompress()‎ في بايثون

يفكّ التابع الضغط عن البيانات المعطاة (كائن شبيه بالبايتات bytes-like object) ويعيد البيانات غير المضغوطة على هيئة بايتات. البنية العامة decompress(data, max_length=-1) ‎المعاملات data البيانات المراد فك ضغطها. max_length ن كانت قيمة المعامل max_length عددًا لا يحمل الإشارة السالبة فإنّ التابع سيعيد على الأكثر العدد المحدّد في هذا المعامل من البايتات من البيانات التي جرى فك الضغط عنها. إن وصل التابع إلى القيمة المحدّدة في هذا المعامل وكان هناك المزيد من المخرجات التي يمكن إنتاجها، تُسند القيمة False إلى الخاصية ...

الدالة cgi.parse_multipart()‎‎ في بايثون

تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). البنية العامة cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace") المعاملات fp الملف المُدخل. pdict قاموس يحتوي على المعاملات في ترويسة Content-Type. encoding ترميز الطلب. ملاحظة: أضيف المعاملان encoding و errors في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes. القيمة المعادة تعيد الدالة قاموسًا مشابهًا للقاموس الذي تعيده الدالة urllib.parse.parse_qs()‎. مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس ...

التابع Connection.create_aggregate()‎ في بايثون

ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم. البنية العامة create_aggregate(name, num_params, aggregate_class) المعاملات name اسم دالة التجميع المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). aggregate_class صنف تجميع يجب أن يتضمّن تابع step، والذي يأخذ المعامل num_params والذي يحدّد عدد المعاملات في الدالة التي ينشئها التابع (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات)، وتابع finalize والذي سيعيد النتيجة النهائية من ...

الدالة zlib.adler32()‎ في بايثون

تحسب الدالة مجموع التحقق checksum من نوع Adler-32 للبيانات المعطاة. البنية العامة zlib.adler32(data[, value]) ‎ المعاملات data البيانات المراد حساب مجموع التحقق لها. value إن كان المعامل value موجودًا، فإنّه يستخدم كقيمة بادئة لمجموع التحقق، وفي حال غيابه تكون القيمة الافتراضية هي 1. يؤدي تمرير قيمة إلى المعامل value إلى السماح بإجراء عمليات جمع تحقق مستمرّة على مجموعة من المدخلات المترابطة بعضها ببعض. القيمة المعادة تحسب الدالة مجموع التحقق checksum من نوع Adler-32 للبيانات المعطاة. (مجموع التحقق من نوع Alder-32 ...

الدالة sqlite3.create_function()‎ في بايثون

ينشئ التابع دالة معرفة من قبل المستخدم يمكن استعمالها لاحقًا ضمن جمل SQL. البنية العامة create_function(name, num_params, func) ‎المعاملات name اسم الدالة المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). func كائن قابل للاستدعاء callable في بايثون، والذي سيستدعى كدالة SQL. القيمة المعادة يمكن للدالة أن تعيد أيّة قيمة من القيم المدعومة في SQLite وهي: bytes، str، int، float، None. أمثلة يبين المثال التالي طريقة استخدام الدالة: import ...

الصنف wsgiref.headers.Headers‎‎ في بايثون

تدعم كائنات Headers العمليات الخاصة بالقواميس مثل ‎__getitem__()‎ و get()‎ و ‎__setitem__()‎ و setdefault()‎ و ‎__delitem__()‎ و ‎__contains__()‎. يكون المفتاح في كل هذه العمليات هو اسم الترويسة (ليست حساسة لحالة الأحرف) وتكون القيمة هي أول قيمة مرتبطة باسم الترويسة ذاك. يؤدي تعيين ترويسة إلى حذف أي قيمة موجودة في تلك الترويسة، ثم تضاف القمية الجديدة إلى نهاية قائمة الترويسات. تضاف الترويسات الجديدة إلى نهاية القائمة وبذلك يتم المحافظة على ترتيب الترويسات الموجودة أصلًا. تختلف كائنات Headers عن القواميس في أنّها ...

الدالة gzip.open()‎ في بايثون

تفتح الدالة ملفًّا مضغوطًا بواسطة gzip في النمط الثنائي binary mode أو النصي text mode، وتعيد كائن ملف. البنية العامة gzip.open(filename, mode='rb', compresslevel=9, encoding=None, errors=None, newline=None) المعاملات ‎filename يمكن للمعامل filename أن يكون اسم ملف حقيقي (سلسلة نصية أو كائن bytes) أو كائن ملفٍّ موجودًا بالفعل، يمكن القراءة منه والكتابة فيه. mode يمكن يأخذ المعامل mode إحدى القيم التالية: ‎'r'، 'rb'، 'w'، 'wb'، 'x'، 'xb'، 'a'، 'ab'‎ للنمط الثنائي، والقيم ‎'rt'، 'wt'، 'xt'، 'at'‎ للنمط النصي، والقيمة الافتراضية لهذا المعامل ...

الصنف lzma.LZMAFile في بايثون

تفتح الدالة ملفًّا مضغوطًا بخوارزمية LZMA في الوضع الثنائي. يمكن لكائن LZMAFile أن يغلّف كائن ملف مفتوح فعلًا، أو أن يعمل مباشرة على الملف المعطى. البنية العامة lzma.LZMAFile(filename=None, mode="r", *, format=None, check=-1, preset=None, filters=None) المعاملات ‎filename يحدّد هذا المعامل كائن الملف الذي سيجري تغليفه بكائن LZMAFile أو اسم الملف الذي ستفتحه الدالة (سلسلة نصية أو كائن bytes أو كائن شبيه بالمسار). يجدر التنبيه إلى أنّ إغلاق كائن LZMAFile لن يؤدي إلى إغلاق كائن الملفّ الذي يغلّفه. mode يمكن أن يأخذ ...

الدالة bz2.open()‎ في بايثون

تفتح الدالة ملفًّا مضغوطًا بخوارزمية bzip2 في النمط الثنائي أو النصي، وتعيد كائن ملف، وهي دالة بانية للصنف BZ2File. البنية العامة bz2.open(filename, mode='r', compresslevel=9, encoding=None, errors=None, newline=None) المعاملات ‎filename يمكن لهذا المعامل أن يكون اسم ملف (سلسلة نصية أو كائن bytes)، أو كائن ملفّ تجري القراءة منه والكتابة فيه. mode يمكن يأخذ المعامل mode إحدى القيم التالية: ‎'r'، 'rb'، 'w'، 'wb'، 'x'، 'xb'، 'a'، 'ab'‎ للنمط الثنائي، والقيم ‎'rt'، 'wt'، 'xt'، 'at'‎ للنمط النصي، والقيمة الافتراضية لهذا المعامل هي 'rb'. ...

الصنف bz2.BZ2Decompressor في بايثون

تنشئ هذه الدالة البانية كائن decompressor الذي يمكن استخدامه لفك الضغط عن البيانات تزايديًا. لإجراء عملية فك الضغط دفعة واحدة عليك باستخدام الدالة decompress()‎. ملاحظة: لا يتعامل هذا الصنف بطريقة واضحة مع المدخلات التي تتضمّن مجموعة من تدفّقات البيانات المضغوطة مخالفًا في ذالك الدالة decompress()‎ والصنف BZ2File. إن كنت بحاجة إلى فك الضغط عن مجموعة من التدفّقات المضغوطة باستخدام الصنف BZ2Decompressor فيجب عليك استخدام كائن decompressor جديد مع كل تدفّق للبيانات. البنية العامة bz2.BZ2Decompressor توابع الصنف BZ2Decompressor تقدّم كائنات BZ2Decompressor ...

Python/Topics

بنية اللغة بيان للبنية العامة للغة بايثون وبعض الأمور العامة مثل التعليقات وتسمية المعرّفات وغيرها. مفسر بايثون يستخدم مفسر بايثون لمعالجة الشيفرات المكتوبة بها، وهو يقبل عددًا من الخيارات، ويمكن تشغيله في الوضع التفاعلي. أنواع البيانات القيمة المنطقية (boolean) القيمتان المنطقيتان اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. الأعداد الصحيحة (int) العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن ...

عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).