راهنما:تابع تجزیهگر گزینه
From Wikipedia, the free encyclopedia
تابع تجزیهگر گزینه (انگلیسی: switch parser function) که کد آن بهشکل «#گزینه» یا «#switch» است، از میان فهرستی از گزینهها، نخستین شاخهٔ منطبق را انتخاب میکند و به عبارت دیگر مانند گزارهٔ حالت (انگلیسی: case statement) عمل میکند.
این صفحه یک راهنمای چگونه انجام دادن است. که یک کار یا فرایند را در ویکیپدیای فارسی شرح میدهد. این صفحه یکی از سیاستها یا رهنمودهای ویکیپدیا نیست، زیرا هنوز توسط اجتماع مورد بررسی و تأیید قرار نگرفته است. |
هر یک از شاخهها میتوانند یک مقدار، یک عبارت (محاسبه) یا یک فراخوانی الگو[1] باشند که ارزیابی شده و برای بررسی انطباق، با مقدار دادهشده با تابع گزینه مقایسه میشوند. اگرچه بسیاری از ساختارهای #گزینه برای گشتن در میان مجموعهای ساده از مقدارها مورد استفاده قرار میگیرند، اما شاخهها میتوانند شامل عبارت بولی نیز باشند تا بهعنوان پیششرطهایی جهت آزمودن تا پیش از صحیح بودن یکی از مقدارها عمل کنند و ساختار آنها نیز مشابه ساختار if-elseif-elseif-elseif-else خواهد بود. مقدار تابع گزینه در قالب یک رشتهٔ نویسه با سایر گزینهها مقایسه میشود و نه یک عدد؛ بنابراین «5» با «5.00» برابر نخواهد بود مگر آن که در قالب <nowiki>"{{#expr:{{{1|5.00}}} }}" (="5")</nowiki>
مورد مقایسه قرار گیرد.
تابع #گزینه میتوان شامل بیش از ۱٬۰۰۰ شاخه باشد، اما برای سرعت بیشتر در اجرا بهتر است به چندین بخش با تعداد کمتر از ۱۰۰ شاخه تفکیک شود. شاخههای بالاتر، سریعتر اجرا میشوند و شاخههای پایینی باید منتظر بمانند تا مقایسهٔ شاخههای بالاتر به پایان برسد. از آنجا که #گزینه یک تابع تجزیهگر است، میتواند در هر صفحهای، حتی در متن یک مقاله نیز استفاده شود، اما در بیشتر موارد، از این تابع در درون یک الگو استفاده میشوند تا بر پایه مقداری که به پارامترهای الگو فرستاده شدهاست، گزینهها را انطباق دهد.