ICU 63.1  63.1
chariter.h
Go to the documentation of this file.
1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 ********************************************************************
5 *
6 * Copyright (C) 1997-2011, International Business Machines
7 * Corporation and others. All Rights Reserved.
8 *
9 ********************************************************************
10 */
11 
12 #ifndef CHARITER_H
13 #define CHARITER_H
14 
15 #include "unicode/utypes.h"
16 #include "unicode/uobject.h"
17 #include "unicode/unistr.h"
92 public:
98  enum { DONE = 0xffff };
99 
105 
114  virtual UBool operator==(const ForwardCharacterIterator& that) const = 0;
115 
126  inline UBool operator!=(const ForwardCharacterIterator& that) const;
127 
133  virtual int32_t hashCode(void) const = 0;
134 
142  virtual UClassID getDynamicClassID(void) const = 0;
143 
152  virtual char16_t nextPostInc(void) = 0;
153 
162  virtual UChar32 next32PostInc(void) = 0;
163 
173  virtual UBool hasNext() = 0;
174 
175 protected:
178 
181 
187 };
188 
359 public:
364  enum EOrigin { kStart, kCurrent, kEnd };
365 
371 
380  virtual CharacterIterator* clone(void) const = 0;
381 
389  virtual char16_t first(void) = 0;
390 
399  virtual char16_t firstPostInc(void);
400 
410  virtual UChar32 first32(void) = 0;
411 
420  virtual UChar32 first32PostInc(void);
421 
429  inline int32_t setToStart();
430 
438  virtual char16_t last(void) = 0;
439 
447  virtual UChar32 last32(void) = 0;
448 
456  inline int32_t setToEnd();
457 
466  virtual char16_t setIndex(int32_t position) = 0;
467 
479  virtual UChar32 setIndex32(int32_t position) = 0;
480 
486  virtual char16_t current(void) const = 0;
487 
493  virtual UChar32 current32(void) const = 0;
494 
502  virtual char16_t next(void) = 0;
503 
514  virtual UChar32 next32(void) = 0;
515 
523  virtual char16_t previous(void) = 0;
524 
532  virtual UChar32 previous32(void) = 0;
533 
543  virtual UBool hasPrevious() = 0;
544 
555  inline int32_t startIndex(void) const;
556 
566  inline int32_t endIndex(void) const;
567 
576  inline int32_t getIndex(void) const;
577 
584  inline int32_t getLength() const;
585 
597  virtual int32_t move(int32_t delta, EOrigin origin) = 0;
598 
610 #ifdef move32
611  // One of the system headers right now is sometimes defining a conflicting macro we don't use
612 #undef move32
613 #endif
614  virtual int32_t move32(int32_t delta, EOrigin origin) = 0;
615 
622  virtual void getText(UnicodeString& result) = 0;
623 
624 protected:
630 
635  CharacterIterator(int32_t length);
636 
641  CharacterIterator(int32_t length, int32_t position);
642 
647  CharacterIterator(int32_t length, int32_t textBegin, int32_t textEnd, int32_t position);
648 
656 
665 
671  int32_t textLength;
672 
677  int32_t pos;
678 
683  int32_t begin;
684 
689  int32_t end;
690 };
691 
692 inline UBool
694  return !operator==(that);
695 }
696 
697 inline int32_t
698 CharacterIterator::setToStart() {
699  return move(0, kStart);
700 }
701 
702 inline int32_t
703 CharacterIterator::setToEnd() {
704  return move(0, kEnd);
705 }
706 
707 inline int32_t
708 CharacterIterator::startIndex(void) const {
709  return begin;
710 }
711 
712 inline int32_t
713 CharacterIterator::endIndex(void) const {
714  return end;
715 }
716 
717 inline int32_t
718 CharacterIterator::getIndex(void) const {
719  return pos;
720 }
721 
722 inline int32_t
723 CharacterIterator::getLength(void) const {
724  return textLength;
725 }
726 
728 #endif
icu::ForwardCharacterIterator::ForwardCharacterIterator
ForwardCharacterIterator()
Default constructor to be overridden in the implementing class.
icu::ForwardCharacterIterator::hasNext
virtual UBool hasNext()=0
Returns FALSE if there are no more code units or code points at or after the current position in the ...
icu::ForwardCharacterIterator::~ForwardCharacterIterator
virtual ~ForwardCharacterIterator()
Destructor.
icu::CharacterIterator::textLength
int32_t textLength
Base class text length field.
Definition: chariter.h:671
icu::CharacterIterator::clone
virtual CharacterIterator * clone(void) const =0
Returns a pointer to a new CharacterIterator of the same concrete class as this one,...
icu::CharacterIterator::begin
int32_t begin
Base class field for the start of the iteration range.
Definition: chariter.h:683
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
icu::CharacterIterator::next
virtual char16_t next(void)=0
Advances to the next code unit in the iteration range (toward endIndex()), and returns that code unit...
icu::CharacterIterator::~CharacterIterator
virtual ~CharacterIterator()
Destructor.
icu::CharacterIterator::pos
int32_t pos
Base class field for the current position.
Definition: chariter.h:677
UBool
int8_t UBool
The ICU boolean type.
Definition: umachine.h:225
icu::CharacterIterator::operator=
CharacterIterator & operator=(const CharacterIterator &that)
Assignment operator.
icu::CharacterIterator::setIndex
virtual char16_t setIndex(int32_t position)=0
Sets the iterator to refer to the "position"-th code unit in the text-storage object the iterator ref...
icu::CharacterIterator::first32PostInc
virtual UChar32 first32PostInc(void)
Sets the iterator to refer to the first code point in its iteration range, returns that code point,...
icu::CharacterIterator::current
virtual char16_t current(void) const =0
Returns the code unit the iterator currently refers to.
icu::CharacterIterator::last32
virtual UChar32 last32(void)=0
Sets the iterator to refer to the last code point in its iteration range, and returns that code unit.
icu::CharacterIterator::move32
virtual int32_t move32(int32_t delta, EOrigin origin)=0
Moves the current position relative to the start or end of the iteration range, or relative to the cu...
icu::operator==
U_EXPORT UBool operator==(const StringPiece &x, const StringPiece &y)
Global operator == for StringPiece.
icu::CharacterIterator::move
virtual int32_t move(int32_t delta, EOrigin origin)=0
Moves the current position relative to the start or end of the iteration range, or relative to the cu...
U_COMMON_API
#define U_COMMON_API
Set to export library symbols from inside the common library, and to import them from outside.
Definition: utypes.h:300
icu::ForwardCharacterIterator::operator=
ForwardCharacterIterator & operator=(const ForwardCharacterIterator &)
Assignment operator to be overridden in the implementing class.
Definition: chariter.h:186
icu::ForwardCharacterIterator::hashCode
virtual int32_t hashCode(void) const =0
Generates a hash code for this iterator.
icu::CharacterIterator::getText
virtual void getText(UnicodeString &result)=0
Copies the text under iteration into the UnicodeString referred to by "result".
icu::CharacterIterator::CharacterIterator
CharacterIterator(int32_t length)
Constructor, just setting the length field in this base class.
icu::CharacterIterator::current32
virtual UChar32 current32(void) const =0
Returns the code point the iterator currently refers to.
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:290
icu::CharacterIterator::setIndex32
virtual UChar32 setIndex32(int32_t position)=0
Sets the iterator to refer to the beginning of the code point that contains the "position"-th code un...
icu::CharacterIterator::first
virtual char16_t first(void)=0
Sets the iterator to refer to the first code unit in its iteration range, and returns that code unit.
icu::CharacterIterator::firstPostInc
virtual char16_t firstPostInc(void)
Sets the iterator to refer to the first code unit in its iteration range, returns that code unit,...
UChar32
int32_t UChar32
Define UChar32 as a type for single Unicode code points.
Definition: umachine.h:389
icu::CharacterIterator::previous32
virtual UChar32 previous32(void)=0
Advances to the previous code point in the iteration range (toward startIndex()), and returns that co...
icu::UObject
UObject is the common ICU "boilerplate" class.
Definition: uobject.h:220
UClassID
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:90
icu::CharacterIterator::CharacterIterator
CharacterIterator(const CharacterIterator &that)
Copy constructor.
icu::ForwardCharacterIterator
Abstract class that defines an API for forward-only iteration on text objects.
Definition: chariter.h:91
icu::ForwardCharacterIterator::next32PostInc
virtual UChar32 next32PostInc(void)=0
Gets the current code point for returning and advances to the next code point in the iteration range ...
icu::CharacterIterator::EOrigin
EOrigin
Origin enumeration for the move() and move32() functions.
Definition: chariter.h:364
icu::ForwardCharacterIterator::getDynamicClassID
virtual UClassID getDynamicClassID(void) const =0
Returns a UClassID for this ForwardCharacterIterator ("poor man's RTTI").
icu::operator!=
UBool operator!=(const StringPiece &x, const StringPiece &y)
Global operator != for StringPiece.
Definition: stringpiece.h:218
icu::CharacterIterator::last
virtual char16_t last(void)=0
Sets the iterator to refer to the last code unit in its iteration range, and returns that code unit.
icu::CharacterIterator::CharacterIterator
CharacterIterator(int32_t length, int32_t position)
Constructor, just setting the length and position fields in this base class.
icu::ForwardCharacterIterator::ForwardCharacterIterator
ForwardCharacterIterator(const ForwardCharacterIterator &other)
Copy constructor to be overridden in the implementing class.
icu::ForwardCharacterIterator::operator==
virtual UBool operator==(const ForwardCharacterIterator &that) const =0
Returns true when both iterators refer to the same character in the same character-storage object.
icu::CharacterIterator
Abstract class that defines an API for iteration on text objects.
Definition: chariter.h:358
icu::CharacterIterator::next32
virtual UChar32 next32(void)=0
Advances to the next code point in the iteration range (toward endIndex()), and returns that code poi...
icu::CharacterIterator::CharacterIterator
CharacterIterator()
Empty constructor.
icu::CharacterIterator::first32
virtual UChar32 first32(void)=0
Sets the iterator to refer to the first code point in its iteration range, and returns that code unit...
icu::ForwardCharacterIterator::nextPostInc
virtual char16_t nextPostInc(void)=0
Gets the current code unit for returning and advances to the next code unit in the iteration range (t...
uobject.h
C++ API: Common ICU base class UObject.
icu::CharacterIterator::CharacterIterator
CharacterIterator(int32_t length, int32_t textBegin, int32_t textEnd, int32_t position)
Constructor, just setting the length, start, end, and position fields in this base class.
icu::CharacterIterator::hasPrevious
virtual UBool hasPrevious()=0
Returns FALSE if there are no more code units or code points before the current position in the itera...
icu::CharacterIterator::previous
virtual char16_t previous(void)=0
Advances to the previous code unit in the iteration range (toward startIndex()), and returns that cod...
U_NAMESPACE_END
#define U_NAMESPACE_END
This is used to end a declaration of a public ICU C++ API.
Definition: uversion.h:138
U_NAMESPACE_BEGIN
#define U_NAMESPACE_BEGIN
This is used to begin a declaration of a public ICU C++ API.
Definition: uversion.h:137
unistr.h
C++ API: Unicode String.
icu::CharacterIterator::end
int32_t end
Base class field for the end of the iteration range.
Definition: chariter.h:689