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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/*****************************************************************************
*
* Copyright (c) 2000 - 2017, Lawrence Livermore National Security, LLC
* Produced at the Lawrence Livermore National Laboratory
* LLNL-CODE-442911
* All rights reserved.
*
* This file is part of VisIt. For details, see https://visit.llnl.gov/. The
* full copyright notice is contained in the file COPYRIGHT located at the root
* of the VisIt distribution or at http://www.llnl.gov/visit/copyright.html.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* - Redistributions of source code must retain the above copyright notice,
* this list of conditions and the disclaimer below.
* - Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the disclaimer (as noted below) in the
* documentation and/or other materials provided with the distribution.
* - Neither the name of the LLNS/LLNL nor the names of its contributors may
* be used to endorse or promote products derived from this software without
* specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL LAWRENCE LIVERMORE NATIONAL SECURITY,
* LLC, THE U.S. DEPARTMENT OF ENERGY OR CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
*****************************************************************************/
// ************************************************************************* //
// StringHelpers.h //
// ************************************************************************* //
#ifndef STRINGHELPERS_H
#define STRINGHELPERS_H
#include <utility_exports.h>
#include <iostream>
#include <set>
#include <string>
#include <vector>
#include <cerrno>
#include <cstdio>
#include <cstdlib>
#include <snprintf.h>
#if __GNUC__ >= 3
# define MUST_CHECK __attribute__ ((warn_unused_result))
#else
# define MUST_CHECK /*nothing*/
#endif
namespace StringHelpers
{
const std::string NON_RELEVANT_CHARS =
"`~!@#$%^&*()-_=+{[}]|\\:;\"'<,>.?/0123456789";
enum FindResult {FindNone = -1, FindError = -2};
void UTILITY_API GroupStrings(std::vector<std::string> stringList,
std::vector<std::vector<std::string> > &stringGroups,
std::vector<std::string> &groupNames,
int numLeadingVals = 3,
std::string nonRelevantChars = NON_RELEVANT_CHARS);
void UTILITY_API GroupStringsAsPaths(std::vector<std::string> stringList,
std::vector<std::vector<std::string> > &stringGroups,
std::vector<std::string> &groupNames);
void UTILITY_API GroupStringsFixedAlpha(std::vector<std::string> stringList,
int numGroups,
std::vector<std::vector<std::string> > &stringGroups);
void UTILITY_API GroupStringsFixedAlpha(
const std::set<std::string> &stringList,
int numGroups,
std::vector<std::set<std::string> > &stringGroups);
int UTILITY_API FindRE(const std::string &s, const std::string &re);
int UTILITY_API FindRE(const char *stringToSearch, const char *re);
bool UTILITY_API ReplaceRE(std::string &s, const std::string &re,
const std::string &repl);
std::string UTILITY_API ExtractRESubstr(const char *stringToSearch,
const char *re);
bool UTILITY_API ValidatePrintfFormatString(const char *fmtStr,
const char *arg1Type, ...);
std::string UTILITY_API car(const std::string, const char separator);
std::string UTILITY_API cdr(const std::string, const char separator);
void UTILITY_API append(std::vector<std::string> &,
std::vector<std::string>);
std::vector<std::string> UTILITY_API split(const std::string,
const char separator);
void UTILITY_API rtrim(std::string &var);
void UTILITY_API ltrim(std::string &var);
void UTILITY_API trim(std::string &var);
std::string UTILITY_API Replace(const std::string &source,
const std::string &before,
const std::string &after);
std::string UTILITY_API Plural(const std::string &noun);
std::string UTILITY_API Plural(int, const std::string &noun);
std::string UTILITY_API HumanReadableList(const std::vector<std::string>&);
bool UTILITY_API IsPureASCII(const std::string &txt);
bool UTILITY_API IsPureASCII(const char *const txt, size_t length);
bool UTILITY_API CaseInsenstiveEqual(const std::string &str_a,
const std::string &str_b);
std::string UTILITY_API UpperCase(const std::string &src);
bool UTILITY_API StringToInt(const std::string &, int &);
bool UTILITY_API ParseRange(const std::string , std::vector<int> &);
// ****************************************************************************
// Function: str_to_u_numeric
//
// Purpose: Converts a string value into an unsigned numeric type as given by
// the template parameter.
// WARNING: This is likely to compile and silently fail if given a
// signed type in the template parameter.
//
// Programmer: Tom Fogal
// Creation: August 11, 2008
//
// Modifications:
//
// Tom Fogal, Fri Aug 29 16:15:17 EDT 2008
// Reorganized to propagate error upward.
//
// Tom Fogal, Tue Sep 23 11:08:02 MDT 2008
// Removed a statically-false branch which was causing an annoying warning.
//
// ****************************************************************************
template<typename UT>
MUST_CHECK bool str_to_u_numeric(const char * const s, UT *retval)
{
// strtoul() will happily convert a negative string into an unsigned
// integer. Do a simple check and bail out if we're given a negative
// number.
if(s[0] == '-')
{
return false;
}
const char *str = s;
// get rid of leading 0's; they confuse strtoul.
if(str[0] == '0' && str[1] != '\0' && str[1] != 'x')
{
while(*str == '0') { ++str; }
}
// One might want to think about switching this to an `unsigned long
// long' and using `strtoull' below. That will catch more cases, but
// this is more portable.
unsigned long ret;
char *end;
errno = 0;
ret = strtoul(str, &end, 0);
*retval = static_cast<UT>(ret);
switch(errno)
{
case 0: /* success */ break;
case ERANGE:
// Constant does not fit in sizeof(unsigned long) bytes.
return false;
break;
case EINVAL:
// Bad base (3rd arg) given; this should be impossible.
return false;
break;
default:
// Unknown error.
return false;
break;
}
if(end == s) {
// junk characters start the string .. is this a number?
return false;
}
return true;
}
}
#endif
|
