الگو:یافتن کشور

از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

این الگو نام یک کشور یا قاره را از یک رشته استخراج می‌کند (آفریقا، هند، بریتانیا و غیره). اگر مورد منطبقی یافت نشود، هیچ‌چیزی برگردانده نخواهد شد.

فهرست کشورها در کدهای پودمان:Find country آمده است - عملکرد کدهای پودمان به ترتیب و از بالا به پایین آن فهرست انجام می‌شود. «بلندترین» حالت نام کشور در ابتدا می‌آید، بنابراین، «جمهوری دموکراتیک خلق کره» پیش از «کره شمالی» آمده و هر دو مطنبق خواهند بود.

برخی گزینه‌ها برای تنظیم رفتار این الگو در دسترس هستند.

استفاده[ویرایش]

کاربرد ابتدایی[ویرایش]

{{یافتن کشور|فلان}}

این روش کاربرد الگو نخستین مورد انطباق با نام یک کشور یا قاره در رشتهٔ «فلان» را برمی‌گرداند.

اگر مورد منطبقی یافت نشود، رشتهٔ خالی برگردانده خواهد شد. این کار، امکان کاربرد سادهٔ الگو در سایر الگوها را فراهم می‌کند.

{{#اگر: {{یافتن کشور}}|<!-- اگر مورد منطبقی نبود، کاری نکن -->|این رشته حاوی نام هیچ کشوری نیست}}

پارامترها اختیاری[ویرایش]

یکی از پارامترها الزامی، و دو پارامتر دیگر اختیاری هستند:

  • |رشته=مقدار
این پارامتر الگو را مجبور می‌کند که از عنوانی متفاوت از عنوان صفحهٔ کنونی استفاده کند.
  • |نامنطبق=مقدار
این پارامتر برای تعیین پیامی کاربرد دارد که در صورت یافت نشدن مورد منطبق نمایش خواهد یافت. برای مثال:
خروجی پیش‌فرض {{یافتن کشور|روباه قهوه‌ای‌رنگ چابک از روی سگ تنبل پرید}}
به‌همراه پارامتر نامنطبق {{یافتن کشور|روباه قهوه‌ای‌رنگ چابک از روی سگ تنبل پرید|نامنطبق=فاقد کشور!}} ← فاقد کشور!
  • |منطبق=عدد
اگر نام چندین کشور یافت شود، این پارامتر برای تعیین مورد منطبقی که باید برگردانده شود کاربرد دارد. برای مثال، اولین مورد منطبق با |منطبق=1 برگردانده می‌شود. اگر عدد وارد شده منفی باشد، شمارش برای برگرداندن مورد منطبق از انتهای فهرست موارد انجام می‌شود. به این معنی که |منطبق=-1 آخرین مورد منطبق یافت‌شده را برمی‌گرداند. پیش‌فرض این پارامتر 1 است.
نمونه‌ها:
{{یافتن کشور|رویدادها در بنگلادش، هند و پاکستان (و احتمالاً سریلانکا) |منطبق=2}} ← هند
{{یافتن کشور|رویدادها در بنگلادش، هند و پاکستان (و احتمالاً سریلانکا) |منطبق=-2}} ← پاکستان

الگوداده[ویرایش]

این، توضیحاتِ الگوداده است که توسط TemplateWizard، ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود. گزارش خطای ماهیانه برای این الگو را ببینید.

الگوداده یافتن کشور

نام یک کشور را از یک رشته استخراج می‌کند. تمام پارامترها اختیاری هستند.

پارامترهای الگو[ویرایش داده‌های الگو]

پارامترتوضیحاتنوعوضعیت
رشته برای جستجورشته string 1

رشته‌ای که باید در آن برای نام کشور جستجو شود. اگر خالی بماند، الگو نیز مقداری خالی برمی‌گرداند، اما پودمان از نام صفحه استفاده خواهد کرد.

رشتهاختیاری
شمارهٔ مورد منطبقمنطبق match

اگر نام چندین کشور یافت شود، این پارامتر برای تعیین مورد منطبقی که باید برگردانده شود کاربرد دارد. برای مثال، اولین مورد منطبق با «منطبق=1» برگردانده می‌شود. اگر عدد وارد شده منفی باشد، شمارش برای برگرداندن مورد منطبق از انتهای فهرست موارد انجام می‌شود. به این معنی که «منطبق=-1» آخرین مورد منطبق یافت‌شده را برمی‌گرداند. پیش‌فرض این پارامتر 1 است.

پیش‌فرض
1
شمارهاختیاری
متن عدم انطباقنامنطبق nomatch

اگر نام هیچ کشور یافت نشود، مقدار وارد شده به این پارامتر برگردانده خواهد شد. پیش‌فرض آن برابر با رشتهٔ خالی است.

رشتهاختیاری

الگوهای وابسته[ویرایش]

  • {{کشور به قاره}} - خروجی این الگو را می‌گیرد (یا هر رشتهٔ دیگری که فقط حاوی نام یک کشور باشد) و نام یک قاره را پس می‌دهد