/usr/include/ITK-4.9/itkStringTools.h is in libinsighttoolkit4-dev 4.9.0-4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*=========================================================================
*
* Copyright Insight Software Consortium
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0.txt
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*=========================================================================*/
#ifndef itkStringTools_h
#define itkStringTools_h
#include <vector>
#include <map>
#include "itkArray.h"
#include "ITKIOXMLExport.h"
namespace itk
{
/**
* \class StringTools
* \brief A set of tools to manipulate a string.
*
* This class defines a collection of methods that aid users to perform string-based
* I/O operations, e.g., data reading/writing, string parsing, comparison, etc.
*
* \ingroup ITKIOXML
*/
class ITKIOXML_EXPORT StringTools
{
public:
/////////////////////////////////////////////////////////////////////////////
// helper functions for converting a string to/from a std::vector
/////////////////////////////////////////////////////////////////////////////
/**
* Function to convert a string to a vector of type std::vector<T>.
* Number of elements to read is given by the parameter 'count':
* = 0, get the number of elements to read from data.size();
* > 0, read number of 'count' elements, and resize the data if necessary;
* < 0, default value (-1), automatically compute the number from the input stream.
*
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& ToData( std::string& s, std::vector<T>& data, int count = -1 );
/**
* Functions to convert a vector of type std::vector<T> to a string.
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& FromData( std::string& s, const std::vector<T>& data );
/////////////////////////////////////////////////////////////////////////////
// helper functions for converting a string to/from a itk::Array
/////////////////////////////////////////////////////////////////////////////
/**
* Function to convert a string to an array of type itk::Array<T>.
* Number of elements to read is given by the parameter 'count':
* = 0, get the number of elements to read from data.size();
* > 0, read number of 'count' elements, and resize the data if necessary;
* < 0, default value (-1), automatically compute the number from the input stream.
*
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& ToData( std::string& s, Array<T>& data, int count = -1 );
/**
* Functions to convert an array of type itk::Array<T> to a string.
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& FromData( std::string& s, const Array<T>& data );
/////////////////////////////////////////////////////////////////////////////
// helper functions for converting a string to/from a basic data type
/////////////////////////////////////////////////////////////////////////////
/**
* Functions to convert a string to a value of basic data type.
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& ToData( std::string& s, T& data );
/**
* Functions to convert a value of basic data type to a string.
* An exception will be thrown if errors were encountered during the conversion.
*/
template < typename T >
static std::string& FromData( std::string& s, const T& data );
/////////////////////////////////////////////////////////////////////////////
// helper functions for string manipulations
/////////////////////////////////////////////////////////////////////////////
/** Method to trim the spaces or user-specified characters on both ends of a string. */
static std::string& Trim( std::string& str, const std::string& dislike = " \t\n\r" );
/** Method to trim the spaces or user-specified characters on left end of a string. */
static std::string& TrimLeft( std::string& str, const std::string& dislike = " \t\n\r" );
/** Method to trim the spaces or user-specified characters on right end of a string. */
static std::string& TrimRight( std::string& str, const std::string& dislike = " \t\n\r" );
/** Method to covert lower-case characters to upper cases in a string. */
static std::string& ToUpperCase( std::string& str );
/** Method to covert upper-case characters to lower cases in a string. */
static std::string& ToLowerCase( std::string& str );
/** Method to split a string into two parts with user-defined delimiters. */
static void Split( const std::string& s, std::string& lpart, std::string& rpart, const std::string& delims = "=:" );
/** Method to split a string into a sequence of strings with user-defined delimiters. */
static void Split( const std::string& s, std::vector<std::string>& result, const std::string& delims = ";|" );
/**
* Method to split a string into a sequence of sub-strings with user-defined delimiters,
* then each sub-string is further splitted into a <key,value> pair with separators "=:".
*/
static void Split( const std::string& s, std::map<std::string,std::string>& result, const std::string& delims = ";|" );
/** Method to test whether one string matches with another. */
static bool MatchWith( const std::string& s1, const std::string& s2, bool ignoreCase = true );
/** Method to test whether a string starts with a user-given sub-string. */
static bool StartWith( const std::string& s1, const std::string& s2, bool ignoreCase = true );
/** Method to test whether a string ends with a user-given sub-string. */
static bool EndWith( const std::string& s1, const std::string& s2, bool ignoreCase = true );
/** Method to test whether a string contains a user-given sub-string. */
static bool ContainSub( const std::string& s1, const std::string& s2, bool ignoreCase = true );
}; // class StringTools
} // namespace itk
#ifndef ITK_MANUAL_INSTANTIATION
#include "itkStringTools.hxx"
#endif
#endif // itkStringTools_h
|