(PHP 5 >= 5.3.0, PECL intl >= 1.0.0)
Collator::__construct — Bir karşılaştırıcı oluşturur
$yerel
)Yeni bir Collator örneği oluşturur.
yerel
Kullanılacak karşılaştırma kurallarını içeren yerel. Yerel olarak özel
değerler verilebilir; eğer NULL
verilirse öntanımlı yerelin
karşılaştırma kuralları geçerli olur. Eğer boş dizge ("") veya "root"
verilirse UCA kuralları geçerli olur.
Kullanıcının farklı ülke ve yörelerle ilgili beklentilerine bağlı olarak, doğru sıralama ve eşleştirmeyi yapabilmek için yerel (Locale) en önemli özniteliktir. Öntanımlı » UCA kuralları sadece Felemenkçe, Portekizce gibi bir kaç yerel için doğru sıralama yapar (buradaki "doğru" sözcüğü, kullanıcının dille ilgili beklentileri ile ilgilidir). Öntanımlı yerelin yetmediği noktada UCA'nın beklediğiniz sıralamayı yapabilmesi için doğru yereli belirtmelisiniz. Yerelin seçilmesiyle, yerel için makul sayılabilecek tüm öznitelikler özdevinimli olarak belli değerlere ayarlanır. Bu bakımdan çoğunlukla yerele özgü özniteliklerin ayrıca belirtilmesi gerekmez. Bazı durumlarda yerel seçimi dizge karşılaştırma başarımında ve/veya sıralama anahtarı uzunluğunda bir fark oluşturabilir.
Bir Collator örneği.
Hata durumunda "boş" bir nesne döner. Neler olup bittiğini öğrenmek için intl_get_error_code() ve/veya intl_get_error_message() işlevini kullanabilirsiniz.
Örnek 1 - Collator::__construct() örneği
<?php
$coll = new Collator( 'en_CA' );
?>