٦١
تعديل
ط (1 تعديل من en:Module:String: مطلوب محتاج ترجمه) |
ط (مراجعة واحدة) |
||
سطر ١: | سطر ١: | ||
--[[ | --[[ | ||
الغرض من هذه الوحدة هو توفير الوصول إلى .وظائف السلسلة الأساسية | |||
يمكن استدعاء معظم الوظائف المقدمة هنا باستخدام معلمات مسماة أو معلمات غير مسماة أو خليط. إذا تم استخدام المعلمات المسماة، سيقوم ويكيميديا تلقائيًا بإزالة أي مسافة بيضاء بادئة أو لاحقة من المعلمة. اعتمادًا على الاستخدام المقصود ، قد يكون من المفيد إما الحفاظ على مثل هذه المساحة البيضاء أو إزالتها.. | |||
Global options | Global options | ||
ignore_errors: | ignore_errors: إذا تم تعيينه 'true' أو 1, أي خطأ سيؤدي إلى | ||
إرجاع سلسلة فارغة بدلاً من رسالة خطأ. | |||
error_category: | error_category: في حالة حدوث خطأ، يتم تحديد اسم الفئة بـ | ||
لتضمينه مع رسالة الخطأ. الفئة الافتراضية هي | |||
[Category:Errors reported by Module String]. | [Category:Errors reported by Module String]. | ||
no_category: | no_category: إذا تم تعيينه 'true' أو 1، لن يتم إضافة أي فئة إذا حدث خطأ | ||
تم إنشاؤه. | |||
Unit tests for this module are available at Module:String/tests. | Unit tests for this module are available at Module:String/tests. | ||
سطر ٢٨: | سطر ٢٤: | ||
len | len | ||
تُرجع هذه الدالة طول السلسلة المستهدفة. | |||
Usage: | Usage: | ||
سطر ١٠٧: | سطر ١٠٣: | ||
--[[ | --[[ | ||
match | |||
This function returns a substring from the source string that matches a | This function returns a substring from the source string that matches a | ||
specified pattern. | specified pattern. | ||
Usage: | Usage: | ||
{{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}} | |||
OR | |||
{{#invoke:String|pos|s=source_string|pattern=pattern_string|start=start_index | |||
|match=match_number|plain=plain_flag|nomatch=nomatch_output}} | |||
Parameters | Parameters | ||
سطر ١٢٩: | سطر ١٢٧: | ||
text. Defaults to false. | text. Defaults to false. | ||
nomatch: If no match is found, output the "nomatch" value rather than an error. | nomatch: If no match is found, output the "nomatch" value rather than an error. | ||
If invoked using named parameters, Mediawiki will automatically remove any leading or | |||
trailing whitespace from each string. In some circumstances this is desirable, in | |||
other cases one may want to preserve the whitespace. | |||
If the match_number or start_index are out of range for the string being queried, then | |||
this function generates an error. An error is also generated if no match is found. | |||
If one adds the parameter ignore_errors=true, then the error will be suppressed and | |||
an empty string will be returned on any failure. | |||
For information on constructing Lua patterns, a form of [regular expression], see: | For information on constructing Lua patterns, a form of [regular expression], see: | ||
سطر ١٩٨: | سطر ٢٠٥: | ||
end | end | ||
end | end | ||
-- This is the entry point for #invoke:String|match | -- This is the entry point for #invoke:String|match | ||
function str.match( frame ) | function str.match( frame ) |