ICU 70.1  70.1
resbund.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) 1996-2013, International Business Machines Corporation
7 * and others. All Rights Reserved.
8 *
9 ******************************************************************************
10 *
11 * File resbund.h
12 *
13 * CREATED BY
14 * Richard Gillam
15 *
16 * Modification History:
17 *
18 * Date Name Description
19 * 2/5/97 aliu Added scanForLocaleInFile. Added
20 * constructor which attempts to read resource bundle
21 * from a specific file, without searching other files.
22 * 2/11/97 aliu Added UErrorCode return values to constructors. Fixed
23 * infinite loops in scanForFile and scanForLocale.
24 * Modified getRawResourceData to not delete storage
25 * in localeData and resourceData which it doesn't own.
26 * Added Mac compatibility #ifdefs for tellp() and
27 * ios::nocreate.
28 * 2/18/97 helena Updated with 100% documentation coverage.
29 * 3/13/97 aliu Rewrote to load in entire resource bundle and store
30 * it as a Hashtable of ResourceBundleData objects.
31 * Added state table to govern parsing of files.
32 * Modified to load locale index out of new file
33 * distinct from default.txt.
34 * 3/25/97 aliu Modified to support 2-d arrays, needed for timezone
35 * data. Added support for custom file suffixes. Again,
36 * needed to support timezone data.
37 * 4/7/97 aliu Cleaned up.
38 * 03/02/99 stephen Removed dependency on FILE*.
39 * 03/29/99 helena Merged Bertrand and Stephen's changes.
40 * 06/11/99 stephen Removed parsing of .txt files.
41 * Reworked to use new binary format.
42 * Cleaned up.
43 * 06/14/99 stephen Removed methods taking a filename suffix.
44 * 11/09/99 weiv Added getLocale(), fRealLocale, removed fRealLocaleID
45 ******************************************************************************
46 */
47 
48 #ifndef RESBUND_H
49 #define RESBUND_H
50 
51 #include "unicode/utypes.h"
52 
53 #if U_SHOW_CPLUSPLUS_API
54 
55 #include "unicode/uobject.h"
56 #include "unicode/ures.h"
57 #include "unicode/unistr.h"
58 #include "unicode/locid.h"
59 
65 U_NAMESPACE_BEGIN
66 
84 public:
111  ResourceBundle(const UnicodeString& packageName,
112  const Locale& locale,
113  UErrorCode& err);
114 
126  ResourceBundle(const UnicodeString& packageName,
127  UErrorCode& err);
128 
136 
151  ResourceBundle(const char* packageName,
152  const Locale& locale,
153  UErrorCode& err);
154 
161  ResourceBundle(const ResourceBundle &original);
162 
173  UErrorCode &status);
174 
182  operator=(const ResourceBundle& other);
183 
187  virtual ~ResourceBundle();
188 
201 
212  int32_t
213  getSize(void) const;
214 
226  getString(UErrorCode& status) const;
227 
240  const uint8_t*
241  getBinary(int32_t& len, UErrorCode& status) const;
242 
243 
255  const int32_t*
256  getIntVector(int32_t& len, UErrorCode& status) const;
257 
269  uint32_t
270  getUInt(UErrorCode& status) const;
271 
283  int32_t
284  getInt(UErrorCode& status) const;
285 
292  UBool
293  hasNext(void) const;
294 
300  void
302 
310  const char*
311  getKey(void) const;
312 
320  const char*
321  getName(void) const;
322 
323 
330  UResType
331  getType(void) const;
332 
341  getNext(UErrorCode& status);
342 
353 
364  getNextString(const char ** key,
365  UErrorCode& status);
366 
376  get(int32_t index,
377  UErrorCode& status) const;
378 
388  getStringEx(int32_t index,
389  UErrorCode& status) const;
390 
401  get(const char* key,
402  UErrorCode& status) const;
403 
414  getStringEx(const char* key,
415  UErrorCode& status) const;
416 
417 #ifndef U_HIDE_DEPRECATED_API
427  const char*
428  getVersionNumber(void) const;
429 #endif /* U_HIDE_DEPRECATED_API */
430 
438  void
439  getVersion(UVersionInfo versionInfo) const;
440 
441 #ifndef U_HIDE_DEPRECATED_API
448  const Locale&
449  getLocale(void) const;
450 #endif /* U_HIDE_DEPRECATED_API */
451 
462  const Locale
464 #ifndef U_HIDE_INTERNAL_API
470  getWithFallback(const char* key, UErrorCode& status);
471 #endif /* U_HIDE_INTERNAL_API */
477  virtual UClassID getDynamicClassID() const override;
478 
484  static UClassID U_EXPORT2 getStaticClassID();
485 
486 private:
487  ResourceBundle(); // default constructor not implemented
488 
489  UResourceBundle *fResource;
490  void constructForLocale(const UnicodeString& path, const Locale& locale, UErrorCode& error);
491  Locale *fLocale;
492 };
493 
494 U_NAMESPACE_END
495 
496 #endif /* U_SHOW_CPLUSPLUS_API */
497 
498 #endif
A Locale object represents a specific geographical, political, or cultural region.
Definition: locid.h:195
A class representing a collection of resource information pertaining to a given locale.
Definition: resbund.h:83
ResourceBundle(UResourceBundle *res, UErrorCode &status)
Constructor from a C UResourceBundle.
ResourceBundle(const ResourceBundle &original)
Copy constructor.
ResourceBundle(const char *packageName, const Locale &locale, UErrorCode &err)
Standard constructor, constructs a resource bundle for the locale-specific bundle in the specified pa...
ResourceBundle get(int32_t index, UErrorCode &status) const
Returns the resource in a resource at the specified index.
ResourceBundle * clone() const
Clone this object.
ResourceBundle(const UnicodeString &packageName, UErrorCode &err)
Construct a resource bundle for the default bundle in the specified package.
int32_t getInt(UErrorCode &status) const
returns a signed integer from a resource.
ResourceBundle get(const char *key, UErrorCode &status) const
Returns a resource in a resource that has a given key.
void getVersion(UVersionInfo versionInfo) const
Return the version number associated with this ResourceBundle as a UVersionInfo array.
ResourceBundle getNext(UErrorCode &status)
Returns the next resource in a given resource or NULL if there are no more resources.
virtual UClassID getDynamicClassID() const override
ICU "poor man's RTTI", returns a UClassID for the actual class.
static UClassID getStaticClassID()
ICU "poor man's RTTI", returns a UClassID for this class.
ResourceBundle(UErrorCode &err)
Construct a resource bundle for the ICU default bundle.
void resetIterator(void)
Resets the internal context of a resource so that iteration starts from the first element.
const int32_t * getIntVector(int32_t &len, UErrorCode &status) const
returns an integer vector from a resource.
ResourceBundle & operator=(const ResourceBundle &other)
Assignment operator.
UnicodeString getStringEx(int32_t index, UErrorCode &status) const
Returns the string in a given resource at the specified index.
ResourceBundle getWithFallback(const char *key, UErrorCode &status)
This API implements multilevel fallback.
UnicodeString getNextString(UErrorCode &status)
Returns the next string in a resource or NULL if there are no more resources to iterate over.
const Locale getLocale(ULocDataLocaleType type, UErrorCode &status) const
Return the Locale associated with this ResourceBundle.
const Locale & getLocale(void) const
Return the Locale associated with this ResourceBundle.
UResType getType(void) const
Returns the type of a resource.
uint32_t getUInt(UErrorCode &status) const
returns an unsigned integer from a resource.
int32_t getSize(void) const
Returns the size of a resource.
virtual ~ResourceBundle()
Destructor.
UnicodeString getNextString(const char **key, UErrorCode &status)
Returns the next string in a resource or NULL if there are no more resources to iterate over.
const char * getVersionNumber(void) const
Return the version number associated with this ResourceBundle as a string.
ResourceBundle(const UnicodeString &packageName, const Locale &locale, UErrorCode &err)
Constructor.
const char * getName(void) const
Gets the locale ID of the resource bundle as a string.
const uint8_t * getBinary(int32_t &len, UErrorCode &status) const
returns a binary data from a resource.
const char * getKey(void) const
Returns the key associated with this resource.
UnicodeString getString(UErrorCode &status) const
returns a string from a string resource type
UBool hasNext(void) const
Checks whether the resource has another element to iterate over.
UnicodeString getStringEx(const char *key, UErrorCode &status) const
Returns a string in a resource that has a given key.
UObject is the common ICU "boilerplate" class.
Definition: uobject.h:223
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:296
C++ API: Locale ID object.
ULocDataLocaleType
Constants for *_getLocale() Allow user to select whether she wants information on requested,...
Definition: uloc.h:338
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition: umachine.h:269
C++ API: Unicode String.
C++ API: Common ICU base class UObject.
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:96
C API: Resource Bundle.
UResType
Numeric constants for types of resource items.
Definition: ures.h:69
struct UResourceBundle UResourceBundle
Definition: ures.h:62
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:415
#define U_COMMON_API
Set to export library symbols from inside the common library, and to import them from outside.
Definition: utypes.h:300
uint8_t UVersionInfo[U_MAX_VERSION_LENGTH]
The binary form of a version on ICU APIs is an array of 4 uint8_t.
Definition: uversion.h:59