xref: /aosp_15_r20/external/icu/libicu/cts_headers/ustr_cnv.h (revision 0e209d3975ff4a8c132096b14b0e9364a753506e)
1*0e209d39SAndroid Build Coastguard Worker // © 2016 and later: Unicode, Inc. and others.
2*0e209d39SAndroid Build Coastguard Worker // License & terms of use: http://www.unicode.org/copyright.html
3*0e209d39SAndroid Build Coastguard Worker /*
4*0e209d39SAndroid Build Coastguard Worker **********************************************************************
5*0e209d39SAndroid Build Coastguard Worker *   Copyright (C) 1999-2010, International Business Machines
6*0e209d39SAndroid Build Coastguard Worker *   Corporation and others.  All Rights Reserved.
7*0e209d39SAndroid Build Coastguard Worker **********************************************************************
8*0e209d39SAndroid Build Coastguard Worker *   file name:  ustr_cnv.h
9*0e209d39SAndroid Build Coastguard Worker *   encoding:   UTF-8
10*0e209d39SAndroid Build Coastguard Worker *   tab size:   8 (not used)
11*0e209d39SAndroid Build Coastguard Worker *   indentation:4
12*0e209d39SAndroid Build Coastguard Worker *
13*0e209d39SAndroid Build Coastguard Worker *   created on: 2004Aug27
14*0e209d39SAndroid Build Coastguard Worker *   created by: George Rhoten
15*0e209d39SAndroid Build Coastguard Worker */
16*0e209d39SAndroid Build Coastguard Worker 
17*0e209d39SAndroid Build Coastguard Worker #ifndef USTR_CNV_IMP_H
18*0e209d39SAndroid Build Coastguard Worker #define USTR_CNV_IMP_H
19*0e209d39SAndroid Build Coastguard Worker 
20*0e209d39SAndroid Build Coastguard Worker #include "unicode/utypes.h"
21*0e209d39SAndroid Build Coastguard Worker #include "unicode/ucnv.h"
22*0e209d39SAndroid Build Coastguard Worker 
23*0e209d39SAndroid Build Coastguard Worker #if !UCONFIG_NO_CONVERSION
24*0e209d39SAndroid Build Coastguard Worker 
25*0e209d39SAndroid Build Coastguard Worker /**
26*0e209d39SAndroid Build Coastguard Worker  * Get the default converter. This is a commonly used converter
27*0e209d39SAndroid Build Coastguard Worker  * that is used for the ustring and UnicodeString API.
28*0e209d39SAndroid Build Coastguard Worker  * Remember to use the u_releaseDefaultConverter when you are done.
29*0e209d39SAndroid Build Coastguard Worker  * @internal
30*0e209d39SAndroid Build Coastguard Worker  */
31*0e209d39SAndroid Build Coastguard Worker U_CAPI UConverter* U_EXPORT2
32*0e209d39SAndroid Build Coastguard Worker u_getDefaultConverter(UErrorCode *status);
33*0e209d39SAndroid Build Coastguard Worker 
34*0e209d39SAndroid Build Coastguard Worker 
35*0e209d39SAndroid Build Coastguard Worker /**
36*0e209d39SAndroid Build Coastguard Worker  * Release the default converter to the converter cache.
37*0e209d39SAndroid Build Coastguard Worker  * @internal
38*0e209d39SAndroid Build Coastguard Worker  */
39*0e209d39SAndroid Build Coastguard Worker U_CAPI void U_EXPORT2
40*0e209d39SAndroid Build Coastguard Worker u_releaseDefaultConverter(UConverter *converter);
41*0e209d39SAndroid Build Coastguard Worker 
42*0e209d39SAndroid Build Coastguard Worker /**
43*0e209d39SAndroid Build Coastguard Worker  * Flush the default converter, if cached.
44*0e209d39SAndroid Build Coastguard Worker  * @internal
45*0e209d39SAndroid Build Coastguard Worker  */
46*0e209d39SAndroid Build Coastguard Worker U_CAPI void U_EXPORT2
47*0e209d39SAndroid Build Coastguard Worker u_flushDefaultConverter(void);
48*0e209d39SAndroid Build Coastguard Worker 
49*0e209d39SAndroid Build Coastguard Worker #endif
50*0e209d39SAndroid Build Coastguard Worker 
51*0e209d39SAndroid Build Coastguard Worker #endif
52