| |
1 /* |
| |
2 ********************************************************************** |
| |
3 * Copyright (C) 2005-2012, International Business Machines |
| |
4 * Corporation and others. All Rights Reserved. |
| |
5 ********************************************************************** |
| |
6 */ |
| |
7 |
| |
8 #ifndef __CSRECOG_H |
| |
9 #define __CSRECOG_H |
| |
10 |
| |
11 #include "unicode/uobject.h" |
| |
12 |
| |
13 #if !UCONFIG_NO_CONVERSION |
| |
14 |
| |
15 #include "inputext.h" |
| |
16 |
| |
17 U_NAMESPACE_BEGIN |
| |
18 |
| |
19 class CharsetMatch; |
| |
20 |
| |
21 class CharsetRecognizer : public UMemory |
| |
22 { |
| |
23 public: |
| |
24 /** |
| |
25 * Get the IANA name of this charset. |
| |
26 * Note that some recognizers can recognize more than one charset, but that this API |
| |
27 * assumes just one name per recognizer. |
| |
28 * TODO: need to account for multiple names in public API that enumerates over the |
| |
29 * known detectable charsets. |
| |
30 * @return the charset name. |
| |
31 */ |
| |
32 virtual const char *getName() const = 0; |
| |
33 |
| |
34 /** |
| |
35 * Get the ISO language code for this charset. |
| |
36 * @return the language code, or <code>null</code> if the language cannot be determined. |
| |
37 */ |
| |
38 virtual const char *getLanguage() const; |
| |
39 |
| |
40 /* |
| |
41 * Try the given input text against this Charset, and fill in the results object |
| |
42 * with the quality of the match plus other information related to the match. |
| |
43 * |
| |
44 * Return TRUE if the the input bytes are a potential match, and |
| |
45 * FALSE if the input data is not compatible with, or illegal in this charset. |
| |
46 */ |
| |
47 virtual UBool match(InputText *textIn, CharsetMatch *results) const = 0; |
| |
48 |
| |
49 virtual ~CharsetRecognizer(); |
| |
50 }; |
| |
51 |
| |
52 U_NAMESPACE_END |
| |
53 |
| |
54 #endif |
| |
55 #endif /* __CSRECOG_H */ |