Collator::setStrength
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Collator::setStrength
Референца за `collator.setstrength.php` со подобрена типографија и навигација.
Collator::setStrength
collator_set_strength
Класата Collator
Collator::setStrength -- collator_set_strength — Set collation strength
= NULL
Напиши целосна ознака на елемент
Процедурален стил
На За да ја изградите екстензијата, треба да го инсталирате Постави јачина на подредување
-
Услугата за подредување поддржува многу нивоа на споредба (наречени „Нивоа“, но познати и како „Јачини“). Овие категории му овозможуваат на ICU да ги подредува низите прецизно според локалните конвенции. Сепак, со дозволување на селективно вработување на нивоата, пребарувањето за низа во текст може да се изврши со различни услови за совпаѓање.Примарно ниво
level 1strength. -
: Типично, ова се користи за означување на разлики помеѓу основните знаци (на пример, „a“ < „b“). Тоа е најсилната разлика. На пример, речниците се поделени на различни делови според основниот знак. Ова се нарекува иСекундарно ниво
level 2strength.Забелешка:
: Акцентите во знаците се сметаат за секундарни разлики (на пример, „as“ < „às“ < „at“). Други разлики помеѓу буквите исто така може да се сметаат за секундарни разлики, во зависност од јазикот. Секундарната разлика се игнорира кога постои примарна разлика каде било во низите. Ова се нарекува и
-
Забелешка: Во некои јазици (како дански), одредени акцентирани букви се сметаат за посебни основни знаци. Сепак, во повеќето јазици, акцентираната буква има само секундарна разлика од неакцентираната верзија на таа буква.Терцијарно ниво
level 3strength. -
: Разликите помеѓу големи и мали букви во знаците се разликуваат на терцијарно ниво (на пример, „ao“ < „Ao“ < „aò“). Покрај тоа, варијанта на буквата се разликува од основната форма на терцијарно ниво (како „a“ и „𝒶“). Друг пример е разликата помеѓу големи и мали Кана. Терцијарната разлика се игнорира кога постои примарна или секундарна разлика каде било во низите. Ова се нарекува иКватернарно ниво
level 4: Кога пунктуацијата се игнорира (види Игнорирање на пунктуации) на нивоата 1-3, може да се користи дополнително ниво за разликување на зборови со и без пунктуација (на пример, „ab“ < „a-b“ < „aB“). Оваа разлика се игнорира кога постои примарна, секундарна или терцијарна разлика. Ова е познато и како -
јачина. Кватернарното ниво треба да се користи само ако е потребно игнорирање на пунктуацијата или при обработка на јапонски текст (види Обработка на Хирагана).Идентично ниво
level 5strength.
: Кога сите други нивоа се еднакви, идентичното ниво се користи како решавач на нерешени резултати. Вредностите на точките на кодот на Unicode на NFD формата на секоја низа се споредуваат на ова ниво, само во случај да нема разлика на нивоата 1-4. На пример, хебрејските кантелациони знаци се разликуваат само на ова ниво. Ова ниво треба да се користи штедливо, бидејќи само разликите во вредностите на точките на кодот помеѓу две низи се исклучително ретка појава. Користењето на ова ниво значително ја намалува перформансата и за инкрементално споредување и за генерирање клучеви за сортирање (како и го зголемува должината на клучевите за сортирање). Познато е и како
Параметри
object-
Колатор object.
strength-
На пример, луѓето може да изберат да ги игнорираат акцентите или да ги игнорираат акцентите и големината на буквите при пребарување текст. Речиси сите знаци се разликуваат според првите три нивоа, а во повеќето локалитети стандардната вредност е терцијарна. Сепак, ако Алтернативното е поставено на Поместено, тогаш Кватернарната јачина може да се користи за решавање на нерешени резултати меѓу празни места, пунктуација и симболи што инаку би биле игнорирани. Ако се потребни многу фини разлики меѓу знаците, тогаш може да се користи Идентичната јачина (на пример, Идентичната јачина разликува помеѓу Математичката црна мала буква А и Математичката курзивна мала буква А.). Сепак, користењето на нивоа повисоки од терцијарните, идентичната јачина резултира со значително подолги клучеви за сортирање и побавно перформанса при споредување на низи за еднакви низи.
е што дополнителни вредности Alternate може да се додадат во иднина. Опцијата UCA Blanked се изразува со Strength поставен на 3, и Alternate поставен на Shifted. Стандардно за повеќето локали е NonIgnorable. Ако е избрано Shifted, може да биде побавно ако има многу низи кои се исти освен пунктуацијата; должината на клучот за сортирање нема да биде засегната освен ако нивото на јачина исто така не се зголеми.
Вратени вредности
Секогаш враќа true.
Примери
Пример #1 collator_set_strength() example
<?php
$arr = array( 'aò', 'Ao', 'ao' );
$coll = collator_create( 'en_US' );
// Sort array using default strength.
collator_sort( $coll, $arr );
var_export( $arr );
// Sort array using primary strength.
collator_set_strength( $coll, Collator::PRIMARY );
collator_sort( $coll, $arr );
var_export( $arr );
?>Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред
array ( 0 => 'ao', 1 => 'Ao', 2 => 'aò', ) array ( 0 => 'aò', 1 => 'Ao', 2 => 'ao', )