projects / apple / icu.git / blame
| Commit | Line | Data |
|---|---|---|
| b75a7d8f A |
1 | /* |
| 2 | ********************************************************************** | |
| 729e4ab9 | 3 | * Copyright (c) 2002-2009, International Business Machines |
| b75a7d8f A |
4 | * Corporation and others. All Rights Reserved. |
| 5 | ********************************************************************** | |
| 6 | * Author: Alan Liu | |
| 7 | * Created: November 11 2002 | |
| 8 | * Since: ICU 2.4 | |
| 9 | ********************************************************************** | |
| 10 | */ | |
| 11 | #ifndef _USTRENUM_H_ | |
| 12 | #define _USTRENUM_H_ | |
| 13 | ||
| 14 | #include "unicode/uenum.h" | |
| 15 | #include "unicode/strenum.h" | |
| 16 | ||
| 374ca955 A |
17 | /** |
| 18 | * Given an array of const char* strings (invariant chars only), | |
| 19 | * return a UEnumeration. Must have strings[i] != 0 for i in | |
| 20 | * 0..count-1. | |
| 21 | */ | |
| 22 | U_CAPI UEnumeration* U_EXPORT2 | |
| 46f4442e | 23 | uenum_openCharStringsEnumeration(const char* const* strings, int32_t count, |
| 374ca955 A |
24 | UErrorCode* ec); |
| 25 | ||
| 26 | //---------------------------------------------------------------------- | |
| 27 | U_NAMESPACE_BEGIN | |
| 28 | ||
| 29 | /** | |
| 30 | * A wrapper to make a UEnumeration into a StringEnumeration. The | |
| 31 | * wrapper adopts the UEnumeration is wraps. | |
| 32 | */ | |
| 33 | class U_COMMON_API UStringEnumeration : public StringEnumeration { | |
| 34 | ||
| 35 | public: | |
| 36 | /** | |
| 37 | * Constructor. This constructor adopts its UEnumeration | |
| 38 | * argument. | |
| 39 | * @param uenum a UEnumeration object. This object takes | |
| 40 | * ownership of 'uenum' and will close it in its destructor. The | |
| 41 | * caller must not call uenum_close on 'uenum' after calling this | |
| 42 | * constructor. | |
| 43 | */ | |
| 44 | UStringEnumeration(UEnumeration* uenum); | |
| 45 | ||
| 46 | /** | |
| 47 | * Destructor. This closes the UEnumeration passed in to the | |
| 48 | * constructor. | |
| 49 | */ | |
| 50 | virtual ~UStringEnumeration(); | |
| 51 | ||
| 52 | /** | |
| 53 | * Return the number of elements that the iterator traverses. | |
| 54 | * @param status the error code. | |
| 55 | * @return number of elements in the iterator. | |
| 56 | */ | |
| 57 | virtual int32_t count(UErrorCode& status) const; | |
| 58 | ||
| 59 | /** | |
| 60 | * Returns the next element a UnicodeString*. If there are no | |
| 61 | * more elements, returns NULL. | |
| 62 | * @param status the error code. | |
| 63 | * @return a pointer to the string, or NULL. | |
| 64 | */ | |
| 65 | virtual const UnicodeString* snext(UErrorCode& status); | |
| 66 | ||
| 67 | /** | |
| 68 | * Resets the iterator. | |
| 69 | * @param status the error code. | |
| 70 | */ | |
| 71 | virtual void reset(UErrorCode& status); | |
| 72 | ||
| 73 | /** | |
| 74 | * ICU4C "poor man's RTTI", returns a UClassID for the actual ICU class. | |
| 75 | */ | |
| 76 | virtual UClassID getDynamicClassID() const; | |
| 77 | ||
| 78 | /** | |
| 79 | * ICU4C "poor man's RTTI", returns a UClassID for this ICU class. | |
| 80 | */ | |
| 81 | static UClassID U_EXPORT2 getStaticClassID(); | |
| 82 | ||
| 83 | private: | |
| 84 | UEnumeration *uenum; // owned | |
| 85 | }; | |
| 86 | ||
| 87 | U_NAMESPACE_END | |
| 88 | ||
| b75a7d8f | 89 | #endif |
| 374ca955 | 90 |