نتائج البحث

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

التابع 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.

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

تضغط الدالة البيانات المعطاة (كائن 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) وتعيد البيانات ...

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

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

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

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

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

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

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

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

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

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

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

تستبدل الدالة الحروف المهرّبة بالصيغة ‎%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()‎: ...

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%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(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، ولهذه المكتبة موقع إلكتروني خاص. يجدر التنبيه إلى وجود بعض المشاكل في التوافقية بين وحدة بايثون والإصدارات 1.1.3 وما دونها من مكتبة zlib، إضافة إلى أنّ الإصدار 1.1.3 يعاني من مشاكل أمنية؛ لذا يُنصح باستخدام الإصدار 1.1.4 أو ما بعده من المكتبة. تقدّم دوال zlib الكثير من الخيارات وغالبًا ما يجب استخدام هذه الدوال في ترتيب معين. لا ...

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد 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, ...

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد 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, ...

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

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

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

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

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

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

تضغط الدالة البيانات المعطاة وتعيد كائن 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 ...

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

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

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن 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 يحتوي على المخرجات المضغوطة المتبقية. البنية العامة 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()‎ مرة أخرى ...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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