bump product version to 6.3.0.0.beta1
[LibreOffice.git] / include / rtl / textcvt.h
blob09c33b1cb0ed18ce786119aa980cc42891b52034
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3 * This file is part of the LibreOffice project.
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 * This file incorporates work covered by the following license notice:
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
20 #ifndef INCLUDED_RTL_TEXTCVT_H
21 #define INCLUDED_RTL_TEXTCVT_H
23 #include "sal/config.h"
25 #include "rtl/textenc.h"
26 #include "sal/saldllapi.h"
27 #include "sal/types.h"
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
33 /* Documentation about this file can be found at
34 <http://udk.openoffice.org/cpp/man/spec/textconversion.html>. */
36 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
38 typedef void* rtl_TextToUnicodeConverter;
40 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
42 typedef void* rtl_TextToUnicodeContext;
44 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
46 SAL_DLLPUBLIC rtl_TextToUnicodeConverter SAL_CALL rtl_createTextToUnicodeConverter( rtl_TextEncoding eTextEncoding );
48 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
50 SAL_DLLPUBLIC void SAL_CALL rtl_destroyTextToUnicodeConverter( rtl_TextToUnicodeConverter hConverter );
52 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
54 SAL_DLLPUBLIC rtl_TextToUnicodeContext SAL_CALL rtl_createTextToUnicodeContext( rtl_TextToUnicodeConverter hConverter );
56 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
58 SAL_DLLPUBLIC void SAL_CALL rtl_destroyTextToUnicodeContext( rtl_TextToUnicodeConverter hConverter, rtl_TextToUnicodeContext hContext );
60 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
62 SAL_DLLPUBLIC void SAL_CALL rtl_resetTextToUnicodeContext( rtl_TextToUnicodeConverter hConverter, rtl_TextToUnicodeContext hContext );
64 #define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR ((sal_uInt32)0x0001)
65 #define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_IGNORE ((sal_uInt32)0x0002)
66 #define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_MAPTOPRIVATE ((sal_uInt32)0x0003)
67 #define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_DEFAULT ((sal_uInt32)0x0004)
68 #define RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR ((sal_uInt32)0x0010)
69 #define RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_IGNORE ((sal_uInt32)0x0020)
70 #define RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_DEFAULT ((sal_uInt32)0x0030)
71 #define RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR ((sal_uInt32)0x0100)
72 #define RTL_TEXTTOUNICODE_FLAGS_INVALID_IGNORE ((sal_uInt32)0x0200)
73 #define RTL_TEXTTOUNICODE_FLAGS_INVALID_DEFAULT ((sal_uInt32)0x0300)
74 #define RTL_TEXTTOUNICODE_FLAGS_FLUSH ((sal_uInt32)0x8000)
75 #define RTL_TEXTTOUNICODE_FLAGS_GLOBAL_SIGNATURE 0x10000
76 /* Accept any global document signatures (for example, in UTF-8, a leading
77 EF BB BF encoding the Byte Order Mark U+FEFF) */
79 #define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_MASK ((sal_uInt32)0x000F)
80 #define RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_MASK ((sal_uInt32)0x00F0)
81 #define RTL_TEXTTOUNICODE_FLAGS_INVALID_MASK ((sal_uInt32)0x0F00)
83 #define RTL_TEXTTOUNICODE_INFO_ERROR ((sal_uInt32)0x0001)
84 // Misspelled constant, kept for backwards compatibility:
85 #define RTL_TEXTTOUNICODE_INFO_SRCBUFFERTOSMALL ((sal_uInt32)0x0002)
86 #define RTL_TEXTTOUNICODE_INFO_SRCBUFFERTOOSMALL ((sal_uInt32)0x0002)
87 // Misspelled constant, kept for backwards compatibility:
88 #define RTL_TEXTTOUNICODE_INFO_DESTBUFFERTOSMALL ((sal_uInt32)0x0004)
89 #define RTL_TEXTTOUNICODE_INFO_DESTBUFFERTOOSMALL ((sal_uInt32)0x0004)
90 #define RTL_TEXTTOUNICODE_INFO_UNDEFINED ((sal_uInt32)0x0008)
91 #define RTL_TEXTTOUNICODE_INFO_MBUNDEFINED ((sal_uInt32)0x0010)
92 #define RTL_TEXTTOUNICODE_INFO_INVALID ((sal_uInt32)0x0020)
94 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
96 SAL_DLLPUBLIC sal_Size SAL_CALL rtl_convertTextToUnicode(
97 rtl_TextToUnicodeConverter hConverter,
98 rtl_TextToUnicodeContext hContext,
99 const sal_Char* pSrcBuf, sal_Size nSrcBytes,
100 sal_Unicode* pDestBuf, sal_Size nDestChars,
101 sal_uInt32 nFlags, sal_uInt32* pInfo,
102 sal_Size* pSrcCvtBytes );
104 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
106 typedef void* rtl_UnicodeToTextConverter;
108 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
110 typedef void* rtl_UnicodeToTextContext;
112 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
114 SAL_DLLPUBLIC rtl_UnicodeToTextConverter SAL_CALL rtl_createUnicodeToTextConverter( rtl_TextEncoding eTextEncoding );
116 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
118 SAL_DLLPUBLIC void SAL_CALL rtl_destroyUnicodeToTextConverter( rtl_UnicodeToTextConverter hConverter );
120 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
122 SAL_DLLPUBLIC rtl_UnicodeToTextContext SAL_CALL rtl_createUnicodeToTextContext( rtl_UnicodeToTextConverter hConverter );
124 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
126 SAL_DLLPUBLIC void SAL_CALL rtl_destroyUnicodeToTextContext( rtl_UnicodeToTextConverter hConverter, rtl_UnicodeToTextContext hContext );
128 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
130 SAL_DLLPUBLIC void SAL_CALL rtl_resetUnicodeToTextContext( rtl_UnicodeToTextConverter hConverter, rtl_UnicodeToTextContext hContext );
132 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_ERROR ((sal_uInt32)0x0001)
133 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_IGNORE ((sal_uInt32)0x0002)
134 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_0 ((sal_uInt32)0x0003)
135 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_QUESTIONMARK ((sal_uInt32)0x0004)
136 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_UNDERLINE ((sal_uInt32)0x0005)
137 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_DEFAULT ((sal_uInt32)0x0006)
138 #define RTL_UNICODETOTEXT_FLAGS_INVALID_ERROR ((sal_uInt32)0x0010)
139 #define RTL_UNICODETOTEXT_FLAGS_INVALID_IGNORE ((sal_uInt32)0x0020)
140 #define RTL_UNICODETOTEXT_FLAGS_INVALID_0 ((sal_uInt32)0x0030)
141 #define RTL_UNICODETOTEXT_FLAGS_INVALID_QUESTIONMARK ((sal_uInt32)0x0040)
142 #define RTL_UNICODETOTEXT_FLAGS_INVALID_UNDERLINE ((sal_uInt32)0x0050)
143 #define RTL_UNICODETOTEXT_FLAGS_INVALID_DEFAULT ((sal_uInt32)0x0060)
144 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_REPLACE ((sal_uInt32)0x0100)
145 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_REPLACESTR ((sal_uInt32)0x0200)
146 #define RTL_UNICODETOTEXT_FLAGS_PRIVATE_MAPTO0 ((sal_uInt32)0x0400)
147 #define RTL_UNICODETOTEXT_FLAGS_NONSPACING_IGNORE ((sal_uInt32)0x0800)
148 #define RTL_UNICODETOTEXT_FLAGS_CONTROL_IGNORE ((sal_uInt32)0x1000)
149 #define RTL_UNICODETOTEXT_FLAGS_PRIVATE_IGNORE ((sal_uInt32)0x2000)
150 #define RTL_UNICODETOTEXT_FLAGS_NOCOMPOSITE ((sal_uInt32)0x4000) ///< has no effect @deprecated
151 #define RTL_UNICODETOTEXT_FLAGS_FLUSH ((sal_uInt32)0x8000)
152 #define RTL_UNICODETOTEXT_FLAGS_GLOBAL_SIGNATURE 0x10000
153 /* Write any global document signatures (for example, in UTF-8, a leading
154 EF BB BF encoding the Byte Order Mark U+FEFF) */
156 #define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_MASK ((sal_uInt32)0x000F)
157 #define RTL_UNICODETOTEXT_FLAGS_INVALID_MASK ((sal_uInt32)0x00F0)
159 #define RTL_UNICODETOTEXT_INFO_ERROR ((sal_uInt32)0x0001)
160 #define RTL_UNICODETOTEXT_INFO_SRCBUFFERTOSMALL ((sal_uInt32)0x0002)
161 #define RTL_UNICODETOTEXT_INFO_DESTBUFFERTOSMALL ((sal_uInt32)0x0004)
162 #define RTL_UNICODETOTEXT_INFO_UNDEFINED ((sal_uInt32)0x0008)
163 #define RTL_UNICODETOTEXT_INFO_INVALID ((sal_uInt32)0x0010)
165 /** see http://udk.openoffice.org/cpp/man/spec/textconversion.html
167 SAL_DLLPUBLIC sal_Size SAL_CALL rtl_convertUnicodeToText(
168 rtl_UnicodeToTextConverter hConverter,
169 rtl_UnicodeToTextContext hContext,
170 const sal_Unicode* pSrcBuf, sal_Size nSrcChars,
171 sal_Char* pDestBuf, sal_Size nDestBytes,
172 sal_uInt32 nFlags, sal_uInt32* pInfo,
173 sal_Size* pSrcCvtChars );
175 #ifdef __cplusplus
177 #endif
179 #endif // INCLUDED_RTL_TEXTCVT_H
181 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */