/usr/include/opencc/opencc.h is in libopencc-dev 0.3.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 | /*
* Open Chinese Convert
*
* Copyright 2010 BYVoid <byvoid.kcp@gmail.com>
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __OPENCC_H_
#define __OPENCC_H_
#include "opencc_types.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
* Headers from C standard library
*/
/* Macros */
#define OPENCC_DEFAULT_CONFIG_SIMP_TO_TRAD "zhs2zht.ini"
#define OPENCC_DEFAULT_CONFIG_TRAD_TO_SIMP "zht2zhs.ini"
/**
* opencc_open:
* @config_file: Location of configuration file.
* @returns: A description pointer of the newly allocated instance of opencc.
*
* Make an instance of opencc.
*
* Note: Leave config_file to NULL if you do not want to load any configuration file.
*
*/
opencc_t opencc_open(const char * config_file);
/**
* opencc_close:
* @od: The description pointer.
* @returns: 0 on success or non-zero number on failure.
*
* Destroy an instance of opencc.
*
*/
int opencc_close(opencc_t od);
/**
* opencc_convert:
* @od: The opencc description pointer.
* @inbuf: The pointer to the wide character string of the input buffer.
* @inbufleft: The maximum number of characters in *inbuf to convert.
* @outbuf: The pointer to the wide character string of the output buffer.
* @outbufleft: The size of output buffer.
*
* @returns: The number of characters of the input buffer that converted.
*
* Convert string from *inbuf to *outbuf.
*
* Note: Don't forget to assign **outbuf to L'\0' after called.
*
*/
size_t opencc_convert(opencc_t od, ucs4_t ** inbuf, size_t * inbufleft,
ucs4_t ** outbuf, size_t * outbufleft);
/**
* opencc_convert_utf8:
* @od: The opencc description pointer.
* @inbuf: The UTF-8 encoded string.
* @length: The maximum number of characters in inbuf to convert.
*
* @returns: The newly allocated UTF-8 string that converted from inbuf.
*
* Convert UTF-8 string from inbuf. This function returns a newly allocated
* c-style string via malloc(), which stores the converted string.
* DON'T FORGET TO CALL free() to recycle memory.
*
*/
char * opencc_convert_utf8(opencc_t t_opencc, const char * inbuf, size_t length);
/**
* opencc_dict_load:
* @od: The opencc description pointer.
* @dict_filename: The name (or location) of the dictionary file.
* @dict_type: The type of the dictionary.
*
* @returns: 0 on success or non-zero number on failure.
*
* Load a dictionary.
*
*/
int opencc_dict_load(opencc_t t_opencc, const char * dict_filename,
opencc_dictionary_type dict_type);
void opencc_set_conversion_mode(opencc_t t_opencc, opencc_conversion_mode conversion_mode);
/**
* opencc_errno:
*
* @returns: The error number.
*
* Return an opencc_convert_errno_t which describes the last error that occured or
* OPENCC_CONVERT_ERROR_VOID
*
*/
opencc_error opencc_errno(void);
/**
* opencc_perror:
* @spec Prefix message.
*
* Print the error message to stderr.
*
*/
void opencc_perror(const char * spec);
#ifdef __cplusplus
};
#endif
#endif /* __OPENCC_H_ */
|