Go to the documentation of this file.
16 #if !UCONFIG_NO_COLLATION && !UCONFIG_NO_BREAK_ITERATION
147 #define USEARCH_DONE -1
169 #ifndef U_HIDE_DEPRECATED_API
193 #ifndef U_HIDE_DEPRECATED_API
269 #ifndef U_HIDE_DEPRECATED_API
303 int32_t patternlength,
335 const UChar *pattern,
336 int32_t patternlength,
351 #if U_SHOW_CPLUSPLUS_API
498 int32_t resultCapacity,
501 #if !UCONFIG_NO_BREAK_ITERATION
607 const UChar *pattern,
608 int32_t patternlength,
767 #ifndef U_HIDE_INTERNAL_API
int32_t usearch_last(UStringSearch *strsrch, UErrorCode *status)
Returns the last index in the target text at which it matches the search pattern.
int32_t usearch_getOffset(const UStringSearch *strsrch)
Return the current index in the string text being searched.
@ USEARCH_ANY_BASE_WEIGHT_IS_WILDCARD
Value for USEARCH_ELEMENT_COMPARISON.
Basic definitions for ICU, for both C and C++ APIs.
void usearch_setCollator(UStringSearch *strsrch, const UCollator *collator, UErrorCode *status)
Sets the collator used for the language rules.
USearchAttributeValue usearch_getAttribute(const UStringSearch *strsrch, USearchAttribute attribute)
Gets the text searching attributes.
C API: UCollationElements.
@ USEARCH_ELEMENT_COMPARISON
Option to control how collation elements are compared.
int8_t UBool
The ICU boolean type.
const UBreakIterator * usearch_getBreakIterator(const UStringSearch *strsrch)
Returns the BreakIterator that is used to restrict the points at which matches are detected.
void usearch_reset(UStringSearch *strsrch)
Reset the iteration.
void usearch_setAttribute(UStringSearch *strsrch, USearchAttribute attribute, USearchAttributeValue value, UErrorCode *status)
Sets the text searching attributes located in the enum USearchAttribute with values from the enum USe...
@ USEARCH_PATTERN_BASE_WEIGHT_IS_WILDCARD
Value for USEARCH_ELEMENT_COMPARISON; collation element comparison is modified to effectively provide...
void usearch_setOffset(UStringSearch *strsrch, int32_t position, UErrorCode *status)
Sets the current position in the text string which the next search will start from.
UBool usearch_search(UStringSearch *strsrch, int32_t startIdx, int32_t *matchStart, int32_t *matchLimit, UErrorCode *status)
Simple forward search for the pattern, starting at a specified index, and using using a default set s...
@ USEARCH_OFF
Value for USEARCH_OVERLAP and USEARCH_CANONICAL_MATCH.
int32_t usearch_getMatchedStart(const UStringSearch *strsrch)
Returns the index to the match in the text string that was searched.
int32_t usearch_preceding(UStringSearch *strsrch, int32_t position, UErrorCode *status)
Returns the first index less than position at which the string text matches the search pattern.
int32_t usearch_getMatchedText(const UStringSearch *strsrch, UChar *result, int32_t resultCapacity, UErrorCode *status)
Returns the text that was matched by the most recent call to usearch_first, usearch_next,...
int32_t usearch_first(UStringSearch *strsrch, UErrorCode *status)
Returns the first index at which the string text matches the search pattern.
UCollator * usearch_getCollator(const UStringSearch *strsrch)
Gets the collator used for the language rules.
@ USEARCH_ON
Value for USEARCH_OVERLAP and USEARCH_CANONICAL_MATCH.
UBool usearch_searchBackwards(UStringSearch *strsrch, int32_t startIdx, int32_t *matchStart, int32_t *matchLimit, UErrorCode *status)
Simple backwards search for the pattern, starting at a specified index, and using using a default set...
int32_t usearch_getMatchedLength(const UStringSearch *strsrch)
Returns the length of text in the string which matches the search pattern.
UErrorCode
Error code to replace exception handling, so that the code is compatible with all C++ compilers,...
#define U_INTERNAL
This is used to declare a function as an internal ICU C API
struct UCollator UCollator
structure representing a collator object instance
void usearch_setBreakIterator(UStringSearch *strsrch, UBreakIterator *breakiter, UErrorCode *status)
Set the BreakIterator that will be used to restrict the points at which matches are detected.
@ USEARCH_CANONICAL_MATCH
Option for canonical matches; option 1 in header documentation.
void usearch_setPattern(UStringSearch *strsrch, const UChar *pattern, int32_t patternlength, UErrorCode *status)
Sets the pattern used for matching.
#define U_DEFINE_LOCAL_OPEN_POINTER(LocalPointerClassName, Type, closeFunction)
C++ API: "Smart pointers" for use with and in ICU4C C++ code.
int32_t usearch_next(UStringSearch *strsrch, UErrorCode *status)
Returns the index of the next point at which the string text matches the search pattern,...
#define U_STABLE
This is used to declare a function as a stable public ICU C API.
const UChar * usearch_getPattern(const UStringSearch *strsrch, int32_t *length)
Gets the search pattern.
struct UStringSearch UStringSearch
Data structure for searching.
struct UBreakIterator UBreakIterator
Opaque type representing an ICU Break iterator object.
@ USEARCH_STANDARD_ELEMENT_COMPARISON
Value (default) for USEARCH_ELEMENT_COMPARISON; standard collation element comparison at the specifie...
int32_t usearch_following(UStringSearch *strsrch, int32_t position, UErrorCode *status)
Returns the first index equal or greater than position at which the string text matches the search pa...
UStringSearch * usearch_open(const UChar *pattern, int32_t patternlength, const UChar *text, int32_t textlength, const char *locale, UBreakIterator *breakiter, UErrorCode *status)
Creating a search iterator data struct using the argument locale language rule set.
@ USEARCH_OVERLAP
Option for overlapping matches.
#define U_NAMESPACE_BEGIN
void usearch_setText(UStringSearch *strsrch, const UChar *text, int32_t textlength, UErrorCode *status)
Set the string text to be searched.
int32_t usearch_previous(UStringSearch *strsrch, UErrorCode *status)
Returns the index of the previous point at which the string text matches the search pattern,...
@ USEARCH_ATTRIBUTE_COUNT
One more than the highest normal USearchAttribute value.
const UChar * usearch_getText(const UStringSearch *strsrch, int32_t *length)
Return the string text to be searched.
void usearch_close(UStringSearch *searchiter)
Destroying and cleaning up the search iterator data struct.
@ USEARCH_ATTRIBUTE_VALUE_COUNT
One more than the highest normal USearchAttributeValue value.
UStringSearch * usearch_openFromCollator(const UChar *pattern, int32_t patternlength, const UChar *text, int32_t textlength, const UCollator *collator, UBreakIterator *breakiter, UErrorCode *status)
Creating a search iterator data struct using the argument collator language rule set.
@ USEARCH_DEFAULT
Default value for any USearchAttribute.