Classe: ChoiceFormat  - X-Ref

ChoiceFormat class.

ChoiceFormat converts between ranges of numeric values and string
names for those ranges.

A ChoiceFormat splits the real number line -Inf to +Inf into two or
more contiguous ranges. Each range is mapped to a string.
ChoiceFormat is generally used in a MessageFormat for displaying
grammatically correct plurals such as "There are 2 files."

<code>
$string = '[0] are no files |[1] is one file |(1,Inf] are {number} files';

$formatter = new MessageFormat(...); //init for a source
$translated = $formatter->format($string);

$choice = new ChoiceFormat();
echo $choice->format($translated, 0); //shows "are no files"
</code>

The message/string choices are separated by the pipe "|" followed
by a set notation of the form
# <t>[1,2]</t> -- accepts values between 1 and 2, inclusive.
# <t>(1,2)</t> -- accepts values between 1 and 2, excluding 1 and 2.
# <t>{1,2,3,4}</t> -- only values defined in the set are accepted.
# <t>[-Inf,0)</t> -- accepts value greater or equal to negative infinity
and strictly less than 0
Any non-empty combinations of the delimiters of square and round brackets
are acceptable.