"clang" CFE Internals Manual

From: Sebastian Redl Date: Sat, 22 Nov 2008 22:16:45 +0000 (+0000) Subject: Documentation for the plural modifier. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6816856fb1feaf3a8add3d5cd99ec19339849c4e;p=clang Documentation for the plural modifier. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@59885 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/InternalsManual.html b/docs/InternalsManual.html index 6ecc5d6149..6434a910e1 100644 --- a/docs/InternalsManual.html +++ b/docs/InternalsManual.html @@ -3,6 +3,11 @@ "clang" CFE Internals Manual + @@ -253,9 +258,33 @@ Clang:

Description:... "plural" format -Example:".." +Example:"you have %1 %plural{1:mouse|:mice}1 connected to + your computer" Classes:Integers -Description:... +Description:

This is a formatter for complex plural forms. + It is designed to handle even the requirements of languages with very + complex plural forms, as many Baltic languages have. The argument consists + of a series of expression/form pairs, separated by ':', where the first form + whose expression evaluates to true is the result of the modifier.

An expression can be empty, in which case it is always true. See the + example at the top. Otherwise, it is a series of one or more numeric + conditions, separated by ','. If any condition matches, the expression + matches. Each numeric condition can take one of three forms.

number: A simple decimal number matches if the argument is the same + as the number. Example: "{1:mouse|:mice}"
range: A range in square brackets matches if the argument is within + the range. Then range is inclusive both ends. Example: + "{0:none|1:one|[2,5]:some|:many}"
modulo: A modulo operator is followed by a number, and equals sign + and either a number or a range. The tests are the same as for plain + numbers and ranges, but the argument is taken modulo the number first. + Example: "{%100=0:even hundred|%100=[1,50]:lower half|:everything + else}"

The parser is very unforgiving. A syntax error, even whitespace, will + abort, as will a failure to match the argument against any + expression.