Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
alphaindex.h	25.29 KB	-rw-r--r--
appendable.h	8.38 KB	-rw-r--r--
basictz.h	8.77 KB	-rw-r--r--
bms.h	8.68 KB	-rw-r--r--
bmsearch.h	7.33 KB	-rw-r--r--
brkiter.h	24.24 KB	-rw-r--r--
bytestream.h	9.16 KB	-rw-r--r--
bytestrie.h	19.19 KB	-rw-r--r--
bytestriebuilder.h	6.73 KB	-rw-r--r--
calendar.h	102.76 KB	-rw-r--r--
caniter.h	7.23 KB	-rw-r--r--
chariter.h	23.71 KB	-rw-r--r--
choicfmt.h	27.82 KB	-rw-r--r--
coleitr.h	12.69 KB	-rw-r--r--
coll.h	53.44 KB	-rw-r--r--
colldata.h	12.42 KB	-rw-r--r--
curramt.h	3.57 KB	-rw-r--r--
currpinf.h	6.93 KB	-rw-r--r--
currunit.h	2.99 KB	-rw-r--r--
datefmt.h	33.67 KB	-rw-r--r--
dbbi.h	966 B	-rw-r--r--
dcfmtsym.h	14.91 KB	-rw-r--r--
decimfmt.h	97.38 KB	-rw-r--r--
docmain.h	6.28 KB	-rw-r--r--
dtfmtsym.h	30.27 KB	-rw-r--r--
dtintrv.h	3.65 KB	-rw-r--r--
dtitvfmt.h	39.24 KB	-rw-r--r--
dtitvinf.h	18.56 KB	-rw-r--r--
dtptngen.h	19.54 KB	-rw-r--r--
dtrule.h	8.51 KB	-rw-r--r--
enumset.h	1.8 KB	-rw-r--r--
errorcode.h	4.67 KB	-rw-r--r--
fieldpos.h	8.51 KB	-rw-r--r--
fmtable.h	22.09 KB	-rw-r--r--
format.h	12.33 KB	-rw-r--r--
fpositer.h	2.97 KB	-rw-r--r--
gender.h	3.02 KB	-rw-r--r--
gregocal.h	33.28 KB	-rw-r--r--
icudataver.h	990 B	-rw-r--r--
icuplug.h	11.49 KB	-rw-r--r--
idna.h	12.68 KB	-rw-r--r--
listformatter.h	3.97 KB	-rw-r--r--
localpointer.h	9.13 KB	-rw-r--r--
locdspnm.h	7.14 KB	-rw-r--r--
locid.h	30.48 KB	-rw-r--r--
measfmt.h	1.94 KB	-rw-r--r--
measunit.h	1.6 KB	-rw-r--r--
measure.h	3.24 KB	-rw-r--r--
messagepattern.h	33.6 KB	-rw-r--r--
msgfmt.h	43.59 KB	-rw-r--r--
normalizer2.h	28.34 KB	-rw-r--r--
normlzr.h	29.26 KB	-rw-r--r--
numfmt.h	43.59 KB	-rw-r--r--
numsys.h	5.37 KB	-rw-r--r--
parseerr.h	2.97 KB	-rw-r--r--
parsepos.h	5.34 KB	-rw-r--r--
platform.h	24.23 KB	-rw-r--r--
plurfmt.h	24.58 KB	-rw-r--r--
plurrule.h	14.56 KB	-rw-r--r--
ptypes.h	3.36 KB	-rw-r--r--
putil.h	5.61 KB	-rw-r--r--
rbbi.h	29.15 KB	-rw-r--r--
rbnf.h	45.32 KB	-rw-r--r--
rbtz.h	15.33 KB	-rw-r--r--
regex.h	83.1 KB	-rw-r--r--
rep.h	9.33 KB	-rw-r--r--
resbund.h	17.89 KB	-rw-r--r--
schriter.h	6.15 KB	-rw-r--r--
search.h	22.1 KB	-rw-r--r--
selfmt.h	14.13 KB	-rw-r--r--
simpletz.h	45.1 KB	-rw-r--r--
smpdtfmt.h	57.58 KB	-rw-r--r--
sortkey.h	10.98 KB	-rw-r--r--
std_string.h	783 B	-rw-r--r--
strenum.h	9.92 KB	-rw-r--r--
stringpiece.h	6.38 KB	-rw-r--r--
stringtriebuilder.h	14.75 KB	-rw-r--r--
stsearch.h	21.76 KB	-rw-r--r--
symtable.h	4.1 KB	-rw-r--r--
tblcoll.h	34.23 KB	-rw-r--r--
timezone.h	37.28 KB	-rw-r--r--
tmunit.h	3.39 KB	-rw-r--r--
tmutamt.h	4.69 KB	-rw-r--r--
tmutfmt.h	8.51 KB	-rw-r--r--
translit.h	53.76 KB	-rw-r--r--
tzfmt.h	32.06 KB	-rw-r--r--
tznames.h	14.83 KB	-rw-r--r--
tzrule.h	35.21 KB	-rw-r--r--
tztrans.h	5.96 KB	-rw-r--r--
ubidi.h	88.57 KB	-rw-r--r--
ubrk.h	19.13 KB	-rw-r--r--
ucal.h	50.49 KB	-rw-r--r--
ucasemap.h	16.45 KB	-rw-r--r--
ucat.h	5.25 KB	-rw-r--r--
uchar.h	115.43 KB	-rw-r--r--
ucharstrie.h	20.8 KB	-rw-r--r--
ucharstriebuilder.h	6.83 KB	-rw-r--r--
uchriter.h	12.82 KB	-rw-r--r--
uclean.h	10.38 KB	-rw-r--r--
ucnv.h	82.6 KB	-rw-r--r--
ucnv_cb.h	6.48 KB	-rw-r--r--
ucnv_err.h	20.87 KB	-rw-r--r--
ucnvsel.h	6.03 KB	-rw-r--r--
ucol.h	57.93 KB	-rw-r--r--
ucoleitr.h	12.25 KB	-rw-r--r--
uconfig.h	10.79 KB	-rw-r--r--
ucsdet.h	12.6 KB	-rw-r--r--
ucurr.h	12.96 KB	-rw-r--r--
udat.h	46.47 KB	-rw-r--r--
udata.h	14.81 KB	-rw-r--r--
udateintervalformat.h	6.5 KB	-rw-r--r--
udatpg.h	23.24 KB	-rw-r--r--
udisplaycontext.h	4.34 KB	-rw-r--r--
uenum.h	7.79 KB	-rw-r--r--
ugender.h	1.85 KB	-rw-r--r--
uidna.h	32.81 KB	-rw-r--r--
uiter.h	22.67 KB	-rw-r--r--
uldnames.h	10.5 KB	-rw-r--r--
uloc.h	44.07 KB	-rw-r--r--
ulocdata.h	10.37 KB	-rw-r--r--
umachine.h	10.23 KB	-rw-r--r--
umisc.h	1.23 KB	-rw-r--r--
umsg.h	24.12 KB	-rw-r--r--
unifilt.h	3.52 KB	-rw-r--r--
unifunct.h	3.87 KB	-rw-r--r--
unimatch.h	5.93 KB	-rw-r--r--
unirepl.h	3.21 KB	-rw-r--r--
uniset.h	63.07 KB	-rw-r--r--
unistr.h	164.33 KB	-rw-r--r--
unorm.h	22.89 KB	-rw-r--r--
unorm2.h	21.91 KB	-rw-r--r--
unum.h	39.21 KB	-rw-r--r--
uobject.h	12.21 KB	-rw-r--r--
upluralrules.h	4.47 KB	-rw-r--r--
uregex.h	71.47 KB	-rw-r--r--
urename.h	120.88 KB	-rw-r--r--
urep.h	5.27 KB	-rw-r--r--
ures.h	35.92 KB	-rw-r--r--
uscript.h	20.46 KB	-rw-r--r--
usearch.h	36.09 KB	-rw-r--r--
uset.h	39.45 KB	-rw-r--r--
usetiter.h	9.38 KB	-rw-r--r--
ushape.h	17.89 KB	-rw-r--r--
uspoof.h	38.91 KB	-rw-r--r--
usprep.h	8.02 KB	-rw-r--r--
ustdio.h	37.05 KB	-rw-r--r--
ustream.h	1.6 KB	-rw-r--r--
ustring.h	73.01 KB	-rw-r--r--
ustringtrie.h	3.04 KB	-rw-r--r--
utext.h	57.97 KB	-rw-r--r--
utf.h	7.64 KB	-rw-r--r--
utf16.h	18.24 KB	-rw-r--r--
utf32.h	653 B	-rw-r--r--
utf8.h	23.02 KB	-rw-r--r--
utf_old.h	42.5 KB	-rw-r--r--
utmscale.h	13.37 KB	-rw-r--r--
utrace.h	13.09 KB	-rw-r--r--
utrans.h	23.08 KB	-rw-r--r--
utypes.h	30.72 KB	-rw-r--r--
uvernum.h	5.53 KB	-rw-r--r--
uversion.h	6.29 KB	-rw-r--r--
vtzone.h	20.09 KB	-rw-r--r--

Code Editor : udata.h

/*
******************************************************************************
*
*   Copyright (C) 1999-2012, International Business Machines
*   Corporation and others.  All Rights Reserved.
*
******************************************************************************
*   file name:  udata.h
*   encoding:   US-ASCII
*   tab size:   8 (not used)
*   indentation:4
*
*   created on: 1999oct25
*   created by: Markus W. Scherer
*/

#ifndef __UDATA_H__
#define __UDATA_H__

#include "unicode/utypes.h"
#include "unicode/localpointer.h"

U_CDECL_BEGIN

/**
 * \file
 * \brief C API: Data loading interface
 *
 * <h2>Information about data loading interface</h2>
 *
 * This API is used to find and efficiently load data for ICU and applications
 * using ICU. It provides an abstract interface that specifies a data type and
 * name to find and load the data. Normally this API is used by other ICU APIs
 * to load required data out of the ICU data library, but it can be used to
 * load data out of other places.
 *
 * See the User Guide Data Management chapter.
 */
 
#ifndef U_HIDE_INTERNAL_API
/**
 * Character used to separate package names from tree names 
 * @internal ICU 3.0
 */
#define U_TREE_SEPARATOR '-'

/**
 * String used to separate package names from tree names 
 * @internal ICU 3.0
 */
#define U_TREE_SEPARATOR_STRING "-"

/**
 * Character used to separate parts of entry names
 * @internal ICU 3.0
 */
#define U_TREE_ENTRY_SEP_CHAR '/'

/**
 * String used to separate parts of entry names
 * @internal ICU 3.0
 */
#define U_TREE_ENTRY_SEP_STRING "/"

/**
 * Alias for standard ICU data 
 * @internal ICU 3.0
 */
#define U_ICUDATA_ALIAS "ICUDATA"

#endif /* U_HIDE_INTERNAL_API */

/**
 * UDataInfo contains the properties about the requested data.
 * This is meta data.
 *
 * This structure may grow in the future, indicated by the
 * <code>size</code> field.
 *
 * The platform data property fields help determine if a data
 * file can be efficiently used on a given machine.
 * The particular fields are of importance only if the data
 * is affected by the properties - if there is integer data
 * with word sizes > 1 byte, char* text, or UChar* text.
 *
 * The implementation for the <code>udata_open[Choice]()</code>
 * functions may reject data based on the value in <code>isBigEndian</code>.
 * No other field is used by the <code>udata</code> API implementation.
 *
 * The <code>dataFormat</code> may be used to identify
 * the kind of data, e.g. a converter table.
 *
 * The <code>formatVersion</code> field should be used to
 * make sure that the format can be interpreted.
 * I may be a good idea to check only for the one or two highest
 * of the version elements to allow the data memory to
 * get more or somewhat rearranged contents, for as long
 * as the using code can still interpret the older contents.
 *
 * The <code>dataVersion</code> field is intended to be a
 * common place to store the source version of the data;
 * for data from the Unicode character database, this could
 * reflect the Unicode version.
 * @stable ICU 2.0
 */
typedef struct {
 /** sizeof(UDataInfo)
 * @stable ICU 2.0 */
 uint16_t size;

/** unused, set to 0 
     *  @stable ICU 2.0*/
    uint16_t reservedWord;

/* platform data properties */
    /** 0 for little-endian machine, 1 for big-endian
     *  @stable ICU 2.0 */
    uint8_t isBigEndian;

/** see U_CHARSET_FAMILY values in utypes.h 
     *  @stable ICU 2.0*/
    uint8_t charsetFamily;

/** sizeof(UChar), one of { 1, 2, 4 } 
     *  @stable ICU 2.0*/
    uint8_t sizeofUChar;

/** unused, set to 0 
     *  @stable ICU 2.0*/
    uint8_t reservedByte;

/** data format identifier 
     *  @stable ICU 2.0*/
    uint8_t dataFormat[4];

/** versions: [0] major [1] minor [2] milli [3] micro 
     *  @stable ICU 2.0*/
    uint8_t formatVersion[4];

/** versions: [0] major [1] minor [2] milli [3] micro 
     *  @stable ICU 2.0*/
    uint8_t dataVersion[4];
} UDataInfo;

/* API for reading data -----------------------------------------------------*/

/**
 * Forward declaration of the data memory type.
 * @stable ICU 2.0
 */
typedef struct UDataMemory UDataMemory;

/**
 * Callback function for udata_openChoice().
 * @param context parameter passed into <code>udata_openChoice()</code>.
 * @param type The type of the data as passed into <code>udata_openChoice()</code>.
 * It may be <code>NULL</code>.
 * @param name The name of the data as passed into <code>udata_openChoice()</code>.
 * @param pInfo A pointer to the <code>UDataInfo</code> structure
 * of data that has been loaded and will be returned
 * by <code>udata_openChoice()</code> if this function
 * returns <code>TRUE</code>.
 * @return TRUE if the current data memory is acceptable
 * @stable ICU 2.0
 */
typedef UBool U_CALLCONV
UDataMemoryIsAcceptable(void *context,
 const char *type, const char *name,
 const UDataInfo *pInfo);

/**
 * Convenience function.
 * This function works the same as <code>udata_openChoice</code>
 * except that any data that matches the type and name
 * is assumed to be acceptable.
 * @param path Specifies an absolute path and/or a basename for the
 * finding of the data in the file system.
 * <code>NULL</code> for ICU data.
 * @param type A string that specifies the type of data to be loaded.
 * For example, resource bundles are loaded with type "res",
 * conversion tables with type "cnv".
 * This may be <code>NULL</code> or empty.
 * @param name A string that specifies the name of the data.
 * @param pErrorCode An ICU UErrorCode parameter. It must not be <code>NULL</code>.
 * @return A pointer (handle) to a data memory object, or <code>NULL</code>
 * if an error occurs. Call <code>udata_getMemory()</code>
 * to get a pointer to the actual data.
 *
 * @see udata_openChoice
 * @stable ICU 2.0
 */
U_STABLE UDataMemory * U_EXPORT2
udata_open(const char *path, const char *type, const char *name,
 UErrorCode *pErrorCode);

/**
 * Data loading function.
 * This function is used to find and load efficiently data for
 * ICU and applications using ICU.
 * It provides an abstract interface that allows to specify a data
 * type and name to find and load the data.
 *
 * The implementation depends on platform properties and user preferences
 * and may involve loading shared libraries (DLLs), mapping
 * files into memory, or fopen()/fread() files.
 * It may also involve using static memory or database queries etc.
 * Several or all data items may be combined into one entity
 * (DLL, memory-mappable file).
 *
 * The data is always preceded by a header that includes
 * a <code>UDataInfo</code> structure.
 * The caller's <code>isAcceptable()</code> function is called to make
 * sure that the data is useful. It may be called several times if it
 * rejects the data and there is more than one location with data
 * matching the type and name.
 *
 * If <code>path==NULL</code>, then ICU data is loaded.
 * Otherwise, it is separated into a basename and a basename-less directory string.
 * The basename is used as the data package name, and the directory is
 * logically prepended to the ICU data directory string.
 *
 * For details about ICU data loading see the User Guide
 * Data Management chapter. (http://icu-project.org/userguide/icudata.html)
 *
 * @param path Specifies an absolute path and/or a basename for the
 * finding of the data in the file system.
 * <code>NULL</code> for ICU data.
 * @param type A string that specifies the type of data to be loaded.
 * For example, resource bundles are loaded with type "res",
 * conversion tables with type "cnv".
 * This may be <code>NULL</code> or empty.
 * @param name A string that specifies the name of the data.
 * @param isAcceptable This function is called to verify that loaded data
 * is useful for the client code. If it returns FALSE
 * for all data items, then <code>udata_openChoice()</code>
 * will return with an error.
 * @param context Arbitrary parameter to be passed into isAcceptable.
 * @param pErrorCode An ICU UErrorCode parameter. It must not be <code>NULL</code>.
 * @return A pointer (handle) to a data memory object, or <code>NULL</code>
 * if an error occurs. Call <code>udata_getMemory()</code>
 * to get a pointer to the actual data.
 * @stable ICU 2.0
 */
U_STABLE UDataMemory * U_EXPORT2
udata_openChoice(const char *path, const char *type, const char *name,
 UDataMemoryIsAcceptable *isAcceptable, void *context,
 UErrorCode *pErrorCode);

/**
 * Close the data memory.
 * This function must be called to allow the system to
 * release resources associated with this data memory.
 * @param pData The pointer to data memory object
 * @stable ICU 2.0
 */
U_STABLE void U_EXPORT2
udata_close(UDataMemory *pData);

#if U_SHOW_CPLUSPLUS_API

U_NAMESPACE_BEGIN

/**
 * \class LocalUDataMemoryPointer
 * "Smart pointer" class, closes a UDataMemory via udata_close().
 * For most methods see the LocalPointerBase base class.
 *
 * @see LocalPointerBase
 * @see LocalPointer
 * @stable ICU 4.4
 */
U_DEFINE_LOCAL_OPEN_POINTER(LocalUDataMemoryPointer, UDataMemory, udata_close);

U_NAMESPACE_END

#endif

/**
 * Get the pointer to the actual data inside the data memory.
 * The data is read-only.
 * @param pData The pointer to data memory object
 * @stable ICU 2.0
 */
U_STABLE const void * U_EXPORT2
udata_getMemory(UDataMemory *pData);

/**
 * Get the information from the data memory header.
 * This allows to get access to the header containing
 * platform data properties etc. which is not part of
 * the data itself and can therefore not be accessed
 * via the pointer that <code>udata_getMemory()</code> returns.
 *
 * @param pData pointer to the data memory object
 * @param pInfo pointer to a UDataInfo object;
 * its <code>size</code> field must be set correctly,
 * typically to <code>sizeof(UDataInfo)</code>.
 *
 * <code>*pInfo</code> will be filled with the UDataInfo structure
 * in the data memory object. If this structure is smaller than
 * <code>pInfo->size</code>, then the <code>size</code> will be
 * adjusted and only part of the structure will be filled.
 * @stable ICU 2.0
 */
U_STABLE void U_EXPORT2
udata_getInfo(UDataMemory *pData, UDataInfo *pInfo);

/**
 * This function bypasses the normal ICU data loading process and
 * allows you to force ICU's system data to come out of a user-specified
 * area in memory.
 *
 * The format of this data is that of the icu common data file, as is
 * generated by the pkgdata tool with mode=common or mode=dll.
 * You can read in a whole common mode file and pass the address to the start of the
 * data, or (with the appropriate link options) pass in the pointer to
 * the data that has been loaded from a dll by the operating system,
 * as shown in this code:
 *
 * extern const char U_IMPORT U_ICUDATA_ENTRY_POINT [];
 * // U_ICUDATA_ENTRY_POINT is same as entry point specified to pkgdata tool
 * UErrorCode status = U_ZERO_ERROR;
 *
 * udata_setCommonData(&U_ICUDATA_ENTRY_POINT, &status);
 *
 * It is important that the declaration be as above. The entry point
 * must not be declared as an extern void*.
 *
 * Starting with ICU 4.4, it is possible to set several data packages,
 * one per call to this function.
 * udata_open() will look for data in the multiple data packages in the order
 * in which they were set.
 * The position of the linked-in or default-name ICU .data package in the
 * search list depends on when the first data item is loaded that is not contained
 * in the already explicitly set packages.
 * If data was loaded implicitly before the first call to this function
 * (for example, via opening a converter, constructing a UnicodeString
 * from default-codepage data, using formatting or collation APIs, etc.),
 * then the default data will be first in the list.
 *
 * This function has no effect on application (non ICU) data. See udata_setAppData()
 * for similar functionality for application data.
 *
 * @param data pointer to ICU common data
 * @param err outgoing error status <code>U_USING_DEFAULT_WARNING, U_UNSUPPORTED_ERROR</code>
 * @stable ICU 2.0
 */
U_STABLE void U_EXPORT2
udata_setCommonData(const void *data, UErrorCode *err);

/**
 * This function bypasses the normal ICU data loading process for application-specific
 * data and allows you to force the it to come out of a user-specified
 * pointer.
 *
 * The format of this data is that of the icu common data file, like 'icudt26l.dat'
 * or the corresponding shared library (DLL) file.
 * The application must read in or otherwise construct an image of the data and then
 * pass the address of it to this function.
 *
 *
 * Warning: setAppData will set a U_USING_DEFAULT_WARNING code if
 * data with the specifed path that has already been opened, or
 * if setAppData with the same path has already been called.
 * Any such calls to setAppData will have no effect.
 *
 *
 * @param packageName the package name by which the application will refer
 * to (open) this data
 * @param data pointer to the data
 * @param err outgoing error status <code>U_USING_DEFAULT_WARNING, U_UNSUPPORTED_ERROR</code>
 * @see udata_setCommonData
 * @stable ICU 2.0
 */
U_STABLE void U_EXPORT2
udata_setAppData(const char *packageName, const void *data, UErrorCode *err);

/**
 * Possible settings for udata_setFileAccess()
 * @see udata_setFileAccess
 * @stable ICU 3.4
 */
typedef enum UDataFileAccess {
    /** ICU looks for data in single files first, then in packages. (default) @stable ICU 3.4 */
    UDATA_FILES_FIRST,
    /** An alias for the default access mode. @stable ICU 3.4 */
    UDATA_DEFAULT_ACCESS = UDATA_FILES_FIRST,
    /** ICU only loads data from packages, not from single files. @stable ICU 3.4 */
    UDATA_ONLY_PACKAGES,
    /** ICU loads data from packages first, and only from single files
        if the data cannot be found in a package. @stable ICU 3.4 */
    UDATA_PACKAGES_FIRST,
    /** ICU does not access the file system for data loading. @stable ICU 3.4 */
    UDATA_NO_FILES,
    /** Number of real UDataFileAccess values. @stable ICU 3.4 */
    UDATA_FILE_ACCESS_COUNT
} UDataFileAccess;

/**
 * This function may be called to control how ICU loads data. It must be called
 * before any ICU data is loaded, including application data loaded with 
 * ures/ResourceBundle or udata APIs. This function is not multithread safe.  
 * The results of calling it while other threads are loading data are undefined.
 * @param access The type of file access to be used
 * @param status Error code.
 * @see UDataFileAccess
 * @stable ICU 3.4 
 */
U_STABLE void U_EXPORT2
udata_setFileAccess(UDataFileAccess access, UErrorCode *status);

U_CDECL_END

#endif

${this.title}

Code Editor : udata.h