PHP setlocale() Function












❮ مرجع رشته PHP




مثال


محل را روی انگلیسی ایالات متحده تنظیم کنید و سپس دوباره به حالت پیش فرض برگردید:




echo setlocale(LC_ALL"US");

echo "
";

echo setlocale(LC_ALL،NULL);

?>

این را خودتان امتحان کنید »



تعریف و استفاده


تابع setlocale() اطلاعات محلی را تنظیم می کند.


اطلاعات محلی زبان، پول، زمان و سایر اطلاعات مختص یک منطقه جغرافیایی است.


توجه: تابع setlocale() زبان محلی را فقط برای اسکریپت فعلی تغییر می‌دهد.


نکته: اطلاعات محلی را می توان با setlocale (LC_ALL,NULL) روی پیش فرض سیستم تنظیم کرد


نکته: برای دریافت اطلاعات قالب بندی عددی، به بخش مراجعه کنید
تابع localeconv().




نحو



setlocale (ثابت، مکان)


مقادیر پارامتر















پارامتر توضیح
ثابت لازم است. مشخص می کند که چه اطلاعات محلی باید تنظیم شود.


ثابت های موجود:



  • LC_ALL - همه موارد زیر

  • LC_COLLATE -  ترتیب مرتب سازی

  • LC_CTYPE - طبقه‌بندی و تبدیل نویسه‌ها (مثلاً همه نویسه‌ها باید کوچک یا بزرگ باشند)

  • LC_MESSAGES - قالب‌بندی پیام سیستم

  • LC_MONETARY - قالب بندی پولی/ارز

  • LC_NUMERIC - قالب‌بندی عددی

  • LC_TIME - قالب‌بندی تاریخ و زمان
مکان لازم است. مشخص می کند که اطلاعات منطقه برای کدام کشور/منطقه تنظیم شود. می تواند یک رشته یا یک آرایه باشد. امکان ارسال چندین مکان وجود دارد.

اگر مکان NULL یا رشته خالی "" باشد، نام مکان ها از مقادیر متغیرهای محیطی با همان نام های ثابت بالا، یا از " تنظیم می شود. LANG".

اگر مکان "0" باشد، تنظیمات مکان تحت تاثیر قرار نمی‌گیرد، فقط تنظیمات فعلی برگردانده می‌شود.

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

توجه: برای مشاهده همه کدهای زبان موجود، به مرجع کد زبان.

جزئیات فنی















مقدار بازگشتی: تنظیمات محلی فعلی یا FALSE را در صورت شکست برمی‌گرداند. مقدار بازگشتی بستگی به سیستمی دارد که PHP در حال اجرا است.
نسخه PHP: 4+
تغییر: PHP 5.3.0 - اگر رشته ای به جای یکی از ثابت های LC_ به پارامتر constant ارسال شود، این تابع یک اخطار E_DREPRECATED ارسال می کند.



❮ مرجع رشته PHP