ICU 67.1  67.1
Macros | Typedefs | Functions
uversion.h File Reference

C API: API for accessing ICU version numbers. More...

#include "unicode/umachine.h"
#include "unicode/uvernum.h"

Go to the source code of this file.

Macros

#define U_COPYRIGHT_STRING_LENGTH   128
 Maximum length of the copyright string. More...
 
#define U_MAX_VERSION_LENGTH   4
 An ICU version consists of up to 4 numbers from 0..255. More...
 
#define U_VERSION_DELIMITER   '.'
 In a string, ICU version fields are delimited by dots. More...
 
#define U_MAX_VERSION_STRING_LENGTH   20
 The maximum length of an ICU version string. More...
 

Typedefs

typedef uint8_t UVersionInfo[U_MAX_VERSION_LENGTH]
 The binary form of a version on ICU APIs is an array of 4 uint8_t. More...
 

Functions

void u_versionFromString (UVersionInfo versionArray, const char *versionString)
 Parse a string with dotted-decimal version information and fill in a UVersionInfo structure with the result. More...
 
void u_versionFromUString (UVersionInfo versionArray, const UChar *versionString)
 Parse a Unicode string with dotted-decimal version information and fill in a UVersionInfo structure with the result. More...
 
void u_versionToString (const UVersionInfo versionArray, char *versionString)
 Write a string with dotted-decimal version information according to the input UVersionInfo. More...
 
void u_getVersion (UVersionInfo versionArray)
 Gets the ICU release version. More...
 

Detailed Description

C API: API for accessing ICU version numbers.

Definition in file uversion.h.

Macro Definition Documentation

◆ U_COPYRIGHT_STRING_LENGTH

#define U_COPYRIGHT_STRING_LENGTH   128

Maximum length of the copyright string.

Stable:
ICU 2.4

Definition at line 38 of file uversion.h.

◆ U_MAX_VERSION_LENGTH

#define U_MAX_VERSION_LENGTH   4

An ICU version consists of up to 4 numbers from 0..255.

Stable:
ICU 2.4

Definition at line 43 of file uversion.h.

◆ U_MAX_VERSION_STRING_LENGTH

#define U_MAX_VERSION_STRING_LENGTH   20

The maximum length of an ICU version string.

Stable:
ICU 2.4

Definition at line 53 of file uversion.h.

◆ U_VERSION_DELIMITER

#define U_VERSION_DELIMITER   '.'

In a string, ICU version fields are delimited by dots.

Stable:
ICU 2.4

Definition at line 48 of file uversion.h.

Typedef Documentation

◆ UVersionInfo

typedef uint8_t UVersionInfo[U_MAX_VERSION_LENGTH]

The binary form of a version on ICU APIs is an array of 4 uint8_t.

To compare two versions, use memcmp(v1,v2,sizeof(UVersionInfo)).

Stable:
ICU 2.4

Definition at line 59 of file uversion.h.

Function Documentation

◆ u_getVersion()

void u_getVersion ( UVersionInfo  versionArray)

Gets the ICU release version.

The version array stores the version information for ICU. For example, release "1.3.31.2" is then represented as 0x01031F02. Definition of this function lives in putil.c

Parameters
versionArraythe version # information, the result will be filled in
Stable:
ICU 2.0

◆ u_versionFromString()

void u_versionFromString ( UVersionInfo  versionArray,
const char *  versionString 
)

Parse a string with dotted-decimal version information and fill in a UVersionInfo structure with the result.

Definition of this function lives in putil.c

Parameters
versionArrayThe destination structure for the version information.
versionStringA string with dotted-decimal version information, with up to four non-negative number fields with values of up to 255 each.
Stable:
ICU 2.4

◆ u_versionFromUString()

void u_versionFromUString ( UVersionInfo  versionArray,
const UChar versionString 
)

Parse a Unicode string with dotted-decimal version information and fill in a UVersionInfo structure with the result.

Definition of this function lives in putil.c

Parameters
versionArrayThe destination structure for the version information.
versionStringA Unicode string with dotted-decimal version information, with up to four non-negative number fields with values of up to 255 each.
Stable:
ICU 4.2

◆ u_versionToString()

void u_versionToString ( const UVersionInfo  versionArray,
char *  versionString 
)

Write a string with dotted-decimal version information according to the input UVersionInfo.

Definition of this function lives in putil.c

Parameters
versionArrayThe version information to be written as a string.
versionStringA string buffer that will be filled in with a string corresponding to the numeric version information in versionArray. The buffer size must be at least U_MAX_VERSION_STRING_LENGTH.
Stable:
ICU 2.4