Locale sınıfı

    (No version information available, might only be in Git)

    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

    classLocale {
    publicconstintACTUAL_LOCALE;
    publicconstintVALID_LOCALE;
    publicconstnullDEFAULT_LOCALE = null;
    publicconststringLANG_TAG;
    publicconststringEXTLANG_TAG;
    publicconststringSCRIPT_TAG;
    publicconststringREGION_TAG;
    publicconststringVARIANT_TAG;
    publicconststringGRANDFATHERED_LANG_TAG;
    publicconststringPRIVATE_TAG;
    publicstaticacceptFromHttp(string$başlık): string|false
    publicstaticcanonicalize(string$locale): ?string
    publicstaticcomposeLocale(array$alt_yaftalar): string|false
    publicstaticfilterMatches(string$dil_yaftası, string$yerel, bool$meşru = false): ?bool
    publicstaticgetAllVariants(string$yerel): ?array
    publicstaticgetDefault(): string
    publicstaticgetDisplayLanguage(string$hedef_yerel, ?string$adlandırma_yereli = null): string|false
    publicstaticgetDisplayName(string$hedef_yerel, ?string$adlandırma_yereli = null): string|false
    publicstaticgetDisplayRegion(string$ülke_yereli, ?string$adlandırma_yereli = null): string|false
    publicstaticgetDisplayScript(string$yazı_yereli, ?string$adlandırma_yereli = null): string|false
    publicstaticgetDisplayVariant(string$lehçe_yereli, ?string$adlandırma_yereli = null): string|false
    staticgetKeywords(string$yerel): array|false|null
    publicstaticgetPrimaryLanguage(string$yerel): ?string
    publicstaticgetRegion(string$yerel): ?string
    publicstaticgetScript(string$yerel): ?string
    publicstaticlookup(
        array$dil_yaftası,
        string$yerel,
        bool$meşru = false,
        ?string$öntanımlı_yerel = null
    ): ?string
    publicstaticparseLocale(string$yerel): ?array
    publicstaticsetDefault(string$yerel): bool
    }

    Öntanımlı Sabitler

    Locale::DEFAULT_LOCALE
    NumberFormatter gibi yereli etkileyen çeşitli sınıfların çeşitli yöntemlerinde yerel bağımsız değişkeni olarak kullanılır. Bu sabit, bu yöntemlerin öntanımlı yereli kullanmasını sağlar.

    Bu sabitler çeşitli sınıfların getLocale yöntemleri için yerel seçimlerini belirler.

    Locale::ACTUAL_LOCALE
    Asıl verinin geldiği yereldir.
    Locale::VALID_LOCALE
    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 bağımsız değişkeninde anahtar olarak kullanılması gerekir ve locale_parse() işlevinden dönen ilişkisel dizinin anahtarlarıdırlar.

    Locale::LANG_TAG
    Dil alt yaftası
    Locale::EXTLANG_TAG
    Ek dil alt yaftası
    Locale::SCRIPT_TAG
    Yazı alt yaftası
    Locale::REGION_TAG
    Bölge yaftası
    Locale::VARIANT_TAG
    Lehçe alt yaftası
    Locale::GRANDFATHERED_LANG_TAG
    Ebeveyn dil alt yaftası
    Locale::PRIVATE_TAG
    Özel alt yafta

    İçindekiler

    To Top