#include <rbbi.h>
Inheritance diagram for RuleBasedBreakIterator:
Public Member Functions | |
RuleBasedBreakIterator () | |
Default constructor. | |
RuleBasedBreakIterator (const RuleBasedBreakIterator &that) | |
Copy constructor. | |
RuleBasedBreakIterator (const UnicodeString &rules, UParseError &parseError, UErrorCode &status) | |
Construct a RuleBasedBreakIterator from a set of rules supplied as a string. | |
RuleBasedBreakIterator (UDataMemory *image, UErrorCode &status) | |
This constructor uses the udata interface to create a BreakIterator whose internal tables live in a memory-mapped file. | |
virtual | ~RuleBasedBreakIterator () |
Destructor. | |
RuleBasedBreakIterator & | operator= (const RuleBasedBreakIterator &that) |
Assignment operator. | |
virtual UBool | operator== (const BreakIterator &that) const |
Equality operator. | |
UBool | operator!= (const BreakIterator &that) const |
Not-equal operator. | |
virtual BreakIterator * | clone () const |
Returns a newly-constructed RuleBasedBreakIterator with the same behavior, and iterating over the same text, as this one. | |
virtual int32_t | hashCode (void) const |
Compute a hash code for this BreakIterator. | |
virtual const UnicodeString & | getRules (void) const |
Returns the description used to create this iterator. | |
virtual const CharacterIterator & | getText (void) const |
Return a CharacterIterator over the text being analyzed. | |
virtual UText * | getUText (UText *fillIn, UErrorCode &status) const |
Get a UText for the text being analyzed. | |
virtual void | adoptText (CharacterIterator *newText) |
Set the iterator to analyze a new piece of text. | |
virtual void | setText (const UnicodeString &newText) |
Set the iterator to analyze a new piece of text. | |
virtual void | setText (UText *text, UErrorCode &status) |
Reset the break iterator to operate over the text represented by the UText. | |
virtual int32_t | first (void) |
Sets the current iteration position to the beginning of the text. | |
virtual int32_t | last (void) |
Sets the current iteration position to the end of the text. | |
virtual int32_t | next (int32_t n) |
Advances the iterator either forward or backward the specified number of steps. | |
virtual int32_t | next (void) |
Advances the iterator to the next boundary position. | |
virtual int32_t | previous (void) |
Moves the iterator backwards, to the last boundary preceding this one. | |
virtual int32_t | following (int32_t offset) |
Sets the iterator to refer to the first boundary position following the specified position. | |
virtual int32_t | preceding (int32_t offset) |
Sets the iterator to refer to the last boundary position before the specified position. | |
virtual UBool | isBoundary (int32_t offset) |
Returns true if the specfied position is a boundary position. | |
virtual int32_t | current (void) const |
Returns the current iteration position. | |
virtual int32_t | getRuleStatus () const |
Return the status tag from the break rule that determined the most recently returned break position. | |
virtual int32_t | getRuleStatusVec (int32_t *fillInVec, int32_t capacity, UErrorCode &status) |
Get the status (tag) values from the break rule(s) that determined the most recently returned break position. | |
virtual UClassID | getDynamicClassID (void) const |
Returns a unique class ID POLYMORPHICALLY. | |
virtual BreakIterator * | createBufferClone (void *stackBuffer, int32_t &BufferSize, UErrorCode &status) |
Thread safe client-buffer-based cloning operation Do NOT call delete on a safeclone, since 'new' is not used to create it. | |
virtual const uint8_t * | getBinaryRules (uint32_t &length) |
Return the binary form of compiled break rules, which can then be used to create a new break iterator at some time in the future. | |
Static Public Member Functions | |
static UClassID | getStaticClassID (void) |
Returns the class ID for this class. | |
Protected Member Functions | |
RuleBasedBreakIterator (RBBIDataHeader *data, UErrorCode &status) | |
Constructor from a flattened set of RBBI data in malloced memory. | |
virtual int32_t | handleNext (void) |
This method is the actual implementation of the next() method. | |
virtual int32_t | handlePrevious (void) |
This method backs the iterator back up to a "safe position" in the text. | |
virtual void | reset (void) |
Dumps caches and performs other actions associated with a complete change in text or iteration position. | |
virtual UBool | isDictionaryChar (UChar32) |
Return true if the category lookup for this char indicates that it is in the set of dictionary lookup chars. | |
void | init () |
Common initialization function, used by constructors and bufferClone. | |
Protected Attributes | |
CharacterIterator * | fText |
The character iterator through which this BreakIterator accesses the text. | |
RBBIDataWrapper * | fData |
The rule data for this BreakIterator instance. | |
int32_t | fLastRuleStatusIndex |
Index of the Rule {tag} values for the most recent match. | |
UBool | fLastStatusIndexValid |
Rule tag value valid flag. | |
uint32_t | fDictionaryCharCount |
Counter for the number of characters encountered with the "dictionary" flag set. | |
Static Protected Attributes | |
static UBool | fTrace |
Debugging flag. | |
Friends | |
class | RBBIRuleBuilder |
class | BreakIterator |
Instances of this class are most commonly created by the factory methods of BreakIterator::createWordInstance(), BreakIterator::createLineInstance(), etc., and then used via the abstract API in class BreakIterator
See the ICU User Guide for information on Break Iterator Rules.
This class is not intended to be subclassed. (Class DictionaryBasedBreakIterator is a subclass, but that relationship is effectively internal to the ICU implementation. The subclassing interface to RulesBasedBreakIterator is not part of the ICU API, and may not remain stable.
Definition at line 59 of file rbbi.h.
|
Constructor from a flattened set of RBBI data in malloced memory. RulesBasedBreakIterators built from a custom set of rules are created via this constructor; the rules are compiled into memory, then the break iterator is constructed here. The break iterator adopts the memory, and will free it when done.
|
|
Default constructor. Creates an empty shell of an iterator, with no rules or text to iterate over. Object can subsequently be assigned to.
|
|
Copy constructor. Will produce a break iterator with the same behavior, and which iterates over the same text, as the one passed in.
|
|
Construct a RuleBasedBreakIterator from a set of rules supplied as a string.
|
|
This constructor uses the udata interface to create a BreakIterator whose internal tables live in a memory-mapped file. "image" is an ICU UDataMemory handle for the pre-compiled break iterator tables.
|
|
Destructor.
|
|
Set the iterator to analyze a new piece of text. This function resets the current iteration position to the beginning of the text.
Implements BreakIterator. |
|
Returns a newly-constructed RuleBasedBreakIterator with the same behavior, and iterating over the same text, as this one. Differs from the copy constructor in that it is polymorphic, and will correctly clone (copy) a derived class. clone() is thread safe. Multiple threads may simultaeneously clone the same source break iterator.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Thread safe client-buffer-based cloning operation Do NOT call delete on a safeclone, since 'new' is not used to create it.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Returns the current iteration position.
Implements BreakIterator. |
|
Sets the current iteration position to the beginning of the text. (i.e., the CharacterIterator's starting offset).
Implements BreakIterator. |
|
Sets the iterator to refer to the first boundary position following the specified position.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Return the binary form of compiled break rules, which can then be used to create a new break iterator at some time in the future. Creating a break iterator from pre-compiled rules is much faster than building one from the source form of the break rules. The binary data can only be used with the same version of ICU and on the same platform type (processor endian-ness)
|
|
Returns a unique class ID POLYMORPHICALLY. Pure virtual override. This method is to implement a simple version of RTTI, since not all C++ compilers support genuine RTTI. Polymorphic operator==() and clone() methods call this method.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Returns the description used to create this iterator.
|
|
Return the status tag from the break rule that determined the most recently returned break position. For break rules that do not specify a status, a default value of 0 is returned. If more than one break rule would cause a boundary to be located at some position in the text, the numerically largest of the applicable status values is returned. Of the standard types of ICU break iterators, only word break and line break provide status values. The values are defined in the header file ubrk.h. For Word breaks, the status allows distinguishing between words that contain alphabetic letters, "words" that appear to be numbers, punctuation and spaces, words containing ideographic characters, and more. For Line Break, the status distinguishes between hard (mandatory) breaks and soft (potential) break positions.
When creating custom break rules, one is free to define whatever status values may be convenient for the application. Note: this function is not thread safe. It should not have been declared const, and the const remains only for compatibility reasons. (The function is logically const, but not bit-wise const).
|
|
Get the status (tag) values from the break rule(s) that determined the most recently returned break position. The returned status value(s) are stored into an array provided by the caller. The values are stored in sorted (ascending) order. If the capacity of the output array is insufficient to hold the data, the output will be truncated to the available length, and a U_BUFFER_OVERFLOW_ERROR will be signaled.
|
|
Returns the class ID for this class. This is useful only for comparing to a return value from getDynamicClassID(). For example: Base* polymorphic_pointer = createPolymorphicObject(); if (polymorphic_pointer->getDynamicClassID() == Derived::getStaticClassID()) ...
Reimplemented in DictionaryBasedBreakIterator. |
|
Return a CharacterIterator over the text being analyzed. This version of this method returns the actual CharacterIterator we're using internally. Changing the state of this iterator can have undefined consequences. If you need to change it, clone it first.
Implements BreakIterator. |
|
Get a UText for the text being analyzed. The returned UText is a shallow clone of the UText used internally by the break iterator implementation. It can safely be used to access the text without impacting any break iterator operations, but the underlying text itself must not be altered.
Implements BreakIterator. |
|
This method is the actual implementation of the next() method. All iteration vectors through here. This method initializes the state machine to state 1 and advances through the text character by character until we reach the end of the text or the state machine transitions to state 0. We update our return value every time the state machine passes through a possible end state.
Reimplemented in DictionaryBasedBreakIterator. |
|
This method backs the iterator back up to a "safe position" in the text. This is a position that we know, without any context, must be a break position. The various calling methods then iterate forward from this safe position to the appropriate position to return. (For more information, see the description of buildBackwardsStateTable() in RuleBasedBreakIterator.Builder.)
|
|
Compute a hash code for this BreakIterator.
|
|
Common initialization function, used by constructors and bufferClone. (Also used by DictionaryBasedBreakIterator::createBufferClone().)
Reimplemented in DictionaryBasedBreakIterator. |
|
Returns true if the specfied position is a boundary position. As a side effect, leaves the iterator pointing to the first boundary position at or after "offset".
Implements BreakIterator. |
|
Return true if the category lookup for this char indicates that it is in the set of dictionary lookup chars. This function is intended for use by dictionary based break iterators.
|
|
Sets the current iteration position to the end of the text. (i.e., the CharacterIterator's ending offset).
Implements BreakIterator. |
|
Advances the iterator to the next boundary position.
Implements BreakIterator. |
|
Advances the iterator either forward or backward the specified number of steps. Negative values move backward, and positive values move forward. This is equivalent to repeatedly calling next() or previous().
Implements BreakIterator. |
|
Not-equal operator. If operator== returns TRUE, this returns FALSE, and vice versa.
Reimplemented from BreakIterator. Definition at line 591 of file rbbi.h. References operator==(). |
|
Assignment operator. Sets this iterator to have the same behavior, and iterate over the same text, as the one passed in.
|
|
Equality operator. Returns TRUE if both BreakIterators are of the same class, have the same behavior, and iterate over the same text.
Implements BreakIterator. Referenced by operator!=(). |
|
Sets the iterator to refer to the last boundary position before the specified position.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Moves the iterator backwards, to the last boundary preceding this one.
Implements BreakIterator. Reimplemented in DictionaryBasedBreakIterator. |
|
Dumps caches and performs other actions associated with a complete change in text or iteration position. This function is a no-op in RuleBasedBreakIterator, but subclasses can and do override it.
Reimplemented in DictionaryBasedBreakIterator. |
|
Reset the break iterator to operate over the text represented by the UText. The iterator position is reset to the start. This function makes a shallow clone of the supplied UText. This means that the caller is free to immediately close or otherwise reuse the Utext that was passed as a parameter, but that the underlying text itself must not be altered while being referenced by the break iterator.
Implements BreakIterator. |
|
Set the iterator to analyze a new piece of text. This function resets the current iteration position to the beginning of the text.
Implements BreakIterator. |
|
Reimplemented in DictionaryBasedBreakIterator. |
|
|
|
The rule data for this BreakIterator instance.
|
|
Counter for the number of characters encountered with the "dictionary" flag set. Normal RBBI iterators don't use it, although the code for updating it is live. Dictionary Based break iterators (a subclass of us) access this field directly.
|
|
Index of the Rule {tag} values for the most recent match.
|
|
Rule tag value valid flag. Some iterator operations don't intrinsically set the correct tag value. This flag lets us lazily compute the value if we are ever asked for it.
|
|
The character iterator through which this BreakIterator accesses the text.
|
|
Debugging flag. Trace operation of state machine when true.
|