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
|
///////////////////////////////////////////////////////////////////////////////
// RTFCOMP.H
//
// Include file for RTF compression library.
//
// Dr J A Gow : 25/02/2007
//
// This file is distributed under the terms and conditions of the LGPL - please
// see the file LICENCE in the package root directory.
//
///////////////////////////////////////////////////////////////////////////////
#ifndef _RTFCOMP_H_
#define _RTFCOMP_H_
#ifdef _CPLUSPLUS
extern "C" {
#endif
#include <rtfcomp/errors.h> // error codes
//
// The options structure. This is extensible in case we add further options
// to the RTF converters without breaking compatibility with old programs
typedef struct _tag_RTFOPTS {
int lenOpts; // the length of this structure
unsigned int isCompressed; // generate/receive compressed RTF if true
} RTFOPTS;
//
// The library is reentrant and requires no initialization. Functions can be
// simply used when needed.
//
// Exported functions
///////////////////////////////////////////////////////////////////////////////
// LZRTFCompress
//
// EXPORTED, DLLAPI
//
// Compress an RTF string. Feed it a pointer to receive the result string
// pointer, the pointer to the source string and the length of the source
// string. The function will return error codes as documented in errorcodes.h
//
// Note, you (as the caller) takes ownership of the destination byte buffer
// which is dynamically allocated: so better make sure you free it when done
// with it or memory leaks will ensue. Note that the length of the output string
// can be had from the first little-endian DWORD in the output buffer, but
// it is returned anyway for convenience.
//
///////////////////////////////////////////////////////////////////////////////
int LZRTFCompress(unsigned char ** dest, unsigned int * outlen,
unsigned char * src, int len);
///////////////////////////////////////////////////////////////////////////////
// LZRTFDecompress
//
// EXPORTED, DLLAPI
//
// Decompress an RTF block. Feed it the source string pointer and length, and
// also a pointer to an unsigned int to receive the length of the output
// buffer. It returns an error code as documented in errorcodes.h
//
///////////////////////////////////////////////////////////////////////////////
int LZRTFDecompress(unsigned char ** dest, unsigned int * outlen,
unsigned char * src, unsigned int len);
///////////////////////////////////////////////////////////////////////////////
// LZRTFConvertRTFToUTF8
//
// EXPORTED, DLLAPI
//
// Convert an RTF-encoded string to a UTF-8 encoded one. This is crude - we
// just assume that the RTF encoding is ANSI and that all characters are
// either raw, or escaped out with the backslash/apostrophe sequence
//
///////////////////////////////////////////////////////////////////////////////
int LZRTFConvertRTFToUTF8(unsigned char ** utfout, unsigned int * utflen,
unsigned char * rtfin, unsigned int rtflen,
RTFOPTS * options);
///////////////////////////////////////////////////////////////////////////////
// LZRTFConvertUTF8ToRTF
//
// EXPORTED, DLLAPI
//
// Convert an RTF-encoded string to a UTF-8 encoded one. This is crude - we
// just assume that the RTF encoding is ANSI and that all characters are
// either raw, or escaped out with the backslash/apostrophe sequence
// The header should be without the enclosing group, and without the \rtf1
// control code. Unicode code points outside of the ANSI range are
// encoded as \uxxxxxxxx
//
///////////////////////////////////////////////////////////////////////////////
int LZRTFConvertUTF8ToRTF(unsigned char ** rtfout, unsigned int * lenOut,
unsigned char * utfin, unsigned int len,
unsigned char * rtfhdr, unsigned int hdrlen,
RTFOPTS * options);
///////////////////////////////////////////////////////////////////////////////
// LZRTFGetStringErrorCode
//
// EXPORTED, DLLAPI
//
// Return a user-friendly error message for each defined error code.
//
///////////////////////////////////////////////////////////////////////////////
const char * LZRTFGetStringErrorCode(int ec);
#ifdef _CPLUSPLUS
}
#endif
#endif
|
