ICU 63.1  63.1
uversion.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 * Copyright (C) 2000-2011, International Business Machines
6 * Corporation and others. All Rights Reserved.
7 *******************************************************************************
8 *
9 * file name: uversion.h
10 * encoding: UTF-8
11 * tab size: 8 (not used)
12 * indentation:4
13 *
14 * Created by: Vladimir Weinstein
15 *
16 * Gets included by utypes.h and Windows .rc files
17 */
18 
23 /*===========================================================================*/
24 /* Main ICU version information */
25 /*===========================================================================*/
26 
27 #ifndef UVERSION_H
28 #define UVERSION_H
29 
30 #include "unicode/umachine.h"
31 
32 /* Actual version info lives in uvernum.h */
33 #include "unicode/uvernum.h"
34 
38 #define U_COPYRIGHT_STRING_LENGTH 128
39 
43 #define U_MAX_VERSION_LENGTH 4
44 
48 #define U_VERSION_DELIMITER '.'
49 
53 #define U_MAX_VERSION_STRING_LENGTH 20
54 
60 
61 /*===========================================================================*/
62 /* C++ namespace if supported. Versioned unless versioning is disabled. */
63 /*===========================================================================*/
64 
108 /* Define C++ namespace symbols. */
109 #ifdef __cplusplus
110 # if U_DISABLE_RENAMING
111 # define U_ICU_NAMESPACE icu
112  namespace U_ICU_NAMESPACE { }
113 # else
114 # define U_ICU_NAMESPACE U_ICU_ENTRY_POINT_RENAME(icu)
115  namespace U_ICU_NAMESPACE { }
116  namespace icu = U_ICU_NAMESPACE;
117 # endif
118 
119 # define U_NAMESPACE_BEGIN extern "C++" { namespace U_ICU_NAMESPACE {
120 # define U_NAMESPACE_END } }
121 # define U_NAMESPACE_USE using namespace U_ICU_NAMESPACE;
122 # define U_NAMESPACE_QUALIFIER U_ICU_NAMESPACE::
123 
124 # ifndef U_USING_ICU_NAMESPACE
125 # if defined(U_COMBINED_IMPLEMENTATION) || defined(U_COMMON_IMPLEMENTATION) || \
126  defined(U_I18N_IMPLEMENTATION) || defined(U_IO_IMPLEMENTATION) || \
127  defined(U_LAYOUTEX_IMPLEMENTATION) || defined(U_TOOLUTIL_IMPLEMENTATION)
128 # define U_USING_ICU_NAMESPACE 0
129 # else
130 # define U_USING_ICU_NAMESPACE 0
131 # endif
132 # endif
133 # if U_USING_ICU_NAMESPACE
135 # endif
136 #else
137 # define U_NAMESPACE_BEGIN
138 # define U_NAMESPACE_END
139 # define U_NAMESPACE_USE
140 # define U_NAMESPACE_QUALIFIER
141 #endif
142 
143 /*===========================================================================*/
144 /* General version helper functions. Definitions in putil.c */
145 /*===========================================================================*/
146 
158 U_STABLE void U_EXPORT2
159 u_versionFromString(UVersionInfo versionArray, const char *versionString);
160 
172 U_STABLE void U_EXPORT2
173 u_versionFromUString(UVersionInfo versionArray, const UChar *versionString);
174 
175 
188 U_STABLE void U_EXPORT2
189 u_versionToString(const UVersionInfo versionArray, char *versionString);
190 
199 U_STABLE void U_EXPORT2
200 u_getVersion(UVersionInfo versionArray);
201 #endif
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
C API: definitions of ICU version numbers.
#define U_MAX_VERSION_LENGTH
An ICU version consists of up to 4 numbers from 0..255.
Definition: uversion.h:43
void u_getVersion(UVersionInfo versionArray)
Gets the ICU release version.
void u_versionFromString(UVersionInfo versionArray, const char *versionString)
Parse a string with dotted-decimal version information and fill in a UVersionInfo structure with the ...
Basic types and constants for UTF.
File coll.h.
Definition: appendable.h:28
#define U_NAMESPACE_USE
This is used to specify that the rest of the code uses the public ICU C++ API namespace.
Definition: uversion.h:139
uint16_t UChar
The base type for UTF-16 code units and pointers.
Definition: umachine.h:342
void u_versionToString(const UVersionInfo versionArray, char *versionString)
Write a string with dotted-decimal version information according to the input UVersionInfo.
void u_versionFromUString(UVersionInfo versionArray, const UChar *versionString)
Parse a Unicode string with dotted-decimal version information and fill in a UVersionInfo structure w...
#define U_STABLE
This is used to declare a function as a stable public ICU C API.
Definition: umachine.h:111