از ویکی‌پدیا، دانشنامهٔ آزاد
الگوهای کار با رشته |
|---|
زیررشته (انتخاب بخشی از رشته بر پایهٔ موقعیت) |
|---|
| {{زیررشته}} | زیررشته‌ای را بر پایهٔ نمایهٔ آغاز و پایان، با امکان شمارش از هر دو جهت، برمی‌گرداند. | | {{str left}} | N نویسهٔ نخست رشته را نگه می‌دارد، یا رشته را تا رسیدن به N نویسه تکرار می‌کند. | | {{str crop}} | همهٔ رشته به‌جز N نویسهٔ پایانی را برمی‌گرداند. | | {{str index}} | نویسهٔ Nام یک رشته را برمی‌گرداند. |
| | {{str right}} | زیررشته را از نویسهٔ Nام تا پایان رشته برمی‌گرداند. | | {{str rightc}} | N نویسهٔ پایانی رشته را برمی‌گرداند؛ یا اگر خروجی خالی باشد مقدار تعیین‌شده را برمی‌گرداند. | | {{str sub old}} | زیررشته‌ای با طول مشخص را از نویسهٔ Nام برمی‌گرداند. |
|
|
|
پیرایش (انتخاب یا حذف بخش‌هایی از رشته بر پایهٔ نوع نویسه) |
|---|
| {{اصلاح}} | فاصله‌های خالی آغاز و پایان رشته را حذف می‌کند. | | {{str letter/trim}} | رشته را به حروف آغازین آن محدود می‌کند. | | {{str number/trim}} | رشته را به اعداد آغازین آن محدود می‌کند. | | {{trim brackets}} | کروشه‌های آغاز یا پایان رشته را حذف می‌کند. | | {{trim quotes}} | گیومه‌های جفت‌شدهٔ آغاز و پایان رشته را حذف می‌کند. | | {{Trim leading}} | حداکثر شش نمونه از پیشوند تعیین‌شده را از ابتدای رشته حذف می‌کند. |
| |
|
|
انتخاب یا حذف مورد مشخص از رشته |
|---|
| {{پیوندزدایی}}، {{trim brackets}} | کروشه‌های پیوند ویکی‌متن را، به‌طور کامل یا فقط لایهٔ بیرونی، حذف می‌کند. | | {{Plain text}} | کدهای ویکی‌متن، از جمله قالب‌بندی و کروشه‌ها، را حذف می‌کند. | | {{مبنای‌نام‌صفحه}} | متن داخل پرانتز در پایان عنوان، مانند عبارت ابهام‌زدایی، را حذف می‌کند. | | {{Title disambig text}} | متن داخل پرانتز انتهای عنوان را برمی‌گرداند. |
| | {{سال عنوان}} | سال سه یا چهاررقمی موجود در عنوان صفحه را برمی‌گرداند. | | {{دهه عنوان}} | سال آغاز دهه‌ای را که به‌شکل «دهه XXXX» در عنوان آمده است برمی‌گرداند. | | {{عدد عنوان}} | یک عدد موجود در عنوان صفحه را برمی‌گرداند. | | {{WikiProjectbasename}} | عبارت «WikiProject» را از نام صفحه حذف می‌کند. |
|
|
|
درج، جایگزینی و طول |
|---|
| {{Loop}} | یک رشته یا نویسه را به تعداد تعیین‌شده تکرار می‌کند. | | {{Replace}} | همهٔ موارد یک رشتهٔ مشخص را با رشته‌ای دیگر جایگزین می‌کند. | | {{Str rep}} | نخستین مورد یک رشتهٔ مشخص را با رشته‌ای دیگر جایگزین می‌کند. | | {{Digits}} | همهٔ نویسه‌هایی را که رقم لاتین 0 تا 9 نیستند حذف می‌کند. | | {{Nowiki}} | ویکی‌متن را به‌صورت متن ساده نمایش می‌دهد. |
| | {{Str len}} | طول یک رشته را برمی‌گرداند. | | {{Str ≥ len}} | بررسی می‌کند که طول رشته بزرگ‌تر یا مساوی مقدار تعیین‌شده است یا کوتاه‌تر. | | {{Str ≤ len}} | بررسی می‌کند که طول رشته کوچک‌تر یا مساوی مقدار تعیین‌شده است یا بلندتر. | | {{Str ≠ len}} | بررسی می‌کند که طول رشته با مقدار تعیین‌شده نابرابر است یا برابر. |
|
|
|
تحلیل و جست‌وجو |
|---|
| | | {{Array}} | برای بازیابی و دست‌کاری اعضای آرایه به‌کار می‌رود. | | {{A or an}} | برای یک اسم انگلیسی، حرف تعریف نامعین مناسب «a» یا «an» را انتخاب می‌کند. | | {{In string}} | بر پایهٔ وجود یا نبود رشتهٔ موردنظر، خروجی اختیاری برمی‌گرداند. | | {{عددی است}} | اگر مقدار عددی باشد آن را برمی‌گرداند و در غیر این صورت خروجی خالی می‌دهد. | | {{Str letter}} | تعداد حروف آغازین یک رشته را برمی‌گرداند. | | {{Str number}} | تعداد اعداد آغازین یک رشته را برمی‌گرداند. |
|
|
|
|
|
این الگو یک جعبهٔ ناوبری برای الگوها و پودمان‌هایی است که برای پردازش، بررسی و دست‌کاری رشته‌های متنی در ویکی‌متن به‌کار می‌روند.
آن را می‌توان در پایین صفحهٔ توضیحات هر یک از الگوهای فهرست‌شده در این جعبه قرار داد:
این الگو از {{Navbox with collapsible groups}} استفاده می‌کند و دارای پنج بخش اصلی تاشونده است:
| مقدار |
بخش |
|---|
sub |
زیررشته |
trim |
پیرایش |
specific |
انتخاب یا حذف مورد مشخص |
IRL |
درج، جایگزینی و طول |
anlys/tech |
تحلیل و جست‌وجو |
برای نمایش یک بخش خاص و بسته‌ماندن سایر بخش‌ها:
{{الگوهای کار با رشته|sub}}
یا:
{{الگوهای کار با رشته|trim}}
مقادیر فنی بالا برای سازگاری با نسخه‌های قبلی و میان‌ویکی انگلیسی به همان صورت لاتین حفظ شده‌اند.
حالت پیش‌فرض الگو:
است؛ یعنی جعبه به‌صورت باز نمایش داده می‌شود.
برای بسته‌کردن کامل:
{{الگوهای کار با رشته|state=collapsed}}
برای استفاده از حالت خودکار:
{{الگوهای کار با رشته|state=autocollapse}}
در حالت autocollapse اگر جعبهٔ ناوبری یا عنصر تاشوندهٔ دیگری در صفحه وجود داشته باشد، الگو بسته نمایش داده می‌شود.
الگوهای موجود در این جعبه در پنج دستهٔ کلی قرار می‌گیرند:
- زیررشته
- انتخاب یک نویسه یا بخشی از رشته بر پایهٔ موقعیت آن.
- پیرایش
- حذف یا انتخاب بخش‌هایی از ابتدا یا انتهای رشته بر پایهٔ نوع نویسه یا جداکننده.
- انتخاب یا حذف مورد مشخص
- حذف پیوندها و قالب‌بندی یا استخراج سال، دهه، عدد و عبارت‌های مشخص از عنوان.
- درج، جایگزینی و طول
- تکرار، جایگزینی، پاکسازی نویسه‌ها و اندازه‌گیری طول رشته.
- تحلیل و جست‌وجو
- یافتن، شمارش، مقایسه و بررسی محتوای رشته.
بخش پایانی جعبه چند پودمان اصلی را نیز معرفی می‌کند:
برای کدهای جدید، در بسیاری از موارد استفادهٔ مستقیم از توابع پودمان‌ها از زنجیره‌کردن چند الگوی قدیمی ساده‌تر و کارآمدتر است.
برای نمونه:
{{#invoke:String|sub|12345678|2|-3}}
بخشی از رشته را با تعیین نمایهٔ آغاز و پایان استخراج می‌کند.
