ICU 76.1: common/unicode/chariter.h Source File

ICU 76.1 76.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
17#if U_SHOW_CPLUSPLUS_API
18
19#include "unicode/uobject.h"
20#include "unicode/unistr.h"
26U_NAMESPACE_BEGIN
94 class U_COMMON_API ForwardCharacterIterator : public UObject {
95public:
101 enum { DONE = 0xffff };
102
107 virtual ~ForwardCharacterIterator();
108
117 virtual bool operator==(const ForwardCharacterIterator& that) const = 0;
118
129 inline bool operator!=(const ForwardCharacterIterator& that) const;
130
136 virtual int32_t hashCode() const = 0;
137
145 virtual UClassID getDynamicClassID() const override = 0;
146
155 virtual char16_t nextPostInc() = 0;
156
165 virtual UChar32 next32PostInc() = 0;
166
176 virtual UBool hasNext() = 0;
177
178protected:
180 ForwardCharacterIterator();
181
183 ForwardCharacterIterator(const ForwardCharacterIterator &other);
184
189 ForwardCharacterIterator &operator=(const ForwardCharacterIterator&) { return *this; }
190};
191
361 class U_COMMON_API CharacterIterator : public ForwardCharacterIterator {
362public:
367 enum EOrigin { kStart, kCurrent, kEnd };
368
373 virtual ~CharacterIterator();
374
383 virtual CharacterIterator* clone() const = 0;
384
392 virtual char16_t first() = 0;
393
402 virtual char16_t firstPostInc();
403
413 virtual UChar32 first32() = 0;
414
423 virtual UChar32 first32PostInc();
424
432 inline int32_t setToStart();
433
441 virtual char16_t last() = 0;
442
450 virtual UChar32 last32() = 0;
451
459 inline int32_t setToEnd();
460
469 virtual char16_t setIndex(int32_t position) = 0;
470
482 virtual UChar32 setIndex32(int32_t position) = 0;
483
489 virtual char16_t current() const = 0;
490
496 virtual UChar32 current32() const = 0;
497
505 virtual char16_t next() = 0;
506
517 virtual UChar32 next32() = 0;
518
526 virtual char16_t previous() = 0;
527
535 virtual UChar32 previous32() = 0;
536
546 virtual UBool hasPrevious() = 0;
547
558 inline int32_t startIndex() const;
559
569 inline int32_t endIndex() const;
570
579 inline int32_t getIndex() const;
580
587 inline int32_t getLength() const;
588
600 virtual int32_t move(int32_t delta, EOrigin origin) = 0;
601
613#ifdef move32
614 // One of the system headers right now is sometimes defining a conflicting macro we don't use
615#undef move32
616#endif
617 virtual int32_t move32(int32_t delta, EOrigin origin) = 0;
618
625 virtual void getText(UnicodeString& result) = 0;
626
627protected:
632 CharacterIterator();
633
638 CharacterIterator(int32_t length);
639
644 CharacterIterator(int32_t length, int32_t position);
645
650 CharacterIterator(int32_t length, int32_t textBegin, int32_t textEnd, int32_t position);
651
658 CharacterIterator(const CharacterIterator &that);
659
667 CharacterIterator &operator=(const CharacterIterator &that);
668
674 int32_t textLength;
675
680 int32_t pos;
681
686 int32_t begin;
687
692 int32_t end;
693};
694
695inline bool
696ForwardCharacterIterator::operator!=(const ForwardCharacterIterator& that) const {
697 return !operator==(that);
698}
699
700inline int32_t
701CharacterIterator::setToStart() {
702 return move(0, kStart);
703}
704
705inline int32_t
706CharacterIterator::setToEnd() {
707 return move(0, kEnd);
708}
709
710inline int32_t
711CharacterIterator::startIndex() const {
712 return begin;
713}
714
715inline int32_t
716CharacterIterator::endIndex() const {
717 return end;
718}
719
720inline int32_t
721CharacterIterator::getIndex() const {
722 return pos;
723}
724
725inline int32_t
726CharacterIterator::getLength() const {
727 return textLength;
728}
729
730U_NAMESPACE_END
731
732#endif /* U_SHOW_CPLUSPLUS_API */
733
734#endif
icu::CharacterIterator
Abstract class that defines an API for iteration on text objects.
Definition chariter.h:361
icu::CharacterIterator::firstPostInc
virtual char16_t firstPostInc()
Sets the iterator to refer to the first code unit in its iteration range, returns that code unit,...
icu::CharacterIterator::EOrigin
EOrigin
Origin enumeration for the move() and move32() functions.
Definition chariter.h:367
icu::CharacterIterator::textLength
int32_t textLength
Base class text length field.
Definition chariter.h:674
icu::CharacterIterator::previous32
virtual UChar32 previous32()=0
Advances to the previous code point in the iteration range (toward startIndex()), and returns that co...
icu::CharacterIterator::CharacterIterator
CharacterIterator(int32_t length, int32_t position)
Constructor, just setting the length and position fields in this base class.
icu::CharacterIterator::last
virtual char16_t last()=0
Sets the iterator to refer to the last code unit in its iteration range, and returns that code unit.
icu::CharacterIterator::getText
virtual void getText(UnicodeString &result)=0
Copies the text under iteration into the UnicodeString referred to by "result".
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...
icu::CharacterIterator::first32
virtual UChar32 first32()=0
Sets the iterator to refer to the first code point in its iteration range, and returns that code unit...
icu::CharacterIterator::next
virtual char16_t next()=0
Advances to the next code unit in the iteration range (toward endIndex()), and returns that code unit...
icu::CharacterIterator::operator=
CharacterIterator & operator=(const CharacterIterator &that)
Assignment operator.
icu::CharacterIterator::last32
virtual UChar32 last32()=0
Sets the iterator to refer to the last code point in its iteration range, and returns that code unit.
icu::CharacterIterator::~CharacterIterator
virtual ~CharacterIterator()
Destructor.
icu::CharacterIterator::current
virtual char16_t current() const =0
Returns the code unit the iterator currently refers to.
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::begin
int32_t begin
Base class field for the start of the iteration range.
Definition chariter.h:686
icu::CharacterIterator::CharacterIterator
CharacterIterator(int32_t length)
Constructor, just setting the length field in this base class.
icu::CharacterIterator::pos
int32_t pos
Base class field for the current position.
Definition chariter.h:680
icu::CharacterIterator::next32
virtual UChar32 next32()=0
Advances to the next code point in the iteration range (toward endIndex()), and returns that code poi...
icu::CharacterIterator::end
int32_t end
Base class field for the end of the iteration range.
Definition chariter.h:692
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::CharacterIterator::first32PostInc
virtual UChar32 first32PostInc()
Sets the iterator to refer to the first code point in its iteration range, returns that code point,...
icu::CharacterIterator::CharacterIterator
CharacterIterator(const CharacterIterator &that)
Copy constructor.
icu::CharacterIterator::current32
virtual UChar32 current32() const =0
Returns the code point the iterator currently refers to.
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::clone
virtual CharacterIterator * clone() const =0
Returns a pointer to a new CharacterIterator of the same concrete class as this one,...
icu::CharacterIterator::previous
virtual char16_t previous()=0
Advances to the previous code unit in the iteration range (toward startIndex()), and returns that cod...
icu::CharacterIterator::first
virtual char16_t first()=0
Sets the iterator to refer to the first code unit in its iteration range, and returns that code unit.
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::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::CharacterIterator
CharacterIterator()
Empty constructor.
icu::ForwardCharacterIterator
Abstract class that defines an API for forward-only iteration on text objects.
Definition chariter.h:94
icu::ForwardCharacterIterator::getDynamicClassID
virtual UClassID getDynamicClassID() const override=0
Returns a UClassID for this ForwardCharacterIterator ("poor man'sRTTI").
icu::ForwardCharacterIterator::~ForwardCharacterIterator
virtual ~ForwardCharacterIterator()
Destructor.
icu::ForwardCharacterIterator::next32PostInc
virtual UChar32 next32PostInc()=0
Gets the current code point for returning and advances to the next code point in the iteration range ...
icu::ForwardCharacterIterator::hashCode
virtual int32_t hashCode() const =0
Generates a hash code for this iterator.
icu::ForwardCharacterIterator::ForwardCharacterIterator
ForwardCharacterIterator(const ForwardCharacterIterator &other)
Copy constructor to be overridden in the implementing class.
icu::ForwardCharacterIterator::operator==
virtual bool operator==(const ForwardCharacterIterator &that) const =0
Returns true when both iterators refer to the same character in the same character-storage object.
icu::ForwardCharacterIterator::operator=
ForwardCharacterIterator & operator=(const ForwardCharacterIterator &)
Assignment operator to be overridden in the implementing class.
Definition chariter.h:189
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::nextPostInc
virtual char16_t nextPostInc()=0
Gets the current code unit for returning and advances to the next code unit in the iteration range (t...
icu::UObject
UObject is the common ICU "boilerplate" class.
Definition uobject.h:223
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition unistr.h:296
icu::operator==
U_EXPORT UBool operator==(const StringPiece &x, const StringPiece &y)
Global operator == for StringPiece.
icu::operator!=
bool operator!=(const StringPiece &x, const StringPiece &y)
Global operator != for StringPiece.
Definition stringpiece.h:346
UChar32
int32_t UChar32
Define UChar32 as a type for single Unicode code points.
Definition umachine.h:427
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition umachine.h:247
unistr.h
C++ API: Unicode String.
uobject.h
C++ API: Common ICU base class UObject.
UClassID
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition uobject.h:96
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
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:315