blob: 573b4a1a7fa1590692147e628e9fe89479813325 (
plain)
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
|
/******************************************************************************
*
* utilstr.h - prototypes for string utility functions
*
* $Id: utilstr.h 2981 2013-09-15 00:05:26Z scribe $
*
* Copyright 1997-2013 CrossWire Bible Society (http://www.crosswire.org)
* CrossWire Bible Society
* P. O. Box 2528
* Tempe, AZ 85280-2528
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation version 2.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
*/
#ifndef UTILSTR_H
#define UTILSTR_H
#include <defs.h>
#include <sysdata.h>
#include <swbuf.h>
SWORD_NAMESPACE_START
/** stdstr - clone a string
*/
SWDLLEXPORT char *stdstr (char **iistr, const char *istr, unsigned int memPadFactor = 1);
SWDLLEXPORT char *strstrip (char *istr);
SWDLLEXPORT const char *stristr (const char *s1, const char *s2);
SWDLLEXPORT int strnicmp(const char *s1, const char *s2, int len);
SWDLLEXPORT int stricmp(const char *s1, const char *s2);
/******************************************************************************
* SW_toupper - array of uppercase values for any given Latin-1 value
*
* use this instead of toupper() for fast lookups on accented characters
*/
extern const unsigned char SW_toupper_array[256];
#define SW_toupper(c) SW_toupper_array[(unsigned char)c]
/******************************************************************************
* getUniCharFromUTF8 - retrieves the next Unicode codepoint from a UTF8 string
* and increments buf to start of next codepoint
*
* ENT: buf - address of a utf8 buffer
*
* RET: buf - incremented past last byte used in computing the current codepoint
* unicode codepoint value (0 with buf incremented is invalid UTF8 byte
*/
__u32 getUniCharFromUTF8(const unsigned char **buf);
/******************************************************************************
* getUTF8FromUniChar - retrieves us UTF8 string from a
* Unicode codepoint
*
* ENT: uchar - unicode codepoint value
*
* RET: buf - a UTF8 string which consists of the proper UTF8 sequence of
* bytes for the given Unicode codepoint
*/
SWBuf getUTF8FromUniChar(__u32 uchar);
/******************************************************************************
* assureValidUTF8 - iterates the supplied UTF-8 buffer and checks for validity
* replacing invalid bytes if necessary and returning a
* verified UTF8 buffer, leaving the original input
* unchanged.
*
* ENT: buf - a utf8 buffer
*
* RET: input buffer validated and any problems fixed by substituting a
* replacement character for bytes not valid.
*/
SWBuf assureValidUTF8(const char *buf);
/****
* This can be called to convert a UTF8 stream to an SWBuf which manages
* a wchar_t[]
* access buffer with (wchar_t *)SWBuf::getRawData();
*
*/
SWBuf utf8ToWChar(const char *buf);
/****
* This can be called to convert a wchar_t[] to a UTF-8 SWBuf
*
*/
SWBuf wcharToUTF8(const wchar_t *buf);
SWORD_NAMESPACE_END
#endif
|