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
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
/*
Sonic Visualiser
An audio file viewer and annotation editor.
Centre for Digital Music, Queen Mary, University of London.
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; either version 2 of the
License, or (at your option) any later version. See the file
COPYING included with this distribution for more information.
*/
/*
This is a modified version of a source file from the
Rosegarden MIDI and audio sequencer and notation editor.
This file copyright 2000-2010 Chris Cannam.
*/
#ifndef SV_STRING_BITS_H
#define SV_STRING_BITS_H
#include <QString>
#include <QStringList>
#include <QChar>
namespace sv {
class StringBits
{
public:
/**
* Convert a string to a double using basic "C"-locale syntax,
* i.e. always using '.' as a decimal point. We use this as a
* fallback when parsing files from an unknown source, if
* locale-specific conversion fails. Does not support e notation.
* If ok is non-NULL, *ok will be set to true if conversion
* succeeds or false otherwise.
*/
static double stringToDoubleLocaleFree(QString s, bool *ok = 0);
enum EscapeMode {
EscapeAny, // support both backslash and doubling escapes
EscapeBackslash, // support backslash escapes only
EscapeDoubling, // support doubling escapes ("" for " etc) only
EscapeNone // support no escapes
};
/**
* Split a string at the given separator character, allowing
* quoted sections that contain the separator. If the separator
* is ' ', any (amount of) whitespace will be considered as a
* single separator. If the separator is another whitespace
* character such as '\t', it will be used literally.
*/
static QStringList splitQuoted(QString s,
QChar separator,
EscapeMode escapeMode = EscapeAny);
/**
* Split a string at the given separator character. If quoted is
* true, do so by calling splitQuoted (above) in EscapeAny escape
* mode. If quoted is false, use QString::split; if separator is
* ' ', use SkipEmptyParts behaviour, otherwise use KeepEmptyParts
* (this is analogous to the behaviour of splitQuoted).
*/
static QStringList split(QString s,
QChar separator,
bool quoted);
/**
* Join a vector of strings into a single string, with the
* delimiter as the joining string. If a string contains the
* delimiter already, quote it with double-quotes, replacing any
* existing double-quotes within it by a pair of double-quotes, as
* specified in RFC 4180 Common Format and MIME Type for
* Comma-Separated Values (CSV) Files.
*/
static QString joinDelimited(QVector<QString> row, QString delimiter);
/**
* Return true if the given byte array contains a valid UTF-8
* sequence, false if not. If isTruncated is true, the byte array
* will be treated as the prefix of a longer byte sequence, and
* any errors resulting from a multibyte code ending prematurely
* at the end of the array will be ignored.
*/
static bool isValidUtf8(const std::string &bytes, bool isTruncated);
};
} // end namespace sv
#endif
|
