summaryrefslogtreecommitdiff
path: root/new/utf8.h
blob: 046d880ba5dffb078b692e602df211e0e581569f (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

#ifndef UTF8_H_
#define UTF8_H_

#include <string>
#include <deque>

/**
 * @ingroup string_types
 * @{
 */


/**
 * Type STRING
 * holds a sequence of 8 bit bytes that represent a sequence of variable
 * length multi-byte international characters, with unspecified encoding.
 */
typedef std::string STRING;

/**
 * Type STRINGS
 * is an "array like" list of STRINGs
 */
typedef std::deque<STRING>  STRINGS;

/**
 * Type STR_UTF
 * holds a UTF8 encoded sequence of 8 bit bytes that represent a sequence
 * of variable multi-byte international characters.  UTF8 is the chosen encoding
 * for all KiCad data files so that they can be transported from one nation to another
 * without ambiguity. Data files are those where KiCad controls the content.
 * This is not the same thing as filenames, which are not file content.
 * Filenames may be encoded on disk using an encoding chosen by the host operating
 * system.  Nonetheless, KiCad data file _content_ is always UTF8 encoded, regardless
 * of host operating system.
 * STR_UTF is UTF8 encoded, by definition.
 */
typedef STRING      STR_UTF;

/**
 * Type STR_UTFS
 * is an "array like" list of STR_UTFs
 */
typedef std::deque<STRING>  STR_UTFS;

/** @} string_types */


// @todo this does not belong here
#ifndef D
#ifdef DEBUG
#define D(x)        x
#else
#define D(x)        // nothing
#endif
#endif

#endif  // UTF8_H_