icuSources/common/unicode/uvernum.h

   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-2016, International Business Machines
   6 *   Corporation and others.  All Rights Reserved.
   7 *******************************************************************************
   8 *
   9 *   file name:  uvernum.h
  10 *   encoding:   UTF-8
  11 *   tab size:   8 (not used)
  12 *   indentation:4
  13 *
  14 *   Created by: Vladimir Weinstein
  15 *   Updated by: Steven R. Loomis
  16 *
  17 */
  18
  19 /**
  20  * \file
  21  * \brief C API: definitions of ICU version numbers
  22  *
  23  * This file is included by uversion.h and other files. This file contains only
  24  * macros and definitions. The actual version numbers are defined here.
  25  */
  26
  27  /*
  28   * IMPORTANT: When updating version, the following things need to be done:
  29   * source/common/unicode/uvernum.h - this file: update major, minor,
  30   *        patchlevel, suffix, version, short version constants, namespace,
  31   *                    renaming macro, and copyright
  32   *
  33   * The following files need to be updated as well, which can be done
  34   *  by running the UNIX makefile target 'update-windows-makefiles' in icu/source.
  35   *
  36   *
  37   * source/common/common_uwp.vcxproj
  38   * source/common/common.vcxproj - update 'Output file name' on the link tab so
  39   *                   that it contains the new major/minor combination
  40   * source/i18n/i18n.vcxproj - same as for the common.vcxproj
  41   * source/i18n/i18n_uwp.vcxproj - same as for the common_uwp.vcxproj
  42   * source/layoutex/layoutex.vcproj - same
  43   * source/stubdata/stubdata.vcproj - same as for the common.vcxproj
  44   * source/io/io.vcproj - same as for the common.vcxproj
  45   * source/data/makedata.mak - change U_ICUDATA_NAME so that it contains
  46   *                            the new major/minor combination and the Unicode version.
  47   */
  48
  49 #ifndef UVERNUM_H
  50 #define UVERNUM_H
  51
  52 /** The standard copyright notice that gets compiled into each library.
  53  *  This value will change in the subsequent releases of ICU
  54  *  @stable ICU 2.4
  55  */
  56 #define U_COPYRIGHT_STRING \
  57   " Copyright (C) 2016 and later: Unicode, Inc. and others. License & terms of use: http://www.unicode.org/copyright.html "
  58
  59 /** The current ICU major version as an integer.
  60  *  This value will change in the subsequent releases of ICU
  61  *  @stable ICU 2.4
  62  */
  63 #define U_ICU_VERSION_MAJOR_NUM 64
  64
  65 /** The current ICU minor version as an integer.
  66  *  This value will change in the subsequent releases of ICU
  67  *  @stable ICU 2.6
  68  */
  69 #define U_ICU_VERSION_MINOR_NUM 2
  70
  71 /** The current ICU patchlevel version as an integer.
  72  *  This value will change in the subsequent releases of ICU
  73  *  @stable ICU 2.4
  74  */
  75 #define U_ICU_VERSION_PATCHLEVEL_NUM 0
  76
  77 /** The current ICU build level version as an integer.
  78  *  This value is for use by ICU clients. It defaults to 0.
  79  *  @stable ICU 4.0
  80  */
  81 #ifndef U_ICU_VERSION_BUILDLEVEL_NUM
  82 #define U_ICU_VERSION_BUILDLEVEL_NUM 0
  83 #endif
  84
  85 /** Glued version suffix for renamers
  86  *  This value will change in the subsequent releases of ICU
  87  *  @stable ICU 2.6
  88  */
  89 #define U_ICU_VERSION_SUFFIX _64
  90
  91 /**
  92  * \def U_DEF2_ICU_ENTRY_POINT_RENAME
  93  * @internal
  94  */
  95 /**
  96  * \def U_DEF_ICU_ENTRY_POINT_RENAME
  97  * @internal
  98  */
  99 /** Glued version suffix function for renamers
 100  *  This value will change in the subsequent releases of ICU.
 101  *  If a custom suffix (such as matching library suffixes) is desired, this can be modified.
 102  *  Note that if present, platform.h may contain an earlier definition of this macro.
 103  *  \def U_ICU_ENTRY_POINT_RENAME
 104  *  @stable ICU 4.2
 105  */
 106 /**
 107  * Disable the version suffix. Use the custom suffix if exists.
 108  * \def U_DISABLE_VERSION_SUFFIX
 109  * @internal
 110  */
 111 #ifndef U_DISABLE_VERSION_SUFFIX
 112 #define U_DISABLE_VERSION_SUFFIX 0
 113 #endif
 114
 115 #ifndef U_ICU_ENTRY_POINT_RENAME
 116 #ifdef U_HAVE_LIB_SUFFIX
 117 #   if !U_DISABLE_VERSION_SUFFIX
 118 #       define U_DEF_ICU_ENTRY_POINT_RENAME(x,y,z) x ## y ##  z
 119 #       define U_DEF2_ICU_ENTRY_POINT_RENAME(x,y,z) U_DEF_ICU_ENTRY_POINT_RENAME(x,y,z)
 120 #       define U_ICU_ENTRY_POINT_RENAME(x)    U_DEF2_ICU_ENTRY_POINT_RENAME(x,U_ICU_VERSION_SUFFIX,U_LIB_SUFFIX_C_NAME)
 121 #   else
 122 #       define U_DEF_ICU_ENTRY_POINT_RENAME(x,y) x ## y
 123 #       define U_DEF2_ICU_ENTRY_POINT_RENAME(x,y) U_DEF_ICU_ENTRY_POINT_RENAME(x,y)
 124 #       define U_ICU_ENTRY_POINT_RENAME(x)    U_DEF2_ICU_ENTRY_POINT_RENAME(x,U_LIB_SUFFIX_C_NAME)
 125 #   endif
 126 #else
 127 #   if !U_DISABLE_VERSION_SUFFIX
 128 #       define U_DEF_ICU_ENTRY_POINT_RENAME(x,y) x ## y
 129 #       define U_DEF2_ICU_ENTRY_POINT_RENAME(x,y) U_DEF_ICU_ENTRY_POINT_RENAME(x,y)
 130 #       define U_ICU_ENTRY_POINT_RENAME(x)    U_DEF2_ICU_ENTRY_POINT_RENAME(x,U_ICU_VERSION_SUFFIX)
 131 #   else
 132 #       define U_ICU_ENTRY_POINT_RENAME(x)    x
 133 #   endif
 134 #endif
 135 #endif
 136
 137 /** The current ICU library version as a dotted-decimal string. The patchlevel
 138  *  only appears in this string if it non-zero.
 139  *  This value will change in the subsequent releases of ICU
 140  *  @stable ICU 2.4
 141  */
 142 #define U_ICU_VERSION "64.2"
 143
 144 /**
 145  * The current ICU library major version number as a string, for library name suffixes.
 146  * This value will change in subsequent releases of ICU.
 147  *
 148  * Until ICU 4.8, this was the combination of the single-digit major and minor ICU version numbers
 149  * into one string without dots ("48").
 150  * Since ICU 49, it is the double-digit major ICU version number.
 151  * See http://userguide.icu-project.org/design#TOC-Version-Numbers-in-ICU
 152  *
 153  * @stable ICU 2.6
 154  */
 155 #define U_ICU_VERSION_SHORT "64"
 156
 157 #ifndef U_HIDE_INTERNAL_API
 158 /** Data version in ICU4C.
 159  * @internal ICU 4.4 Internal Use Only
 160  **/
 161 #define U_ICU_DATA_VERSION "64.2"
 162 #endif  /* U_HIDE_INTERNAL_API */
 163
 164 /*===========================================================================
 165  * ICU collation framework version information
 166  * Version info that can be obtained from a collator is affected by these
 167  * numbers in a secret and magic way. Please use collator version as whole
 168  *===========================================================================
 169  */
 170
 171 /**
 172  * Collation runtime version (sort key generator, strcoll).
 173  * If the version is different, sort keys for the same string could be different.
 174  * This value may change in subsequent releases of ICU.
 175  * @stable ICU 2.4
 176  */
 177 #define UCOL_RUNTIME_VERSION 9
 178
 179 /**
 180  * Collation builder code version.
 181  * When this is different, the same tailoring might result
 182  * in assigning different collation elements to code points.
 183  * This value may change in subsequent releases of ICU.
 184  * @stable ICU 2.4
 185  */
 186 #define UCOL_BUILDER_VERSION 9
 187
 188 #ifndef U_HIDE_DEPRECATED_API
 189 /**
 190  * Constant 1.
 191  * This was intended to be the version of collation tailorings,
 192  * but instead the tailoring data carries a version number.
 193  * @deprecated ICU 54
 194  */
 195 #define UCOL_TAILORINGS_VERSION 1
 196 #endif  /* U_HIDE_DEPRECATED_API */
 197
 198 #endif