php8.5
Home/ Manual/ intl / collator/ Collator::getLocale

Collator::getLocale

PHP function Edit on GitHub ✎

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Get the locale name of the collator

Description

Oop

Collator::getLocale(int $type): string|false

Procedural

collator_get_locale(Collator $object, int $type): string|false

Get collector locale name.

Parameters

object

Collator object.

type

You can choose between valid and actual locale ( Locale::VALID_LOCALE and Locale::ACTUAL_LOCALE, respectively).

Return Values

Real locale name from which the collation data comes. If the collator was instantiated from rules or an error occurred, returns false.

Examples

collator_get_locale() example

php
<?php
$coll    = collator_create( 'en_US_California' );
$res_val = collator_get_locale( $coll, Locale::VALID_LOCALE );
$res_act = collator_get_locale( $coll, Locale::ACTUAL_LOCALE );
printf( "Valid locale name: %s\nActual locale name: %s\n",
         $res_val, $res_act );
?>

The above example will output:

output
Requested locale name: en_US_California
Valid locale name: en_US
Actual locale name: en

See Also

Source: reference/intl/collator/get-locale.xml · from the official PHP manual (php/doc-en)