ICU 64.2  64.2
Data Structures | Namespaces | Macros | Typedefs | Enumerations
messagepattern.h File Reference

C++ API: MessagePattern class: Parses and represents ICU MessageFormat patterns. More...

#include "unicode/utypes.h"
#include "unicode/parseerr.h"
#include "unicode/unistr.h"

Go to the source code of this file.

Data Structures

class  icu::MessagePattern
 Parses and represents ICU MessageFormat patterns. More...
 
class  icu::MessagePattern::Part
 A message pattern "part", representing a pattern parsing event. More...
 

Namespaces

 icu
 File coll.h.
 

Macros

#define UMSGPAT_ARG_TYPE_HAS_PLURAL_STYLE(argType)   ((argType)==UMSGPAT_ARG_TYPE_PLURAL || (argType)==UMSGPAT_ARG_TYPE_SELECTORDINAL)
 Returns TRUE if the argument type has a plural style part sequence and semantics, for example UMSGPAT_ARG_TYPE_PLURAL and UMSGPAT_ARG_TYPE_SELECTORDINAL. More...
 
#define UMSGPAT_NO_NUMERIC_VALUE   ((double)(-123456789))
 Special value that is returned by getNumericValue(Part) when no numeric value is defined for a part. More...
 

Typedefs

typedef enum UMessagePatternApostropheMode UMessagePatternApostropheMode
 
typedef enum UMessagePatternPartType UMessagePatternPartType
 
typedef enum UMessagePatternArgType UMessagePatternArgType
 

Enumerations

enum  UMessagePatternApostropheMode { UMSGPAT_APOS_DOUBLE_OPTIONAL, UMSGPAT_APOS_DOUBLE_REQUIRED }
 Mode for when an apostrophe starts quoted literal text for MessageFormat output. More...
 
enum  UMessagePatternPartType {
  UMSGPAT_PART_TYPE_MSG_START, UMSGPAT_PART_TYPE_MSG_LIMIT, UMSGPAT_PART_TYPE_SKIP_SYNTAX, UMSGPAT_PART_TYPE_INSERT_CHAR,
  UMSGPAT_PART_TYPE_REPLACE_NUMBER, UMSGPAT_PART_TYPE_ARG_START, UMSGPAT_PART_TYPE_ARG_LIMIT, UMSGPAT_PART_TYPE_ARG_NUMBER,
  UMSGPAT_PART_TYPE_ARG_NAME, UMSGPAT_PART_TYPE_ARG_TYPE, UMSGPAT_PART_TYPE_ARG_STYLE, UMSGPAT_PART_TYPE_ARG_SELECTOR,
  UMSGPAT_PART_TYPE_ARG_INT, UMSGPAT_PART_TYPE_ARG_DOUBLE
}
 MessagePattern::Part type constants. More...
 
enum  UMessagePatternArgType {
  UMSGPAT_ARG_TYPE_NONE, UMSGPAT_ARG_TYPE_SIMPLE, UMSGPAT_ARG_TYPE_CHOICE, UMSGPAT_ARG_TYPE_PLURAL,
  UMSGPAT_ARG_TYPE_SELECT, UMSGPAT_ARG_TYPE_SELECTORDINAL
}
 Argument type constants. More...
 
enum  { UMSGPAT_ARG_NAME_NOT_NUMBER =-1, UMSGPAT_ARG_NAME_NOT_VALID =-2 }
 

Detailed Description

C++ API: MessagePattern class: Parses and represents ICU MessageFormat patterns.

Definition in file messagepattern.h.

Macro Definition Documentation

◆ UMSGPAT_ARG_TYPE_HAS_PLURAL_STYLE

#define UMSGPAT_ARG_TYPE_HAS_PLURAL_STYLE (   argType)    ((argType)==UMSGPAT_ARG_TYPE_PLURAL || (argType)==UMSGPAT_ARG_TYPE_SELECTORDINAL)

Returns TRUE if the argument type has a plural style part sequence and semantics, for example UMSGPAT_ARG_TYPE_PLURAL and UMSGPAT_ARG_TYPE_SELECTORDINAL.

Stable:
ICU 50

Definition at line 270 of file messagepattern.h.

◆ UMSGPAT_NO_NUMERIC_VALUE

#define UMSGPAT_NO_NUMERIC_VALUE   ((double)(-123456789))

Special value that is returned by getNumericValue(Part) when no numeric value is defined for a part.

See also
MessagePattern.getNumericValue()
Stable:
ICU 4.8

Definition at line 297 of file messagepattern.h.

Typedef Documentation

◆ UMessagePatternApostropheMode

Stable:
ICU 4.8

Definition at line 94 of file messagepattern.h.

◆ UMessagePatternArgType

Stable:
ICU 4.8

Definition at line 262 of file messagepattern.h.

◆ UMessagePatternPartType

Stable:
ICU 4.8

Definition at line 209 of file messagepattern.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum
Enumerator
UMSGPAT_ARG_NAME_NOT_NUMBER 

Return value from MessagePattern.validateArgumentName() for when the string is a valid "pattern identifier" but not a number.

Stable:
ICU 4.8
UMSGPAT_ARG_NAME_NOT_VALID 

Return value from MessagePattern.validateArgumentName() for when the string is invalid.

It might not be a valid "pattern identifier", or it have only ASCII digits but there is a leading zero or the number is too large.

Stable:
ICU 4.8

Definition at line 273 of file messagepattern.h.

◆ UMessagePatternApostropheMode

Mode for when an apostrophe starts quoted literal text for MessageFormat output.

The default is DOUBLE_OPTIONAL unless overridden via uconfig.h (UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE).

A pair of adjacent apostrophes always results in a single apostrophe in the output, even when the pair is between two single, text-quoting apostrophes.

The following table shows examples of desired MessageFormat.format() output with the pattern strings that yield that output.

Desired output DOUBLE_OPTIONAL DOUBLE_REQUIRED
I see {many} I see '{many}' (same)
I said {'Wow!'} I said '{''Wow!''}' (same)
I don't know I don't know OR
I don''t know
I don''t know
Stable:
ICU 4.8
See also
UCONFIG_MSGPAT_DEFAULT_APOSTROPHE_MODE
Enumerator
UMSGPAT_APOS_DOUBLE_OPTIONAL 

A literal apostrophe is represented by either a single or a double apostrophe pattern character.

Within a MessageFormat pattern, a single apostrophe only starts quoted literal text if it immediately precedes a curly brace {}, or a pipe symbol | if inside a choice format, or a pound symbol # if inside a plural format.

This is the default behavior starting with ICU 4.8.

Stable:
ICU 4.8
UMSGPAT_APOS_DOUBLE_REQUIRED 

A literal apostrophe must be represented by a double apostrophe pattern character.

A single apostrophe always starts quoted literal text.

This is the behavior of ICU 4.6 and earlier, and of the JDK.

Stable:
ICU 4.8

Definition at line 68 of file messagepattern.h.

◆ UMessagePatternArgType

Argument type constants.

Returned by Part.getArgType() for ARG_START and ARG_LIMIT parts.

Messages nested inside an argument are each delimited by MSG_START and MSG_LIMIT, with a nesting level one greater than the surrounding message.

Stable:
ICU 4.8
Enumerator
UMSGPAT_ARG_TYPE_NONE 

The argument has no specified type.

Stable:
ICU 4.8
UMSGPAT_ARG_TYPE_SIMPLE 

The argument has a "simple" type which is provided by the ARG_TYPE part.

An ARG_STYLE part might follow that.

Stable:
ICU 4.8
UMSGPAT_ARG_TYPE_CHOICE 

The argument is a ChoiceFormat with one or more ((ARG_INT | ARG_DOUBLE), ARG_SELECTOR, message) tuples.

Stable:
ICU 4.8
UMSGPAT_ARG_TYPE_PLURAL 

The argument is a cardinal-number PluralFormat with an optional ARG_INT or ARG_DOUBLE offset (e.g., offset:1) and one or more (ARG_SELECTOR [explicit-value] message) tuples.

If the selector has an explicit value (e.g., =2), then that value is provided by the ARG_INT or ARG_DOUBLE part preceding the message. Otherwise the message immediately follows the ARG_SELECTOR.

Stable:
ICU 4.8
UMSGPAT_ARG_TYPE_SELECT 

The argument is a SelectFormat with one or more (ARG_SELECTOR, message) pairs.

Stable:
ICU 4.8
UMSGPAT_ARG_TYPE_SELECTORDINAL 

The argument is an ordinal-number PluralFormat with the same style parts sequence and semantics as UMSGPAT_ARG_TYPE_PLURAL.

Stable:
ICU 50

Definition at line 219 of file messagepattern.h.

◆ UMessagePatternPartType

MessagePattern::Part type constants.

Stable:
ICU 4.8
Enumerator
UMSGPAT_PART_TYPE_MSG_START 

Start of a message pattern (main or nested).

The length is 0 for the top-level message and for a choice argument sub-message, otherwise 1 for the '{'. The value indicates the nesting level, starting with 0 for the main message.

There is always a later MSG_LIMIT part.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_MSG_LIMIT 

End of a message pattern (main or nested).

The length is 0 for the top-level message and the last sub-message of a choice argument, otherwise 1 for the '}' or (in a choice argument style) the '|'. The value indicates the nesting level, starting with 0 for the main message.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_SKIP_SYNTAX 

Indicates a substring of the pattern string which is to be skipped when formatting.

For example, an apostrophe that begins or ends quoted text would be indicated with such a part. The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_INSERT_CHAR 

Indicates that a syntax character needs to be inserted for auto-quoting.

The length is 0. The value is the character code of the insertion character. (U+0027=APOSTROPHE)

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_REPLACE_NUMBER 

Indicates a syntactic (non-escaped) # symbol in a plural variant.

When formatting, replace this part's substring with the (value-offset) for the plural argument value. The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_START 

Start of an argument.

The length is 1 for the '{'. The value is the ordinal value of the ArgType. Use getArgType().

This part is followed by either an ARG_NUMBER or ARG_NAME, followed by optional argument sub-parts (see UMessagePatternArgType constants) and finally an ARG_LIMIT part.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_LIMIT 

End of an argument.

The length is 1 for the '}'. The value is the ordinal value of the ArgType. Use getArgType().

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_NUMBER 

The argument number, provided by the value.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_NAME 

The argument name.

The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_TYPE 

The argument type.

The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_STYLE 

The argument style text.

The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_SELECTOR 

A selector substring in a "complex" argument style.

The value is undefined and currently always 0.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_INT 

An integer value, for example the offset or an explicit selector value in a PluralFormat style.

The part value is the integer value.

Stable:
ICU 4.8
UMSGPAT_PART_TYPE_ARG_DOUBLE 

A numeric value, for example the offset or an explicit selector value in a PluralFormat style.

The part value is an index into an internal array of numeric values; use getNumericValue().

Stable:
ICU 4.8

Definition at line 100 of file messagepattern.h.