COLLATOR.__CONSTRUCT(3) 						 1						   COLLATOR.__CONSTRUCT(3)

Collator::__construct - Create a collator

SYNOPSIS

       public Collator::__construct (string  $locale)

DESCRIPTION

	Creates a new instance of Collator.

PARAMETERS

	      o $locale
		- The locale whose collation rules should be used. Special values for locales can be passed in - if null is passed for the locale,
		the default locale's collation rules will be used. If "root" is passed, UCA rules will be used.  The Locale attribute is typically
		the  most  important  attribute  for  correct  sorting and matching, according to the user expectations in different countries and
		regions. The default UCA ordering will only sort a few languages such as  Dutch  and  Portuguese  correctly  ("correctly"  meaning
		according  to  the  normal  expectations  for users of the languages). Otherwise, you need to supply the locale to UCA in order to
		properly collate text for a given language. Thus a locale needs to be supplied so as to choose a collator that is  correctly  tai-
		lored  for that locale. The choice of a locale will automatically preset the values for all of the attributes to something that is
		reasonable for that locale. Thus most of the time the other attributes do not need to be explicitly set. In some cases, the choice
		of locale will make a difference in string comparison performance and/or sort key length.

RETURN VALUES

	Returns Collator instance.

ERRORS
/EXCEPTIONS
	Returns an "empty" object on error. You can use intl_get_error_code(3) and/or intl_get_error_message(3) to know what happened.

EXAMPLES

       Example #1

	      Collator.__construct(3) example

	      <?php
	      $coll = new Collator( 'en_CA' );
	      ?>

SEE ALSO

       Collator.create(3), collator_create(3).

PHP Documentation Group 												   COLLATOR.__CONSTRUCT(3)