الگو:یافتن کشور
 | این الگو از لوآ استفاده می‌کند: |
این الگو نام یک کشور یا قاره را از یک رشته استخراج می‌کند (آفریقا، هند، بریتانیا و غیره). اگر مورد منطبقی یافت نشود، هیچ‌چیزی برگردانده نخواهد شد.
فهرست کشورها در کدهای پودمان:Find country آمده است - عملکرد کدهای پودمان به ترتیب و از بالا به پایین آن فهرست انجام می‌شود. «بلندترین» حالت نام کشور در ابتدا می‌آید، بنابراین، «جمهوری دموکراتیک خلق کره» پیش از «کره شمالی» آمده و هر دو مطنبق خواهند بود.
برخی گزینه‌ها برای تنظیم رفتار این الگو در دسترس هستند.
استفاده
[ویرایش]کاربرد ابتدایی
[ویرایش]{{یافتن کشور|فلان}}
این روش کاربرد الگو نخستین مورد انطباق با نام یک کشور یا قاره در رشتهٔ «فلان» را برمی‌گرداند.
اگر مورد منطبقی یافت نشود، رشتهٔ خالی برگردانده خواهد شد. این کار، امکان کاربرد سادهٔ الگو در سایر الگوها را فراهم می‌کند.
{{#اگر: {{یافتن کشور}}|<!-- اگر مورد منطبقی نبود، کاری نکن -->|این رشته حاوی نام هیچ کشوری نیست}}
پارامترها اختیاری
[ویرایش]یکی از پارامترها الزامی، و دو پارامتر دیگر اختیاری هستند:
|رشته=مقدار
- این پارامتر الگو را مجبور می‌کند که از عنوانی متفاوت از عنوان صفحهٔ کنونی استفاده کند.
|نامنطبق=مقدار
- این پارامتر برای تعیین پیامی کاربرد دارد که در صورت یافت نشدن مورد منطبق نمایش خواهد یافت. برای مثال:
- خروجی پیش‌فرض
{{یافتن کشور|روباه قهوه‌ای‌رنگ چابک از روی سگ تنبل پرید}}← - به‌همراه پارامتر نامنطبق
{{یافتن کشور|روباه قهوه‌ای‌رنگ چابک از روی سگ تنبل پرید|نامنطبق=فاقد کشور!}}← فاقد کشور!
- خروجی پیش‌فرض
|منطبق=عدد
- اگر نام چندین کشور یافت شود، این پارامتر برای تعیین مورد منطبقی که باید برگردانده شود کاربرد دارد. برای مثال، اولین مورد منطبق با
|منطبق=1برگردانده می‌شود. اگر عدد وارد شده منفی باشد، شمارش برای برگرداندن مورد منطبق از انتهای فهرست موارد انجام می‌شود. به این معنی که|منطبق=-1آخرین مورد منطبق یافت‌شده را برمی‌گرداند. پیش‌فرض این پارامتر 1 است. - نمونه‌ها:
{{یافتن کشور|رویدادها در بنگلادش، هند و پاکستان (و احتمالاً سریلانکا) |منطبق=2}}← هند{{یافتن کشور|رویدادها در بنگلادش، هند و پاکستان (و احتمالاً سریلانکا) |منطبق=-2}}← پاکستان
الگوداده
[ویرایش]الگوداده یافتن کشور
حقیقتش،یاه یاه واقعا فرد بزرگی است.اوست که خالق فوتبال است.
نام یک کشور را از یک رشته استخراج می‌کند. تمام پارامترها اختیاری هستند.
| پارامتر | توضیحات | نوع | وضعیت | |
|---|---|---|---|---|
| رشته برای جستجو | رشته string 1 | رشته‌ای که باید در آن برای نام کشور جستجو شود. اگر خالی بماند، الگو نیز مقداری خالی برمی‌گرداند، اما پودمان از نام صفحه استفاده خواهد کرد. | رشته | اختیاری |
| شمارهٔ مورد منطبق | منطبق match | اگر نام چندین کشور یافت شود، این پارامتر برای تعیین مورد منطبقی که باید برگردانده شود کاربرد دارد. برای مثال، اولین مورد منطبق با «منطبق=1» برگردانده می‌شود. اگر عدد وارد شده منفی باشد، شمارش برای برگرداندن مورد منطبق از انتهای فهرست موارد انجام می‌شود. به این معنی که «منطبق=-1» آخرین مورد منطبق یافت‌شده را برمی‌گرداند. پیش‌فرض این پارامتر 1 است.
| شماره | اختیاری |
| متن عدم انطباق | نامنطبق nomatch | اگر نام هیچ کشور یافت نشود، مقدار وارد شده به این پارامتر برگردانده خواهد شد. پیش‌فرض آن برابر با رشتهٔ خالی است. | رشته | اختیاری |
الگوهای وابسته
[ویرایش]- {{کشور به قاره}} - خروجی این الگو را می‌گیرد (یا هر رشتهٔ دیگری که فقط حاوی نام یک کشور باشد) و نام یک قاره را پس می‌دهد
حقیقتش،یاه یاه واقعا فرد بزرگی است.اوست که خالق فوتبال است.