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
|
/*
//
// Copyright 1997-2009 Torsten Rohlfing
//
// Copyright 2004-2014 SRI International
//
// This file is part of the Computational Morphometry Toolkit.
//
// http://www.nitrc.org/projects/cmtk/
//
// The Computational Morphometry Toolkit 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 3 of
// the License, or (at your option) any later version.
//
// The Computational Morphometry Toolkit 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.
//
// You should have received a copy of the GNU General Public License along
// with the Computational Morphometry Toolkit. If not, see
// <http://www.gnu.org/licenses/>.
//
// $Revision: 5436 $
//
// $LastChangedDate: 2018-12-10 19:01:20 -0800 (Mon, 10 Dec 2018) $
//
// $LastChangedBy: torstenrohlfing $
//
*/
#ifndef __cmtkStrUtility_h_included_
#define __cmtkStrUtility_h_included_
#include <cmtkconfig.h>
#include <map>
#include <string>
#include <vector>
namespace
cmtk
{
/** \addtogroup System */
//@{
/** Safe search for a string within a non-null-terminated string.
*/
const char*
StrNStr( const char* haystack, const size_t nBytes, const char* needle );
/** Safe string comparison.
* This function is a wrapper for the standard library's "strcmp" function.
* This wrapper is safe in that it accepts any combination of NULL and non-NULL
* pointers to both arguments.
*\return 0 if the strings pointed to by "s1" and "s2" are equal, a value
* greater than zero if s1 is greater than s2, and a value smaller than zero
* if s1 is smaller than s2. NULL pointers are considered smaller than any
* other string except the NULL pointer itself.
*/
int StrCmp( const char *s1, const char* s2 );
/** Replace string components.
*\todo This is highly unsafe, since we're not checking for infinite loops and
* the likes. We should really work on this sometimes... or be REALLY carefull.
*/
std::string StrReplaceByRules( const std::string& str, const std::map<std::string,std::string>& rules, const bool multiple = false );
/// Replace a search string with a replacement string.
std::string StrReplace( const std::string& str /*!< The string to replace in */, const std::string& search /*!< Substring to replace */, const std::string& replace /*!< String to replace search string with */ );
/// Make a string legal in a path by replacing spaces and colons with "_".
std::string StrMakeLegalInPath( const std::string& s );
/// Split a string into a vector of strings.
std::vector<std::string> StrSplit( const std::string& s /*<! The string to split. */, const std::string separators = "," /*!< String of separator characters. Any of these will separate two parts in the input string. */ );
//@}
} // namespace cmtk
#endif // #ifndef __cmtkStrUtility_h_included_
|
