Home | History | Annotate | Download | only in common 
      1 /*
      2 **********************************************************************
      3 *   Copyright (C) 1999-2009, International Business Machines
      4 *   Corporation and others.  All Rights Reserved.
      5 **********************************************************************
      6 *
      7 *
      8 *  ucnv_imp.h:
      9 *  Contains all internal and external data structure definitions
     10 * Created & Maitained by Bertrand A. Damiba
     11 *
     12 *
     13 *
     14 * ATTENTION:
     15 * ---------
     16 * Although the data structures in this file are open and stack allocatable
     17 * we reserve the right to hide them in further releases.
     18 */
     19 
     20 #ifndef UCNV_IMP_H
     21 #define UCNV_IMP_H
     22 
     23 #include "unicode/utypes.h"
     24 
     25 #if !UCONFIG_NO_CONVERSION
     26 
     27 #include "unicode/uloc.h"
     28 #include "ucnv_bld.h"
     29 
     30 /*
     31  * Fast check for whether a charset name is "UTF-8".
     32  * This does not recognize all of the variations that ucnv_open()
     33  * and other functions recognize, but it covers most cases.
     34  * @param name const char * charset name
     35  * @return
     36  */
     37 #define UCNV_FAST_IS_UTF8(name) \
     38     (((name[0]=='U' ? \
     39       (                name[1]=='T' && name[2]=='F') : \
     40       (name[0]=='u' && name[1]=='t' && name[2]=='f'))) \
     41   && (name[3]=='-' ? \
     42      (name[4]=='8' && name[5]==0) : \
     43      (name[3]=='8' && name[4]==0)))
     44 
     45 typedef struct {
     46     char cnvName[UCNV_MAX_CONVERTER_NAME_LENGTH];
     47     char locale[ULOC_FULLNAME_CAPACITY];
     48     uint32_t options;
     49 } UConverterNamePieces;
     50 
     51 U_CFUNC UBool
     52 ucnv_canCreateConverter(const char *converterName, UErrorCode *err);
     53 
     54 /* figures out if we need to go to file to read in the data tables.
     55  * @param converterName The name of the converter
     56  * @param err The error code
     57  * @return the newly created converter
     58  */
     59 UConverter *ucnv_createConverter (UConverter *myUConverter, const char *converterName, UErrorCode * err);
     60 
     61 /*
     62  * Open a purely algorithmic converter, specified by a type constant.
     63  * @param myUConverter  NULL, or pre-allocated UConverter structure to avoid
     64  *                      a memory allocation
     65  * @param type          requested converter type
     66  * @param locale        locale parameter, or ""
     67  * @param options       converter options bit set (default 0)
     68  * @param err           ICU error code, not tested for U_FAILURE on input
     69  *                      because this is an internal function
     70  * @internal
     71  */
     72 U_CFUNC UConverter *
     73 ucnv_createAlgorithmicConverter(UConverter *myUConverter,
     74                                 UConverterType type,
     75                                 const char *locale, uint32_t options,
     76                                 UErrorCode *err);
     77 
     78 /*
     79  * Creates a converter from shared data.
     80  * Adopts mySharedConverterData: No matter what happens, the caller must not
     81  * unload mySharedConverterData, except via ucnv_close(return value)
     82  * if this function is successful.
     83  */
     84 UConverter*
     85 ucnv_createConverterFromSharedData(UConverter *myUConverter,
     86                                    UConverterSharedData *mySharedConverterData,
     87                                    UConverterLoadArgs *pArgs,
     88                                    UErrorCode *err);
     89 
     90 UConverter* ucnv_createConverterFromPackage(const char *packageName, const char *converterName,
     91                                             UErrorCode *err);
     92 
     93 /**
     94  * Load a converter but do not create a UConverter object.
     95  * Simply return the UConverterSharedData.
     96  * Performs alias lookup etc.
     97  * The UConverterNamePieces need not be initialized
     98  * before calling this function.
     99  * The UConverterLoadArgs must be initialized
    100  * before calling this function.
    101  * If the args are passed in, then the pieces must be passed in too.
    102  * In other words, the following combinations are allowed:
    103  * - pieces==NULL && args==NULL
    104  * - pieces!=NULL && args==NULL
    105  * - pieces!=NULL && args!=NULL
    106  * @internal
    107  */
    108 UConverterSharedData *
    109 ucnv_loadSharedData(const char *converterName,
    110                     UConverterNamePieces *pieces,
    111                     UConverterLoadArgs *pArgs,
    112                     UErrorCode * err);
    113 
    114 /**
    115  * This may unload the shared data in a thread safe manner.
    116  * This will only unload the data if no other converters are sharing it.
    117  */
    118 void
    119 ucnv_unloadSharedDataIfReady(UConverterSharedData *sharedData);
    120 
    121 /**
    122  * This is a thread safe way to increment the reference count.
    123  */
    124 void
    125 ucnv_incrementRefCount(UConverterSharedData *sharedData);
    126 
    127 /**
    128  * These are the default error handling callbacks for the charset conversion framework.
    129  * For performance reasons, they are only called to handle an error (not normally called for a reset or close).
    130  */
    131 #define UCNV_TO_U_DEFAULT_CALLBACK ((UConverterToUCallback) UCNV_TO_U_CALLBACK_SUBSTITUTE)
    132 #define UCNV_FROM_U_DEFAULT_CALLBACK ((UConverterFromUCallback) UCNV_FROM_U_CALLBACK_SUBSTITUTE)
    133 
    134 #endif
    135 
    136 #endif /* _UCNV_IMP */
    137