UniCreateAttrObject allocates resources associated with an attribute defined in the LC_CTYPE category of the locale indicated by the locale_object argument.

The locale_object argument specifies a locale object handle returned by UniCreateLocaleObject. It should not be a NULL pointer.

The AttrName argument specifies the attribute names for which an attribute object handle should be created. Multiple attribute names are specified as a string of space-separated names.

When UniCreateAttrObject completes without errors, the attr_object argument specifies a valid pointer to an attribute object.

The attribute object pointer should be used in all subsequent calls to the UniQueryCharAttr. If the function result is other than ULS_SUCCESS, the contents of the area pointed to by attr_object are undefined.

The following attribute names have their defined meaning in all locales:

alnum

True when alpha or digit is true.
alpha
True when upper or lower is true, or when none of cntrl, digit, punct, or space is true.
blank
True for the characters space and horizontal tab.
character
Code element 0x0020.
cntrl
True for any control character; the following attributes must be false: upper, lower, alpha, digit, xdigit, graph, print, and punct.
digit
True for the digits 0, 1, 2 3, 4, 5, 6, 7, 8, and 9.
graph
True for any character with the print attribute, except the space.
lower
True for any character that is a lowercase letter and none of cntrl, digit, punct, or space is true.
print
True for upper, lower, alpha, digit, xdigit, punct, or any printing character including the space character (code element 0x0020).
punct
True for any printing character that is neither the space character (code element 0x0020) nor a character for which alnum is true.
space
True for any character that corresponds to a standard white-space character or is one of the set of white-space characters in the locale as indicated by the locale_object argument for which alnum is false. The standard white-space characters are the following: space, form feed, newline, carriage return, horizontal tab, and vertical tab.
upper
True for any character that is an uppercase letter and none of cntrl, digit, punct, or space is true.
xdigit
True for 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E F, a, b, c, d, e, and f.

In addition to the above attribute names, other attribute names in the locale (including user-defined attributes) may be passed to UniCreateAttrObject through the AttrName argument. To obtain a successful return, the attribute name must be defined in locale_object.

---

[Back: UniCreateAttrObject - Parameters]
[Next: UniCreateAttrObject - Related Functions]