1// Copyright (c) 2007 The NetBSD Foundation, Inc. 2// All rights reserved. 3// 4// Redistribution and use in source and binary forms, with or without 5// modification, are permitted provided that the following conditions 6// are met: 7// 1. Redistributions of source code must retain the above copyright 8// notice, this list of conditions and the following disclaimer. 9// 2. Redistributions in binary form must reproduce the above copyright 10// notice, this list of conditions and the following disclaimer in the 11// documentation and/or other materials provided with the distribution. 12// 13// THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND 14// CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, 15// INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 16// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 17// IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY 18// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 20// GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 22// IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 23// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 24// IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 26#if !defined(ATF_CXX_DETAIL_TEXT_HPP) 27#define ATF_CXX_DETAIL_TEXT_HPP 28 29extern "C" { 30#include <stdint.h> 31} 32 33#include <sstream> 34#include <stdexcept> 35#include <string> 36#include <vector> 37 38namespace atf { 39namespace text { 40 41//! 42//! \brief Duplicates a C string using the new[] allocator. 43//! 44//! Replaces the functionality of strdup by using the new[] allocator and 45//! thus allowing the resulting memory to be managed by utils::auto_array. 46//! 47char* duplicate(const char*); 48 49//! 50//! \brief Joins multiple words into a string. 51//! 52//! Joins a list of words into a string, separating them using the provided 53//! separator. Empty words are not omitted. 54//! 55template< class T > 56std::string 57join(const T& words, const std::string& separator) 58{ 59 std::string str; 60 61 typename T::const_iterator iter = words.begin(); 62 bool done = iter == words.end(); 63 while (!done) { 64 str += *iter; 65 iter++; 66 if (iter != words.end()) 67 str += separator; 68 else 69 done = true; 70 } 71 72 return str; 73} 74 75//! 76//! \brief Checks if the string matches a regular expression. 77//! 78bool match(const std::string&, const std::string&); 79 80//! 81//! \brief Splits a string into words. 82//! 83//! Splits the given string into multiple words, all separated by the 84//! given delimiter. Multiple occurrences of the same delimiter are 85//! not condensed so that rejoining the words later on using the same 86//! delimiter results in the original string. 87//! 88std::vector< std::string > split(const std::string&, const std::string&); 89 90//! 91//! \brief Removes whitespace from the beginning and end of a string. 92//! 93std::string trim(const std::string&); 94 95//! 96//! \brief Converts a string to a boolean value. 97//! 98bool to_bool(const std::string&); 99 100//! 101//! \brief Converts the given string to a bytes size. 102//! 103int64_t to_bytes(std::string); 104 105//! 106//! \brief Changes the case of a string to lowercase. 107//! 108//! Returns a new string that is a lowercased version of the original 109//! one. 110//! 111std::string to_lower(const std::string&); 112 113//! 114//! \brief Converts the given object to a string. 115//! 116//! Returns a string with the representation of the given object. There 117//! must exist an operator<< method for that object. 118//! 119template< class T > 120std::string 121to_string(const T& ob) 122{ 123 std::ostringstream ss; 124 ss << ob; 125 return ss.str(); 126} 127 128//! 129//! \brief Converts the given string to another type. 130//! 131//! Attempts to convert the given string to the requested type. Throws 132//! an exception if the conversion failed. 133//! 134template< class T > 135T 136to_type(const std::string& str) 137{ 138 std::istringstream ss(str); 139 T value; 140 ss >> value; 141 if (!ss.eof() || (ss.eof() && (ss.fail() || ss.bad()))) 142 throw std::runtime_error("Cannot convert string to requested type"); 143 return value; 144} 145 146} // namespace text 147} // namespace atf 148 149#endif // !defined(ATF_CXX_DETAIL_TEXT_HPP) 150