X7ROOT File Manager
Current Path:
/opt/alt/alt-nodejs20/root/usr/include/unicode
opt
/
alt
/
alt-nodejs20
/
root
/
usr
/
include
/
unicode
/
ðŸ“
..
📄
alphaindex.h
(26.54 KB)
📄
appendable.h
(8.54 KB)
📄
basictz.h
(9.99 KB)
📄
brkiter.h
(27.83 KB)
📄
bytestream.h
(10.75 KB)
📄
bytestrie.h
(20.8 KB)
📄
bytestriebuilder.h
(7.48 KB)
📄
calendar.h
(107.68 KB)
📄
caniter.h
(7.53 KB)
📄
casemap.h
(25.42 KB)
📄
char16ptr.h
(7.22 KB)
📄
chariter.h
(23.79 KB)
📄
choicfmt.h
(23.99 KB)
📄
coleitr.h
(13.77 KB)
📄
coll.h
(56.28 KB)
📄
compactdecimalformat.h
(6.88 KB)
📄
curramt.h
(3.67 KB)
📄
currpinf.h
(7.3 KB)
📄
currunit.h
(4.02 KB)
📄
datefmt.h
(40.7 KB)
📄
dbbi.h
(1.19 KB)
📄
dcfmtsym.h
(20.93 KB)
📄
decimfmt.h
(87.46 KB)
📄
displayoptions.h
(7.08 KB)
📄
docmain.h
(7.46 KB)
📄
dtfmtsym.h
(38.21 KB)
📄
dtintrv.h
(3.84 KB)
📄
dtitvfmt.h
(48.87 KB)
📄
dtitvinf.h
(18.63 KB)
📄
dtptngen.h
(28.05 KB)
📄
dtrule.h
(8.66 KB)
📄
edits.h
(20.73 KB)
📄
enumset.h
(2.08 KB)
📄
errorcode.h
(4.84 KB)
📄
fieldpos.h
(8.69 KB)
📄
filteredbrk.h
(5.37 KB)
📄
fmtable.h
(24.36 KB)
📄
format.h
(12.5 KB)
📄
formattednumber.h
(6.28 KB)
📄
formattedvalue.h
(9.75 KB)
📄
fpositer.h
(3.03 KB)
📄
gender.h
(3.35 KB)
📄
gregocal.h
(30.3 KB)
📄
icudataver.h
(1.02 KB)
📄
icuplug.h
(12.1 KB)
📄
idna.h
(12.71 KB)
📄
listformatter.h
(8.59 KB)
📄
localebuilder.h
(11.08 KB)
📄
localematcher.h
(26.86 KB)
📄
localpointer.h
(19.55 KB)
📄
locdspnm.h
(7.12 KB)
📄
locid.h
(48.31 KB)
📄
measfmt.h
(11.41 KB)
📄
measunit.h
(108.23 KB)
📄
measure.h
(4.68 KB)
📄
messageformat2.h
(18.13 KB)
📄
messageformat2_arguments.h
(4.3 KB)
📄
messageformat2_data_model.h
(123 KB)
📄
messageformat2_data_model_names.h
(784 B)
📄
messageformat2_formattable.h
(38.29 KB)
📄
messageformat2_function_registry.h
(18 KB)
📄
messagepattern.h
(33.72 KB)
📄
msgfmt.h
(44.2 KB)
📄
normalizer2.h
(34.73 KB)
📄
normlzr.h
(30.79 KB)
📄
nounit.h
(2.24 KB)
📄
numberformatter.h
(90.74 KB)
📄
numberrangeformatter.h
(26.05 KB)
📄
numfmt.h
(50.16 KB)
📄
numsys.h
(7.22 KB)
📄
parseerr.h
(3.08 KB)
📄
parsepos.h
(5.56 KB)
📄
platform.h
(26.66 KB)
📄
plurfmt.h
(25.07 KB)
📄
plurrule.h
(20.63 KB)
📄
ptypes.h
(2.16 KB)
📄
putil.h
(6.32 KB)
📄
rbbi.h
(32.04 KB)
📄
rbnf.h
(50.53 KB)
📄
rbtz.h
(15.75 KB)
📄
regex.h
(84.45 KB)
📄
region.h
(9.2 KB)
📄
reldatefmt.h
(22.36 KB)
📄
rep.h
(9.38 KB)
📄
resbund.h
(18.03 KB)
📄
schriter.h
(6.09 KB)
📄
scientificnumberformatter.h
(6.44 KB)
📄
search.h
(22.21 KB)
📄
selfmt.h
(14.35 KB)
📄
simpleformatter.h
(12.58 KB)
📄
simplenumberformatter.h
(9.18 KB)
📄
simpletz.h
(45.62 KB)
📄
smpdtfmt.h
(57.06 KB)
📄
sortkey.h
(11.12 KB)
📄
std_string.h
(1.05 KB)
📄
strenum.h
(9.96 KB)
📄
stringoptions.h
(5.79 KB)
📄
stringpiece.h
(10.02 KB)
📄
stringtriebuilder.h
(15.5 KB)
📄
stsearch.h
(21.43 KB)
📄
symtable.h
(4.28 KB)
📄
tblcoll.h
(36.93 KB)
📄
timezone.h
(45.64 KB)
📄
tmunit.h
(3.4 KB)
📄
tmutamt.h
(4.9 KB)
📄
tmutfmt.h
(7.42 KB)
📄
translit.h
(65.8 KB)
📄
tzfmt.h
(42.95 KB)
📄
tznames.h
(16.85 KB)
📄
tzrule.h
(34.81 KB)
📄
tztrans.h
(6.11 KB)
📄
ubidi.h
(89.61 KB)
📄
ubiditransform.h
(12.71 KB)
📄
ubrk.h
(24.43 KB)
📄
ucal.h
(64.01 KB)
📄
ucasemap.h
(15.21 KB)
📄
ucat.h
(5.35 KB)
📄
uchar.h
(150.13 KB)
📄
ucharstrie.h
(22.56 KB)
📄
ucharstriebuilder.h
(7.48 KB)
📄
uchriter.h
(13.24 KB)
📄
uclean.h
(11.21 KB)
📄
ucnv.h
(83.34 KB)
📄
ucnv_cb.h
(6.58 KB)
📄
ucnv_err.h
(20.98 KB)
📄
ucnvsel.h
(6.24 KB)
📄
ucol.h
(62.7 KB)
📄
ucoleitr.h
(9.82 KB)
📄
uconfig.h
(12.56 KB)
📄
ucpmap.h
(5.54 KB)
📄
ucptrie.h
(22.51 KB)
📄
ucsdet.h
(14.69 KB)
📄
ucurr.h
(16.72 KB)
📄
udat.h
(62.36 KB)
📄
udata.h
(15.63 KB)
📄
udateintervalformat.h
(11.93 KB)
📄
udatpg.h
(30.13 KB)
📄
udisplaycontext.h
(5.94 KB)
📄
udisplayoptions.h
(8.86 KB)
📄
uenum.h
(7.79 KB)
📄
ufieldpositer.h
(4.41 KB)
📄
uformattable.h
(10.97 KB)
📄
uformattednumber.h
(8.09 KB)
📄
uformattedvalue.h
(12.25 KB)
📄
ugender.h
(2.06 KB)
📄
uidna.h
(33.43 KB)
📄
uiter.h
(22.75 KB)
📄
uldnames.h
(10.48 KB)
📄
ulistformatter.h
(10.78 KB)
📄
uloc.h
(55.38 KB)
📄
ulocale.h
(6.35 KB)
📄
ulocbuilder.h
(16.73 KB)
📄
ulocdata.h
(11.3 KB)
📄
umachine.h
(14.59 KB)
📄
umisc.h
(1.34 KB)
📄
umsg.h
(24.25 KB)
📄
umutablecptrie.h
(8.3 KB)
📄
unifilt.h
(4 KB)
📄
unifunct.h
(4.05 KB)
📄
unimatch.h
(6.1 KB)
📄
unirepl.h
(3.38 KB)
📄
uniset.h
(66.82 KB)
📄
unistr.h
(171.33 KB)
📄
unorm.h
(20.55 KB)
📄
unorm2.h
(25.71 KB)
📄
unum.h
(55.16 KB)
📄
unumberformatter.h
(19.68 KB)
📄
unumberoptions.h
(5.23 KB)
📄
unumberrangeformatter.h
(15.35 KB)
📄
unumsys.h
(7.26 KB)
📄
uobject.h
(10.66 KB)
📄
upluralrules.h
(8.79 KB)
📄
uregex.h
(71.99 KB)
📄
uregion.h
(9.81 KB)
📄
ureldatefmt.h
(16.98 KB)
📄
urename.h
(141.31 KB)
📄
urep.h
(5.38 KB)
📄
ures.h
(36.65 KB)
📄
uscript.h
(27.89 KB)
📄
usearch.h
(39.21 KB)
📄
uset.h
(45.56 KB)
📄
usetiter.h
(9.63 KB)
📄
ushape.h
(18 KB)
📄
usimplenumberformatter.h
(7.63 KB)
📄
uspoof.h
(80.32 KB)
📄
usprep.h
(8.19 KB)
📄
ustdio.h
(38.56 KB)
📄
ustream.h
(1.89 KB)
📄
ustring.h
(72.13 KB)
📄
ustringtrie.h
(3.15 KB)
📄
utext.h
(58.1 KB)
📄
utf.h
(7.87 KB)
📄
utf16.h
(23.35 KB)
📄
utf32.h
(763 B)
📄
utf8.h
(30.83 KB)
📄
utf_old.h
(45.8 KB)
📄
utmscale.h
(13.78 KB)
📄
utrace.h
(17.18 KB)
📄
utrans.h
(25.54 KB)
📄
utypes.h
(33.71 KB)
📄
uvernum.h
(6.33 KB)
📄
uversion.h
(5.99 KB)
📄
vtzone.h
(20.68 KB)
Editing: messageformat2.h
// © 2024 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html #include "unicode/utypes.h" #ifndef MESSAGEFORMAT2_H #define MESSAGEFORMAT2_H #if U_SHOW_CPLUSPLUS_API #if !UCONFIG_NO_FORMATTING #if !UCONFIG_NO_MF2 /** * \file * \brief C++ API: Formats messages using the draft MessageFormat 2.0. */ #include "unicode/messageformat2_arguments.h" #include "unicode/messageformat2_data_model.h" #include "unicode/messageformat2_function_registry.h" #include "unicode/unistr.h" #ifndef U_HIDE_DEPRECATED_API U_NAMESPACE_BEGIN namespace message2 { class Environment; class MessageContext; class ResolvedSelector; class StaticErrors; /** * <p>MessageFormatter is a Technical Preview API implementing MessageFormat 2.0. * * <p>See <a target="github" href="https://github.com/unicode-org/message-format-wg/blob/main/spec/syntax.md">the * description of the syntax with examples and use cases</a> and the corresponding * <a target="github" href="https://github.com/unicode-org/message-format-wg/blob/main/spec/message.abnf">ABNF</a> grammar.</p> * * The MessageFormatter class is mutable and movable. It is not copyable. * (It is mutable because if it has a custom function registry, the registry may include * `FormatterFactory` objects implementing custom formatters, which are allowed to contain * mutable state.) * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ class U_I18N_API MessageFormatter : public UObject { // Note: This class does not currently inherit from the existing // `Format` class. public: /** * Move assignment operator: * The source MessageFormatter will be left in a valid but undefined state. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ MessageFormatter& operator=(MessageFormatter&&) noexcept; /** * Destructor. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ virtual ~MessageFormatter(); /** * Formats the message to a string, using the data model that was previously set or parsed, * and the given `arguments` object. * * @param arguments Reference to message arguments * @param status Input/output error code used to indicate syntax errors, data model * errors, resolution errors, formatting errors, selection errors, as well * as other errors (such as memory allocation failures). Partial output * is still provided in the presence of most error types. * @return The string result of formatting the message with the given arguments. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ UnicodeString formatToString(const MessageArguments& arguments, UErrorCode &status); /** * Not yet implemented; formats the message to a `FormattedMessage` object, * using the data model that was previously set or parsed, * and the given `arguments` object. * * @param arguments Reference to message arguments * @param status Input/output error code used to indicate syntax errors, data model * errors, resolution errors, formatting errors, selection errors, as well * as other errors (such as memory allocation failures). Partial output * is still provided in the presence of most error types. * @return The `FormattedMessage` representing the formatted message. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ FormattedMessage format(const MessageArguments& arguments, UErrorCode &status) const { (void) arguments; if (U_SUCCESS(status)) { status = U_UNSUPPORTED_ERROR; } return FormattedMessage(status); } /** * Accesses the locale that this `MessageFormatter` object was created with. * * @return A reference to the locale. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ const Locale& getLocale() const { return locale; } /** * Serializes the data model as a string in MessageFormat 2.0 syntax. * * @return result A string representation of the data model. * The string is a valid MessageFormat 2.0 message. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ UnicodeString getPattern() const; /** * Accesses the data model referred to by this * `MessageFormatter` object. * * @return A reference to the data model. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ const MFDataModel& getDataModel() const; /** * The mutable Builder class allows each part of the MessageFormatter to be initialized * separately; calling its `build()` method yields an immutable MessageFormatter. * * Not copyable or movable. */ class U_I18N_API Builder : public UObject { private: friend class MessageFormatter; // The pattern to be parsed to generate the formatted message UnicodeString pattern; bool hasPattern = false; bool hasDataModel = false; // The data model to be used to generate the formatted message // Initialized either by `setDataModel()`, or by the parser // through a call to `setPattern()` MFDataModel dataModel; // Normalized representation of the pattern; // ignored if `setPattern()` wasn't called UnicodeString normalizedInput; // Errors (internal representation of parse errors) // Ignored if `setPattern()` wasn't called StaticErrors* errors; Locale locale; // Not owned const MFFunctionRegistry* customMFFunctionRegistry; public: /** * Sets the locale to use for formatting. * * @param locale The desired locale. * @return A reference to the builder. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ Builder& setLocale(const Locale& locale); /** * Sets the pattern (contents of the message) and parses it * into a data model. If a data model was * previously set, it is removed. * * @param pattern A string in MessageFormat 2.0 syntax. * @param parseError Struct to receive information on the position * of an error within the pattern. * @param status Input/output error code. If the * pattern cannot be parsed, set to failure code. * @return A reference to the builder. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ Builder& setPattern(const UnicodeString& pattern, UParseError& parseError, UErrorCode& status); /** * Sets a custom function registry. * * @param functionRegistry Reference to the function registry to use. * `functionRegistry` is not copied, * and the caller must ensure its lifetime contains * the lifetime of the `MessageFormatter` object built by this * builder. * @return A reference to the builder. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ Builder& setFunctionRegistry(const MFFunctionRegistry& functionRegistry); /** * Sets a data model. If a pattern was previously set, it is removed. * * @param dataModel Data model to format. Passed by move. * @return A reference to the builder. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ Builder& setDataModel(MFDataModel&& dataModel); /** * Constructs a new immutable MessageFormatter using the pattern or data model * that was previously set, and the locale (if it was previously set) * or default locale (otherwise). * * The builder object (`this`) can still be used after calling `build()`. * * @param status Input/output error code. If neither the pattern * nor the data model is set, set to failure code. * @return The new MessageFormatter object * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ MessageFormatter build(UErrorCode& status) const; /** * Default constructor. * Returns a Builder with the default locale and with no * data model or pattern set. Either `setPattern()` * or `setDataModel()` has to be called before calling `build()`. * * @param status Input/output error code. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ Builder(UErrorCode& status); /** * Destructor. * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ virtual ~Builder(); }; // class MessageFormatter::Builder // TODO: Shouldn't be public; only used for testing /** * Returns a string consisting of the input with optional spaces removed. * * @return A normalized string representation of the input * * @internal ICU 75 technology preview * @deprecated This API is for technology preview only. */ const UnicodeString& getNormalizedPattern() const { return normalizedInput; } private: friend class Builder; friend class MessageContext; MessageFormatter(const MessageFormatter::Builder& builder, UErrorCode &status); MessageFormatter() = delete; // default constructor not implemented // Do not define default assignment operator const MessageFormatter &operator=(const MessageFormatter &) = delete; ResolvedSelector resolveVariables(const Environment& env, const data_model::Operand&, MessageContext&, UErrorCode &) const; ResolvedSelector resolveVariables(const Environment& env, const data_model::Expression&, MessageContext&, UErrorCode &) const; // Selection methods // Takes a vector of FormattedPlaceholders void resolveSelectors(MessageContext&, const Environment& env, UErrorCode&, UVector&) const; // Takes a vector of vectors of strings (input) and a vector of PrioritizedVariants (output) void filterVariants(const UVector&, UVector&, UErrorCode&) const; // Takes a vector of vectors of strings (input) and a vector of PrioritizedVariants (input/output) void sortVariants(const UVector&, UVector&, UErrorCode&) const; // Takes a vector of strings (input) and a vector of strings (output) void matchSelectorKeys(const UVector&, MessageContext&, ResolvedSelector&& rv, UVector&, UErrorCode&) const; // Takes a vector of FormattedPlaceholders (input), // and a vector of vectors of strings (output) void resolvePreferences(MessageContext&, UVector&, UVector&, UErrorCode&) const; // Formatting methods [[nodiscard]] FormattedPlaceholder formatLiteral(const data_model::Literal&) const; void formatPattern(MessageContext&, const Environment&, const data_model::Pattern&, UErrorCode&, UnicodeString&) const; // Formats a call to a formatting function // Dispatches on argument type [[nodiscard]] FormattedPlaceholder evalFormatterCall(FormattedPlaceholder&& argument, MessageContext& context, UErrorCode& status) const; // Dispatches on function name [[nodiscard]] FormattedPlaceholder evalFormatterCall(const FunctionName& functionName, FormattedPlaceholder&& argument, FunctionOptions&& options, MessageContext& context, UErrorCode& status) const; // Formats an expression that appears as a selector ResolvedSelector formatSelectorExpression(const Environment& env, const data_model::Expression&, MessageContext&, UErrorCode&) const; // Formats an expression that appears in a pattern or as the definition of a local variable [[nodiscard]] FormattedPlaceholder formatExpression(const Environment&, const data_model::Expression&, MessageContext&, UErrorCode&) const; [[nodiscard]] FunctionOptions resolveOptions(const Environment& env, const OptionMap&, MessageContext&, UErrorCode&) const; [[nodiscard]] FormattedPlaceholder formatOperand(const Environment&, const data_model::Operand&, MessageContext&, UErrorCode&) const; [[nodiscard]] FormattedPlaceholder evalArgument(const data_model::VariableName&, MessageContext&, UErrorCode&) const; void formatSelectors(MessageContext& context, const Environment& env, UErrorCode &status, UnicodeString& result) const; // Function registry methods bool hasCustomMFFunctionRegistry() const { return (customMFFunctionRegistry != nullptr); } // Precondition: custom function registry exists // Note: this is non-const because the values in the MFFunctionRegistry are mutable // (a FormatterFactory can have mutable state) const MFFunctionRegistry& getCustomMFFunctionRegistry() const; bool isCustomFormatter(const FunctionName&) const; FormatterFactory* lookupFormatterFactory(const FunctionName&, UErrorCode& status) const; bool isBuiltInSelector(const FunctionName&) const; bool isBuiltInFormatter(const FunctionName&) const; bool isCustomSelector(const FunctionName&) const; const SelectorFactory* lookupSelectorFactory(MessageContext&, const FunctionName&, UErrorCode&) const; bool isSelector(const FunctionName& fn) const { return isBuiltInSelector(fn) || isCustomSelector(fn); } bool isFormatter(const FunctionName& fn) const { return isBuiltInFormatter(fn) || isCustomFormatter(fn); } const Formatter* lookupFormatter(const FunctionName&, UErrorCode&) const; Selector* getSelector(MessageContext&, const FunctionName&, UErrorCode&) const; Formatter* getFormatter(const FunctionName&, UErrorCode&) const; bool getDefaultFormatterNameByType(const UnicodeString&, FunctionName&) const; // Checking for resolution errors void checkDeclarations(MessageContext&, Environment*&, UErrorCode&) const; void check(MessageContext&, const Environment&, const data_model::Expression&, UErrorCode&) const; void check(MessageContext&, const Environment&, const data_model::Operand&, UErrorCode&) const; void check(MessageContext&, const Environment&, const OptionMap&, UErrorCode&) const; void initErrors(UErrorCode&); void clearErrors() const; void cleanup() noexcept; // The locale this MessageFormatter was created with /* const */ Locale locale; // Registry for built-in functions MFFunctionRegistry standardMFFunctionRegistry; // Registry for custom functions; may be null if no custom registry supplied // Note: this is *not* owned by the MessageFormatter object // The reason for this choice is to have a non-destructive MessageFormatter::Builder, // while also not requiring the function registry to be deeply-copyable. Making the // function registry copyable would impose a requirement on any implementations // of the FormatterFactory and SelectorFactory interfaces to implement a custom // clone() method, which is necessary to avoid sharing between copies of the // function registry (and thus double-frees) // Not deeply immutable (the values in the function registry are mutable, // as a FormatterFactory can have mutable state const MFFunctionRegistry* customMFFunctionRegistry; // Data model, representing the parsed message MFDataModel dataModel; // Normalized version of the input string (optional whitespace removed) UnicodeString normalizedInput; // Errors -- only used while parsing and checking for data model errors; then // the MessageContext keeps track of errors // Must be a raw pointer to avoid including the internal header file // defining StaticErrors // Owned by `this` StaticErrors* errors; }; // class MessageFormatter } // namespace message2 U_NAMESPACE_END #endif // U_HIDE_DEPRECATED_API #endif /* #if !UCONFIG_NO_MF2 */ #endif /* #if !UCONFIG_NO_FORMATTING */ #endif /* U_SHOW_CPLUSPLUS_API */ #endif // MESSAGEFORMAT2_H // eof
Upload File
Create Folder