نتائج البحث

تقّدم الوحدة re مجموعة من العمليات الخاصة بمطابقة التعابير النمطية (Regular Expressions) وهي مشابهة إلى حدّ كبير للعمليات الموجودة في لغة Perl. يمكن أن تكون الأنماط والسلاسل النصية المراد العثور عليها سلاسل نصية بترميز Unicode من نوع (str) أو سلاسل نصية ذات 8 بتات من نوع (bytes)، ولكن لا يجوز المزج بين النوعين، بمعنى أنّه لا يمكن مطابقة سلسلة نصية مع نمط من نوع البايتات والعكس صحيح أيضًا، وبنفس الطريقة، عند الرغبة في إجراء عملية استبدال يجب أن تكون سلسلة ...

تُقدم هذه الوحدة دعمًا لwildcards المماثلة لنمط صدفة يونكس، وهي ليست نفسها التعابير النظامية Regular Expression (المذكورة في الوحدة re)، فالرموز الخاصة التي تستخدمها الwildcards من نمطصدفة يونكس هي التالية: النمط المعنى * يطابق كل شيء ? يطابق أي محرف مفرد [seq] يطابق أي محرف من المحارف المذكورة بين القوسين [seq!] يطابق أي محرف من المحارف المذكورة غير بين القوسين وفي حال الرغبة في مطابقة المحرف '?' حرفيًّا (وليس مدلوله الخاص) عندها يمكن وضعه بين قوسين مربعين [?].

ينشأ كائن التعبير النمطي regex من تصريف التعبير النمطي بواسطة الدالة re.compile()‎، ويقدّم هذا الكائن مجموعة من الخصائص والتوابع التي يمكن من خلالها إجراء العديد من العمليات على التعابير النمطية المصرّفة. خصائص الكائن regex يقدّم الكائن regex الخصائص التالية: regex.flags رايات التطابق الخاص بالكائن regex، وتمثّل مجموعة الرايات التي تمرّر إلى الدالة re.compile()‎، إضافة إلى الرايات السطرية (‎?...‎) في التعابير النمطية، والرايات الضمنية مثل UNICODE إن كان التعبير النمطي سلسلة نصية بترميز Unicode. regex.groups عدد مجموعات الالتقاط في التعبير النمطي. ...

تدعم بايثون شأنها في ذلك شأن بقية اللغات البرمجية جميع العمليات الحسابية المعروفة، وتدعم جميع الأنواع العددية (باستثناء الأعداد المركبة) العمليات الحسابية التالية، وهي مرتبة في هذا الجدول ترتيبًا تصاعديًّا بحسب الأولوية (تمتلك جميع العمليات الحسابية أولوية أعلى من عمليات المقارنة): العملية النتيجة الملاحظات x + y إضافة x إلى y x - y طرح y من x x * y ضرب x في y x / y قسمة x على y x // y الحاصل التقريبي لقسمة x على ...

تدعم بايثون شأنها في ذلك شأن بقية اللغات البرمجية جميع العمليات الحسابية المعروفة، وتدعم جميع الأنواع العددية (باستثناء الأعداد المركبة) العمليات الحسابية التالية، وهي مرتبة في هذا الجدول ترتيبًا تصاعديًّا بحسب الأولوية (تمتلك جميع العمليات الحسابية أولوية أعلى من عمليات المقارنة): العملية النتيجة الملاحظات x + y إضافة x إلى y x - y طرح y من x x * y ضرب x في y x / y قسمة x على y x // y الحاصل التقريبي لقسمة x على ...

ينشأ الكائن match كنتيجة لتطبيق التابعين regex.match()‎ و regex.search()‎ على التعبير النمطي المصرّف. تمتلك كائنات match القيمة المنطقية True دائمًا، ولما كان التابعان match()‎ و search()‎ يعيدان القيمة None عندما لا يكون هناك حالات تطابق، يمكن التحقق من وجود التطابق باستخدام عبارة if بسيطة: match = re.search(pattern, string) if match: process(match) تدعم كائنات match التوابع والخصائص التالية: خصائص الكائن match match.pos قيمة المعامل pos الممرّر إلى التابعين regex.search()‎ و regex.match()‎. تمثّل هذه الخاصية الموقع الذي تبدأ فيه عملية البحث ...

يعيد التابع صفًّا يتكون من عنصرين هما (القيمة المعادة من m.end(group)‎, القيمة المعادة منm.start(group)‎). البنية العامة match.span([group]) المعاملات group المجموعة المراد معرفة موقعها. يأخذ المعامل group القيمة الافتراضية صفر في حالة التطابق الكاملة. القيمة المعادة يعيد التابع صفًّا يتكون من عنصرين هما (‎ m.start(group)‎, m.end(group)‎‎). إن لم تشارك المجموعة الممرّرة في حالة التطابق، فإنّ التابع يعيد الصفّ (‎-1, -1). أمثلة يبين المثال التالي النتائج المعادة من هذا التابع: >>> import re >>> p = re.compile('(ab)*') >>> match = p.match('ababababab') >>> match.start() 0 >>> match.end() 10 >>> match.span() (0, ...

يجري هذا التابع عملية استبدال التسلسلات المسبوقة بالخط المائل العكسي بالاعتماد على قالب متمثّلٍ بسلسلة نصية. البنية العامة match.expand(template) المعاملات template سلسلة نصية تتضمّن تسلسلات مسبوقة بالخط المائل العكسي تمثّل القالب الذي سيستخدمه التابع لإجراء عمليات الاستبدال. القيمة المعادة يعيد التابع السلسلة النصية الناتجة عن إجراء عمليات عملية استبدال التسلسلات المسبوقة بالخط المائل العكسي بالاعتماد على قالب متمثّلٍ بسلسلة نصية، وبنفس طريقة عمل التابع regex.sub()‎. إذ تُحوّل تسلسلات التهريب مثل ‎\n إلى المحارف المقابلة، وتحوّل الإشارات الخلفية الرقمية مثل (‎\2، ...

تتيح عوامل الأعداد الثنائية تقدير ومعالجة بتات (bits) معينة ضمن العدد الصحيح. مثال الاسم النتيجة ‎$a & $b And و يُعيد 1 مكان كل بت له القيمة 1 في كلٍّ من ‎$a و ‎$b. ‎$a | $b Or أو (الضمنية) يُعيد 1 مكان كل بت له القيمة 1 في ‎$a أو ‎$b أو كلاهما. ‎$a ^ $b Xor أو (غير الضمنية) يُعيد 1 مكان كل بت له القيمة 1  في ‎$a أو ‎$b وليس كلاهما. ‎~ $a Not النفي يعكس ...

تتيح عوامل الأعداد الثنائية تقدير ومعالجة بتات (bits) معينة ضمن العدد الصحيح. مثال الاسم النتيجة ‎$a & $b And و يُعيد 1 مكان كل بت له القيمة 1 في كلٍّ من ‎$a و ‎$b. ‎$a | $b Or أو (الضمنية) يُعيد 1 مكان كل بت له القيمة 1 في ‎$a أو ‎$b أو كلاهما. ‎$a ^ $b Xor أو (غير الضمنية) يُعيد 1 مكان كل بت له القيمة 1  في ‎$a أو ‎$b وليس كلاهما. ‎~ $a Not النفي يعكس ...

يحوّل التابع‎ أوائل الكلمات في التسلسل الثنائي إلى أحرف كبيرة Title Case بترميز ASCII. البنية العامة bytes.title() القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي تكون فيها أوائل الكلمات ذات أحرف كبيرة بترميز ASCII. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. أمثلة يوضح المثال التالي النتيجة المعادة من تطبيق التابع على سلسلة نصية: >>> 'Hello world'.title() 'Hello World' توضيح يستخدم التابع ...

يحوّل التابع‎ أوائل الكلمات في التسلسل الثنائي إلى أحرف كبيرة Title Case بترميز ASCII. البنية العامة bytes.title() القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي تكون فيها أوائل الكلمات ذات أحرف كبيرة بترميز ASCII. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. أمثلة يوضح المثال التالي النتيجة المعادة من تطبيق التابع على سلسلة نصية: >>> 'Hello world'.title() 'Hello World' توضيح يستخدم التابع ...

يعيد التابع مجموعة فرعية واحدة أو أكثر من المجموعات الموجودة في كائن التطابق. البنية العامة match.group([group1, ...]) المعاملات group1 يأخذ هذا التابع معاملًا واحدًا أو أكثر، وهو عبارة عن عدد صحيح يمثّل رقم المجموعة المراد معرفة قيمتها. القيمة المعادة يعيد التابع مجموعة فرعية واحدة أو أكثر من مجموعات التطابق. إن أخذ التابع معاملًا واحدًا، فإنّ النتيجة تكون سلسلة نصية مفردة، وإن كان هناك عدد من المعاملات، فإنّ النتيجة تكون صفًّا يحتوي على عناصر بعدد المعاملات الممررة. أما إن لم يُمرّر ...

تطلق اللغة هذا الاستثناء عند تمرير سلسلة نصية غير صالحة كتعبير نمطي إلى إحدى الدوال السابقة (كأن تتضمن السلسلة أقواسًا غير متطابقة)، أو عند حدوث أخطاء أخرى أثناء عملية التصريف أو المطابقة. لا يعد خلوّ السلسلة النصية من التطابقات خطأً على الإطلاق. البنية العامة re.error(msg, pattern=None, pos=None) الخاصيات تمتلك نسخة الخطأ الخصائص الإضافية التالية: msg رسالة الخطأ غير المنسّقة. pattern التعبير النمطي. pos موقع حدوث الخطأ في تصريف التعبير النمطي (قد يأخذ القيمة None). lineno السطر الحاوي على قيمة الخاصية ...

تفرغ هذه الدالة الذاكرة المخبئية cache الخاصة بالتعبير النظامي. البنية العامة re.purge() القيمة المعادة لا تعيد هذه الدالة أي قيمة. يمكن الوصول إلى الذاكرة المخبئية الخاصّة بالتعابير النظامية عن طريق المتغيّر الخاص ‎_cache وهو عبارة عن قاموس يجمع التعابير النمطية المستخدمة سابقًا. أمثلة يبين المثال التالي طريقة استخدام هذه الدالة: >>> p = re.compile(r'(?P<word>\b\w+\b)', re.IGNORECASE) >>> re._cache {(<class 'str'>, '[ ]*', 0): (re.compile('[ ]*'), None), (<class 'str'>, '^(\\s* def\\s)|(\\s*async\\s+def\\s)|(.*(?<!\\w)lambda(:|\\s))|^(\\s*@)', 0): (re.compi le('^(\\s*def\\s)|(\\s*async\\s+def\\s)|(.*(?<!\\w)lambda(:|\\s))|^(\\s*@)'), No ne), (<class 'str'>, '[ \\f\\t]*((\\\\\\r?\\n|\\Z|#[^\\r\\n]*|((|Br|f|U|r|Fr|F|R |rb|br|Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB|B|BR|u|rf|fr)\'\'\'|(|Br|f|U|r|Fr|F|R|rb|br| Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB|B|BR|u|rf|fr)"""))|(([0-9](?:_?[0-9])*[jJ]|(([0-9]( ?:_?[0-9])*\\.(?:[0-9](?:_?[0-9])*)?|\\.[0-9](?:_?[0-9])*)([eE][-+]?[0-9](?:_?[0 -9])*)?|[0-9](?:_?[0-9])*[eE][-+]?[0-9](?:_?[0-9])*)[jJ])|(([0-9](?:_?[0-9])*\\. (?:[0-9](?:_?[0-9])*)?|\\.[0-9](?:_?[0-9])*)([eE][-+]?[0-9](?:_?[0-9])*)?|[0-9]( ?:_?[0-9])*[eE][-+]?[0-9](?:_?[0-9])*)|(0[xX](?:_?[0-9a-fA-F])+|0[bB](?:_?[01])+ |0[oO](?:_?[0-7])+|(?:0(?:_?0)*|[1-9](?:_?[0-9])*)))|((\\*\\*=?|>>=?|<<=?|!=|//= ?|->|[+\\-*/%&@|^=<>]=?|~)|[][(){}]|(\\r?\\n|\\.\\.\\.|[:;.,@]))|((|Br|f|U|r|Fr| F|R|rb|br|Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB|B|BR|u|rf|fr)\'[^\\n\'\\\\]*(?:\\\\.[^\\n \'\\\\]*)*(\'|\\\\\\r?\\n)|(|Br|f|U|r|Fr|F|R|rb|br|Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB| B|BR|u|rf|fr)"[^\\n"\\\\]*(?:\\\\.[^\\n"\\\\]*)*("|\\\\\\r?\\n))|\\w+)', <RegexF lag.UNICODE: 32>): (re.compile('[ \\f\\t]*((\\\\\\r?\\n|\\Z|#[^\\r\\n]*|((|Br|f| U|r|Fr|F|R|rb|br|Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB|B|BR|u|rf|fr)\'\'\'|(|Br|f|U|r|Fr| F|R|rb|br|Rb|Rf|FR|rB|RF|rF|fR|b|bR|RB|B|BR|u|rf|fr)"""))|(([0-9](?:_?[), None), (<class 'str'>, ...

يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية انطلاقًا من الإصدارات القديمة من كوردوفا. تُطبَّق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل واجهة سطر الأوامر cordova. يمكنك الانتقال إلى توثيق واجهة سطر الأوامر للحصول على معلومات حول كيفية تحديث إصدار واجهة سطر الأوامر. الترقية إلى الإصدار ‎7.X.X أفضل طريقة للترقية إلى الإصدار ‎7.X.X هي إزالة منصة أندرويد من مشروعك، ثم إعادة إضافتها بالإصدار الجديد. مثلًا: cordova platform remove android cordova platform add ...

يُحاول التابع try_convert تحويل الكائن المُمرَّر إليه إلى كائن من النوع Regexp باستخدام التابع to_regexp ثم يعيد التعبير النمطي الناتج، أو القيمة nil في حالة تعذر التحويل لأي سبب. البنية العامة try_convert(obj) → re or nil‎ المعاملات obj‎ الكائن المراد تحويله. القيمة المعادة يعاد كائنٌ من النوع Regexp ناتج عن تحويل الكائن obj. أمثلة مثال على استخدام التابع try_convert‎: Regexp.try_convert(/re/) #=> /re/ Regexp.try_convert("re") #=> nil o = ...

تبدل الدالة حالات التطابق غير المتداخلة في أقصى اليسار -والناتجة عن تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة- بسلسلة نصية أو بالقيمة المعادة من دالة. البنية العامة re.sub(pattern, repl, string, count=0, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. يمكن للنمط أن يكون سلسلة نصية أو كائن نمط pattern object. repl يمكن للبديل repl أن يكون سلسلة نصية أو دالة، وإن كان سلسلة نصية، فإنّ الدالة تعالج جميع المحارف المهرّبة فيها. بمعنى أنّ ‎\n تحوّل إلى محرف سطر ...

الدالة RegExp.prototype.[@@search]()‎ تبحث عن تعبيرٍ نمطيٍ (regular expression) في سلسلةٍ نصية. البنية العامة regexp[Symbol.search](str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة فهرس أوّل مطابقة للتعبير النمطي في السلسلة النصية، أو القيمة -1 إن لم تكن هنالك مطابقة. الوصف تُستدعى هذه الدالة داخليًا في الدالة String.prototype.search()‎. فمثلًا، كلا المثالين الآتيين يُعيد النتيجة نفسها: 'abc'.search(/a/); /a/[Symbol.search]('abc'); الغرض من وجود هذه الدالة هو السماح بإمكانية تخصيصها في الأصناف الفرعية المشتقة من RegExp. أمثلة استدعاء مباشر ستُستخدَم هذه الدالة بنفس طريقة ...

الدالة RegExp.prototype.[@@match]()‎ تُعيد ما يُطابِقه تعبيرٌ نمطيٌ (regular expression) في سلسلة نصية. البنية العامة regexp[Symbol.match](str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة إذا كانت هنالك مُطابَقة بين التعبير النمطي والسلسلة النصية، فستُعاد مصفوفة Array تحتوي على كامل السلسلة النصية المُطابَقة كأوّل عنصر فيها، ويليها أيّة نتائج تمت مُطابَقتها في التعابير النمطية الفرعية الموجودة بين قوسين. وإذا لم تُطابَق أيّة نتائج فستُعاد القيمة null. الوصف تُستدعى هذه الدالة داخليًا في الدالة String.prototype.match()‎. فمثلًا، كلا المثالين الآتيين له يُعيد النتيجة ...