Locale sınıfı
(PHP 5 >= 5.3.0, PECL intl >= 1.0.0)
Giriş
Bir yerel (Locale), API'den dili, kültürü ve bölgeye özge özellikleri öğrenmek için kullanılan bir betimleyicidir. PHP yerelleri ICU (ve birçok Unix benzeri sistem üreticisi, Mac, Java, vs.) tarafından kullanılan CLDR yerelleriyle aynı yöntemle düzenlenip betimlenirler. Yereller, (alt çizgi yerine tire kullanılan) RFC 4646 dil yaftalarına ek olarak daha geleneksel olan alt çizgi kullanan betimleyiciler kullanılarak da betimlenebilir. Aksi belirtilmedikçe bu sınıftaki işlevler her iki gösterim biçemine de duyarlıdır.
Yerel betimleyicileri için örnekler:
- tr-TR (Türkçe, Türkiye)
- zh-Hant-TW (Çince, Geleneksel Yazı, Tayvan)
- fr-CA, fr-FR (Kanada Fransızcası ve Fransa Fransızcası)
Locale sınıfı (ve ilgili yordamsal işlevler) yerel betimleyicileri ile etkileşim, bir betimleyicinin iyi biçimliliğini, geçerliliğini doğrulama, vs. için kullanılırlar. UAX #35'teki (ve ICU tarafından miras alınan) CLDR tarafından kullanılan eklentiler ICU'da da normal olarak geçerlidir ve kullanılırlar.
Locale sınıfı bir nesne olarak örneklenemez. Sağlanan tüm işlev/yöntemler duruktur.
Boş veya NULL dizge "kök" yerel olarak ele alınır ve CLDR'de
"en_US_POSIX" yereline denktir. Dil yaftaları (ve dolayısıyla yerel
betimleyicileri) harf büyüklüğüne duyarsızdır. Belirtimle harf eşleştirmesi
yapacak bir meşrulaştırma işlevi mevcuttur.
Sınıf Sözdizimi
$dil_yaftası
, string $yerel
[, bool $meşru = false
[, string $öntanımlı
]] )Öntanımlı Sabitler
-
Locale::DEFAULT_LOCALE(null) - NumberFormatter gibi yereli etkileyen çeşitli sınıfların çeşitli yöntemlerinde yerel değiştirgesi olarak kullanılır. Bu sabit, bu yöntemlerin öntanımlı yereli kullanmasını sağlar.
Bu sabitler çeşitli sınıfların getLocalte yöntemleri için yerel seçimlerini belirler.
-
Locale::ACTUAL_LOCALE(string) - Asıl verinin geldiği yereldir.
-
Locale::VALID_LOCALE(string) - ICU tarafından desteklenen en geçerli yereldir.
Bu sabitler, yerellerin nasıl çözümlenip oluşturulduğunu tanımlar. Bunların, locale_compose() işlevinin dizi değiştirgesinde anahtar olarak kullanılması gerekir ve locale_parse() işlevinden dönen ilişkisel dizinin anahtarlarıdırlar.
-
Locale::LANG_TAG(string) - Dil alt yaftası
-
Locale::EXTLANG_TAG(string) - Ek dil alt yaftası
-
Locale::SCRIPT_TAG(string) - Yazı alt yaftası
-
Locale::REGION_TAG(string) - Bölge yaftası
-
Locale::VARIANT_TAG(string) - Lehçe alt yaftası
-
Locale::GRANDFATHERED_LANG_TAG(string) - Ebeveyn dil alt yaftası
-
Locale::PRIVATE_TAG(string) - Özel alt yafta
İçindekiler
- Locale::acceptFromHttp — HTTP "Accept-Language" başlığıyla en iyi eşleşen yereli bulmaya çalışır
- Locale::composeLocale — Doğru sıralanmış yerel ile döner
- Locale::filterMatches — Bir dil yaftasının bir yerelle eşleşip eşleşmediğine bakar
- Locale::getAllVariants — Girdi yerelindeki tüm lehçeleri döndürür
- Locale::getDefault — Öntanımlı yerel değerini döndürür
- Locale::getDisplayLanguage — Girdi yerelindeki anadil kodunun yerelleştirilmiş ismini döndürür
- Locale::getDisplayName — Girdi yerelinin yerelleştirilmiş ismini döndürür
- Locale::getDisplayRegion — Girdi yereli için yerelleştirilmiş ülke ismini döndürür
- Locale::getDisplayScript — Girdi yereli yazı türünün yerelleştirilmiş ismini döndürür
- Locale::getDisplayVariant — Girdi yereli lehçesinin yerelleştirilmiş ismini döndürür
- Locale::getKeywords — Girdi yerelindeki anahtar sözcükleri döndürür
- Locale::getPrimaryLanguage — Girdi yerelinden anadil kodunu döndürür
- Locale::getRegion — Girdi yerelinden ülke kodunu döndürür
- Locale::getScript — Girdi yereli için yazı yaftasını döndürür
- Locale::lookup — En iyi eşleşen dili bulmak için dil yaftası listesini araştırır
- Locale::parseLocale — Yerel yaftasını oluşturan alt yaftaları içeren bir dizi döndürür
- Locale::setDefault — Öntanımlı çalışma anı yerelini tanımlar
