ICU4C API Proposal: Add some missing uset functions

George Rhoten <[email protected]> Tue, 8 Feb 2005 10:47:59 -0800
Newsgroups gmane.comp.lib.icu.general
Message-ID <OFE0528387.E629B136-ON86256FA2.0066C109-88256FA2.00674B97@us.ibm.com>
Deadline for comments: February 15, 2005

I'd like to add some missing uset API functions that already exist in the 
C++ UnicodeSet.  Here are the functions that I'm proposing.

/**
 * Adds each of the characters in this string to the set. Thus "ch" => 
{"c", "h"}
 * If this set already any particular character, it has no effect on that 
character.
 * @param set the object to which to add the character
 * @param str the source string
 * @param strLen the length of the string or -1 if null terminated.
 * @draft ICU 3.4
 */
U_DRAFT void U_EXPORT2
uset_addAllCodePoints(USet* set, const UChar *str, int32_t strLen);

/**
 * Returns true if this set contains all the characters
 * of the given string. This is does not check containment of grapheme
 * clusters, like uset_containsString.
 * @param set set of characters to be checked for containment
 * @param str string containing codepoints to be checked for containment
 * @param strLen the length of the string or -1 if null terminated.
 * @return true if the test condition is met
 * @draft ICU 3.4
 */
U_DRAFT UBool U_EXPORT2
uset_containsAllCodePoints(const USet* set, const UChar *str, int32_t 
strLen);

These implement the containsAll(const UnicodeString& s) and the 
addAll(const UnicodeString& s) functions of UnicodeSet.

George Rhoten
IBM Globalization Center of Competency/ICU  San José, CA, USA