16f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/* 26f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org****************************************************************************** 36f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* 46f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* Copyright (C) 1999-2012, International Business Machines 56f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* Corporation and others. All Rights Reserved. 66f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* 76f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org****************************************************************************** 86f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* file name: udata.h 96f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* encoding: US-ASCII 106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* tab size: 8 (not used) 116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* indentation:4 126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* 136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* created on: 1999oct25 146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org* created by: Markus W. Scherer 156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org*/ 166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#ifndef __UDATA_H__ 186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define __UDATA_H__ 196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/utypes.h" 216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/localpointer.h" 226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_CDECL_BEGIN 246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \file 276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \brief C API: Data loading interface 286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <h2>Information about data loading interface</h2> 306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This API is used to find and efficiently load data for ICU and applications 326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * using ICU. It provides an abstract interface that specifies a data type and 336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * name to find and load the data. Normally this API is used by other ICU APIs 346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * to load required data out of the ICU data library, but it can be used to 356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * load data out of other places. 366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * See the User Guide Data Management chapter. 386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#ifndef U_HIDE_INTERNAL_API 416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Character used to separate package names from tree names 436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @internal ICU 3.0 446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define U_TREE_SEPARATOR '-' 466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * String used to separate package names from tree names 496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @internal ICU 3.0 506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define U_TREE_SEPARATOR_STRING "-" 526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Character used to separate parts of entry names 556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @internal ICU 3.0 566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define U_TREE_ENTRY_SEP_CHAR '/' 586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * String used to separate parts of entry names 616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @internal ICU 3.0 626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define U_TREE_ENTRY_SEP_STRING "/" 646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Alias for standard ICU data 676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @internal ICU 3.0 686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define U_ICUDATA_ALIAS "ICUDATA" 706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#endif /* U_HIDE_INTERNAL_API */ 726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * UDataInfo contains the properties about the requested data. 756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is meta data. 766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>This structure may grow in the future, indicated by the 786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>size</code> field.</p> 796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The platform data property fields help determine if a data 816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * file can be efficiently used on a given machine. 826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The particular fields are of importance only if the data 836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * is affected by the properties - if there is integer data 846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * with word sizes > 1 byte, char* text, or UChar* text.</p> 856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The implementation for the <code>udata_open[Choice]()</code> 876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * functions may reject data based on the value in <code>isBigEndian</code>. 886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * No other field is used by the <code>udata</code> API implementation.</p> 896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The <code>dataFormat</code> may be used to identify 916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the kind of data, e.g. a converter table.</p> 926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The <code>formatVersion</code> field should be used to 946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * make sure that the format can be interpreted. 956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * I may be a good idea to check only for the one or two highest 966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of the version elements to allow the data memory to 976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * get more or somewhat rearranged contents, for as long 986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * as the using code can still interpret the older contents.</p> 996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The <code>dataVersion</code> field is intended to be a 1016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * common place to store the source version of the data; 1026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * for data from the Unicode character database, this could 1036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * reflect the Unicode version.</p> 1046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgtypedef struct { 1076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** sizeof(UDataInfo) 1086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 */ 1096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint16_t size; 1106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** unused, set to 0 1126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint16_t reservedWord; 1146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /* platform data properties */ 1166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 0 for little-endian machine, 1 for big-endian 1176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 */ 1186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t isBigEndian; 1196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** see U_CHARSET_FAMILY values in utypes.h 1216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t charsetFamily; 1236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** sizeof(UChar), one of { 1, 2, 4 } 1256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t sizeofUChar; 1276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** unused, set to 0 1296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t reservedByte; 1316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** data format identifier 1336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t dataFormat[4]; 1356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** versions: [0] major [1] minor [2] milli [3] micro 1376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t formatVersion[4]; 1396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** versions: [0] major [1] minor [2] milli [3] micro 1416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0*/ 1426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint8_t dataVersion[4]; 1436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org} UDataInfo; 1446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/* API for reading data -----------------------------------------------------*/ 1466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 1486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Forward declaration of the data memory type. 1496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgtypedef struct UDataMemory UDataMemory; 1526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 1546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Callback function for udata_openChoice(). 1556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param context parameter passed into <code>udata_openChoice()</code>. 1566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param type The type of the data as passed into <code>udata_openChoice()</code>. 1576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It may be <code>NULL</code>. 1586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param name The name of the data as passed into <code>udata_openChoice()</code>. 1596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pInfo A pointer to the <code>UDataInfo</code> structure 1606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of data that has been loaded and will be returned 1616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * by <code>udata_openChoice()</code> if this function 1626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * returns <code>TRUE</code>. 1636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return TRUE if the current data memory is acceptable 1646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgtypedef UBool U_CALLCONV 1676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgUDataMemoryIsAcceptable(void *context, 1686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org const char *type, const char *name, 1696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org const UDataInfo *pInfo); 1706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 1736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Convenience function. 1746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function works the same as <code>udata_openChoice</code> 1756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * except that any data that matches the type and name 1766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * is assumed to be acceptable. 1776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param path Specifies an absolute path and/or a basename for the 1786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * finding of the data in the file system. 1796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>NULL</code> for ICU data. 1806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param type A string that specifies the type of data to be loaded. 1816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For example, resource bundles are loaded with type "res", 1826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * conversion tables with type "cnv". 1836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This may be <code>NULL</code> or empty. 1846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param name A string that specifies the name of the data. 1856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pErrorCode An ICU UErrorCode parameter. It must not be <code>NULL</code>. 1866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return A pointer (handle) to a data memory object, or <code>NULL</code> 1876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * if an error occurs. Call <code>udata_getMemory()</code> 1886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * to get a pointer to the actual data. 1896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see udata_openChoice 1916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE UDataMemory * U_EXPORT2 1946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_open(const char *path, const char *type, const char *name, 1956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode *pErrorCode); 1966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 1986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Data loading function. 1996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function is used to find and load efficiently data for 2006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * ICU and applications using ICU. 2016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It provides an abstract interface that allows to specify a data 2026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * type and name to find and load the data. 2036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The implementation depends on platform properties and user preferences 2056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * and may involve loading shared libraries (DLLs), mapping 2066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * files into memory, or fopen()/fread() files. 2076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It may also involve using static memory or database queries etc. 2086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Several or all data items may be combined into one entity 2096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (DLL, memory-mappable file).</p> 2106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>The data is always preceded by a header that includes 2126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * a <code>UDataInfo</code> structure. 2136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The caller's <code>isAcceptable()</code> function is called to make 2146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * sure that the data is useful. It may be called several times if it 2156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * rejects the data and there is more than one location with data 2166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * matching the type and name.</p> 2176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>If <code>path==NULL</code>, then ICU data is loaded. 2196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Otherwise, it is separated into a basename and a basename-less directory string. 2206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The basename is used as the data package name, and the directory is 2216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * logically prepended to the ICU data directory string.</p> 2226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p>For details about ICU data loading see the User Guide 2246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Data Management chapter. (http://icu-project.org/userguide/icudata.html)</p> 2256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param path Specifies an absolute path and/or a basename for the 2276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * finding of the data in the file system. 2286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>NULL</code> for ICU data. 2296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param type A string that specifies the type of data to be loaded. 2306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For example, resource bundles are loaded with type "res", 2316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * conversion tables with type "cnv". 2326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This may be <code>NULL</code> or empty. 2336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param name A string that specifies the name of the data. 2346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param isAcceptable This function is called to verify that loaded data 2356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * is useful for the client code. If it returns FALSE 2366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * for all data items, then <code>udata_openChoice()</code> 2376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * will return with an error. 2386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param context Arbitrary parameter to be passed into isAcceptable. 2396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pErrorCode An ICU UErrorCode parameter. It must not be <code>NULL</code>. 2406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return A pointer (handle) to a data memory object, or <code>NULL</code> 2416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * if an error occurs. Call <code>udata_getMemory()</code> 2426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * to get a pointer to the actual data. 2436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE UDataMemory * U_EXPORT2 2466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_openChoice(const char *path, const char *type, const char *name, 2476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDataMemoryIsAcceptable *isAcceptable, void *context, 2486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode *pErrorCode); 2496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 2516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Close the data memory. 2526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function must be called to allow the system to 2536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * release resources associated with this data memory. 2546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pData The pointer to data memory object 2556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE void U_EXPORT2 2586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_close(UDataMemory *pData); 2596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#if U_SHOW_CPLUSPLUS_API 2616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_NAMESPACE_BEGIN 2636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 2656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \class LocalUDataMemoryPointer 2666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * "Smart pointer" class, closes a UDataMemory via udata_close(). 2676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For most methods see the LocalPointerBase base class. 2686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see LocalPointerBase 2706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see LocalPointer 2716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 4.4 2726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_DEFINE_LOCAL_OPEN_POINTER(LocalUDataMemoryPointer, UDataMemory, udata_close); 2746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_NAMESPACE_END 2766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#endif 2786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 2806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Get the pointer to the actual data inside the data memory. 2816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The data is read-only. 2826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pData The pointer to data memory object 2836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE const void * U_EXPORT2 2866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_getMemory(UDataMemory *pData); 2876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 2896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Get the information from the data memory header. 2906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This allows to get access to the header containing 2916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * platform data properties etc. which is not part of 2926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the data itself and can therefore not be accessed 2936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * via the pointer that <code>udata_getMemory()</code> returns. 2946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pData pointer to the data memory object 2966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param pInfo pointer to a UDataInfo object; 2976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * its <code>size</code> field must be set correctly, 2986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * typically to <code>sizeof(UDataInfo)</code>. 2996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>*pInfo</code> will be filled with the UDataInfo structure 3016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in the data memory object. If this structure is smaller than 3026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>pInfo->size</code>, then the <code>size</code> will be 3036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * adjusted and only part of the structure will be filled. 3046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 3056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE void U_EXPORT2 3076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_getInfo(UDataMemory *pData, UDataInfo *pInfo); 3086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 3106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function bypasses the normal ICU data loading process and 3116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * allows you to force ICU's system data to come out of a user-specified 3126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * area in memory. 3136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The format of this data is that of the icu common data file, as is 3156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * generated by the pkgdata tool with mode=common or mode=dll. 3166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * You can read in a whole common mode file and pass the address to the start of the 3176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * data, or (with the appropriate link options) pass in the pointer to 3186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the data that has been loaded from a dll by the operating system, 3196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * as shown in this code: 3206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * extern const char U_IMPORT U_ICUDATA_ENTRY_POINT []; 3226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * // U_ICUDATA_ENTRY_POINT is same as entry point specified to pkgdata tool 3236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * UErrorCode status = U_ZERO_ERROR; 3246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * udata_setCommonData(&U_ICUDATA_ENTRY_POINT, &status); 3266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is important that the declaration be as above. The entry point 3286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * must not be declared as an extern void*. 3296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Starting with ICU 4.4, it is possible to set several data packages, 3316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * one per call to this function. 3326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * udata_open() will look for data in the multiple data packages in the order 3336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in which they were set. 3346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The position of the linked-in or default-name ICU .data package in the 3356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * search list depends on when the first data item is loaded that is not contained 3366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in the already explicitly set packages. 3376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If data was loaded implicitly before the first call to this function 3386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (for example, via opening a converter, constructing a UnicodeString 3396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * from default-codepage data, using formatting or collation APIs, etc.), 3406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * then the default data will be first in the list. 3416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function has no effect on application (non ICU) data. See udata_setAppData() 3436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * for similar functionality for application data. 3446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param data pointer to ICU common data 3466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param err outgoing error status <code>U_USING_DEFAULT_WARNING, U_UNSUPPORTED_ERROR</code> 3476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 3486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE void U_EXPORT2 3506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_setCommonData(const void *data, UErrorCode *err); 3516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 3546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function bypasses the normal ICU data loading process for application-specific 3556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * data and allows you to force the it to come out of a user-specified 3566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * pointer. 3576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The format of this data is that of the icu common data file, like 'icudt26l.dat' 3596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * or the corresponding shared library (DLL) file. 3606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The application must read in or otherwise construct an image of the data and then 3616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * pass the address of it to this function. 3626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Warning: setAppData will set a U_USING_DEFAULT_WARNING code if 3656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * data with the specifed path that has already been opened, or 3666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * if setAppData with the same path has already been called. 3676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Any such calls to setAppData will have no effect. 3686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param packageName the package name by which the application will refer 3716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * to (open) this data 3726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param data pointer to the data 3736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param err outgoing error status <code>U_USING_DEFAULT_WARNING, U_UNSUPPORTED_ERROR</code> 3746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see udata_setCommonData 3756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 3766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE void U_EXPORT2 3786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_setAppData(const char *packageName, const void *data, UErrorCode *err); 3796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 3816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Possible settings for udata_setFileAccess() 3826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see udata_setFileAccess 3836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 3.4 3846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgtypedef enum UDataFileAccess { 3866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** ICU looks for data in single files first, then in packages. (default) @stable ICU 3.4 */ 3876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_FILES_FIRST, 3886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** An alias for the default access mode. @stable ICU 3.4 */ 3896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_DEFAULT_ACCESS = UDATA_FILES_FIRST, 3906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** ICU only loads data from packages, not from single files. @stable ICU 3.4 */ 3916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_ONLY_PACKAGES, 3926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** ICU loads data from packages first, and only from single files 3936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org if the data cannot be found in a package. @stable ICU 3.4 */ 3946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_PACKAGES_FIRST, 3956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** ICU does not access the file system for data loading. @stable ICU 3.4 */ 3966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_NO_FILES, 3976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** Number of real UDataFileAccess values. @stable ICU 3.4 */ 3986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UDATA_FILE_ACCESS_COUNT 3996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org} UDataFileAccess; 4006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 4026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function may be called to control how ICU loads data. It must be called 4036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * before any ICU data is loaded, including application data loaded with 4046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * ures/ResourceBundle or udata APIs. This function is not multithread safe. 4056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The results of calling it while other threads are loading data are undefined. 4066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param access The type of file access to be used 4076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status Error code. 4086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see UDataFileAccess 4096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 3.4 4106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_STABLE void U_EXPORT2 4126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgudata_setFileAccess(UDataFileAccess access, UErrorCode *status); 4136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_CDECL_END 4156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#endif 417