summaryrefslogtreecommitdiffstats
path: root/include/astra/Utilities.h
blob: 94adea9f8a07d41710c61e97fd9b407d2e075451 (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
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
/*
-----------------------------------------------------------------------
Copyright: 2010-2014, iMinds-Vision Lab, University of Antwerp
                2014, CWI, Amsterdam

Contact: astra@uantwerpen.be
Website: http://sf.net/projects/astra-toolbox

This file is part of the ASTRA Toolbox.


The ASTRA Toolbox 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 ASTRA Toolbox 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 ASTRA Toolbox. If not, see <http://www.gnu.org/licenses/>.

-----------------------------------------------------------------------
$Id$
*/

#ifndef _INC_ASTRA_UTILIES
#define _INC_ASTRA_UTILIES

#include <string>
#include <vector>
#include <algorithm>
#include <sstream>
#include <map>

#include "Globals.h"

namespace astra {

/**
 * This class contains some usefull static utility functions for std strings.
 */
class StringUtil {

public:
	/**
	 * Removes whitespace characters such as spaces and tabs at the extremas.
	 * Optionally you can specify which extrema to trim (default=both) 
	 *
	 * @param _sString The string to trim.
	 * @param _bLeft Trim the left extrema?  Default = true.
	 * @param _bRight Trim the right extrema?  Default = true.
	 */
	static void trim(std::string& _sString, bool _bLeft = true, bool _bRight = true);

	/**
	 * Returns a vector of strings that contains all the substrings delimited by 
	 * the characters in _sDelims.
	 *
	 * @param _sString The string to split.
	 * @param _sDelims The delimiter string.
	 * @return Vector of strings.
	 */
	static std::vector<std::string> split(const std::string& _sString, const std::string& _sDelims);

	/**
	 * Cast a string to an integer.
	 *
	 * @param _sString The string to cast.
	 * @param _iValue Output integer parameter.
	 * @return success?
	 */
	static bool toInt(const std::string& _sString, int& _iValue);

	/**
	 * Cast a string to a float32.
	 *
	 * @param _sString The string to cast.
	 * @param _fValue Output float32 parameter.
	 * @return success?
	 */
	static bool toFloat32(const std::string& _sString, float32& _fValue);

	/**
	 * Convert a string to lower case.
	 *
	 * @param _sString The string to convert.
	 */
	static void toLowerCase(std::string& _sString);
	
	/**
	 * Convert a string to upper case.
	 *
	 * @param _sString The string to convert.
	 */
	static void toUpperCase(std::string& _sString);
};

/**
 * This class contains some usefull static utility functions for std strings.
 */
class FileSystemUtil {

public:
	/**
	 * Get the extensions of a filename.  Always in lower case.
	 *
	 * @param _sFilename file to get extensions from.
	 * @return Extension (lower case).  Empty string if filename is a directory or not a valid file format.
	 */
	static std::string getExtension(std::string& _sFilename);


};


template<typename T, typename S>
std::map<T,S> mergeMap(std::map<T,S> _mMap1, std::map<T,S> _mMap2) 
{
	std::map<T,S> result = _mMap1;
	for (typename std::map<T,S>::iterator it = _mMap2.begin(); it != _mMap2.end(); it++) {
		result[(*it).first] = (*it).second;
	}
	return result;
}

} // end namespace

#endif