str.hh revision 10386
12SN/A/* 21762SN/A * Copyright (c) 2001-2005 The Regents of The University of Michigan 32SN/A * All rights reserved. 42SN/A * 52SN/A * Redistribution and use in source and binary forms, with or without 62SN/A * modification, are permitted provided that the following conditions are 72SN/A * met: redistributions of source code must retain the above copyright 82SN/A * notice, this list of conditions and the following disclaimer; 92SN/A * redistributions in binary form must reproduce the above copyright 102SN/A * notice, this list of conditions and the following disclaimer in the 112SN/A * documentation and/or other materials provided with the distribution; 122SN/A * neither the name of the copyright holders nor the names of its 132SN/A * contributors may be used to endorse or promote products derived from 142SN/A * this software without specific prior written permission. 152SN/A * 162SN/A * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 172SN/A * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 182SN/A * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 192SN/A * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 202SN/A * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 212SN/A * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 222SN/A * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 232SN/A * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 242SN/A * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 252SN/A * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 262SN/A * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 272665Ssaidi@eecs.umich.edu * 282665Ssaidi@eecs.umich.edu * Authors: Nathan Binkert 292665Ssaidi@eecs.umich.edu * Steve Reinhardt 302SN/A */ 312SN/A 3210386Sandreas.hansson@arm.com#ifndef __BASE_STR_HH__ 3310386Sandreas.hansson@arm.com#define __BASE_STR_HH__ 342SN/A 359142Ssteve.reinhardt@amd.com#include <cstring> 3610386Sandreas.hansson@arm.com#include <limits> 3710386Sandreas.hansson@arm.com#include <locale> 3810386Sandreas.hansson@arm.com#include <stdexcept> 392SN/A#include <string> 402SN/A#include <vector> 412SN/A 422SN/Ainline void 432SN/Aeat_lead_white(std::string &s) 442SN/A{ 452SN/A std::string::size_type off = s.find_first_not_of(' '); 462SN/A if (off != std::string::npos) { 472SN/A std::string::iterator begin = s.begin(); 482SN/A s.erase(begin, begin + off); 492SN/A } 502SN/A} 512SN/A 522SN/Ainline void 532SN/Aeat_end_white(std::string &s) 542SN/A{ 552SN/A std::string::size_type off = s.find_last_not_of(' '); 562SN/A if (off != std::string::npos) 572SN/A s.erase(s.begin() + off + 1, s.end()); 582SN/A} 592SN/A 602SN/Ainline void 612SN/Aeat_white(std::string &s) 622SN/A{ 632SN/A eat_lead_white(s); 642SN/A eat_end_white(s); 652SN/A} 662SN/A 672SN/Ainline std::string 682SN/Ato_lower(const std::string &s) 692SN/A{ 702SN/A std::string lower; 712SN/A int len = s.size(); 722SN/A 732SN/A lower.reserve(len); 742SN/A 7510386Sandreas.hansson@arm.com for (const auto &c : s) 7610386Sandreas.hansson@arm.com lower.push_back(std::tolower(c)); 772SN/A 782SN/A return lower; 792SN/A} 802SN/A 811380SN/A// Split the string s into lhs and rhs on the first occurence of the 821380SN/A// character c. 831380SN/Abool 841380SN/Asplit_first(const std::string &s, std::string &lhs, std::string &rhs, char c); 851380SN/A 861380SN/A// Split the string s into lhs and rhs on the last occurence of the 871380SN/A// character c. 881380SN/Abool 891380SN/Asplit_last(const std::string &s, std::string &lhs, std::string &rhs, char c); 901380SN/A 911380SN/A// Tokenize the string <s> splitting on the character <token>, and 921380SN/A// place the result in the string vector <vector>. If <ign> is true, 931380SN/A// then empty result strings (due to trailing tokens, or consecutive 941380SN/A// tokens) are skipped. 952SN/Avoid 962SN/Atokenize(std::vector<std::string> &vector, const std::string &s, 972SN/A char token, bool ign = true); 982SN/A 9910386Sandreas.hansson@arm.com/** 10010386Sandreas.hansson@arm.com * @{ 10110386Sandreas.hansson@arm.com * 10210386Sandreas.hansson@arm.com * @name String to number helper functions for signed and unsigned 10310386Sandreas.hansson@arm.com * integeral type, as well as floating-point types. 10410386Sandreas.hansson@arm.com */ 10510386Sandreas.hansson@arm.comtemplate <class T> 10610386Sandreas.hansson@arm.comtypename std::enable_if<std::is_integral<T>::value && 10710386Sandreas.hansson@arm.com std::is_signed<T>::value, T>::type 10810386Sandreas.hansson@arm.com__to_number(const std::string &value) 10910386Sandreas.hansson@arm.com{ 11010386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 11110386Sandreas.hansson@arm.com long long r = std::stoll(value, nullptr, 0); 11210386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 11310386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 11410386Sandreas.hansson@arm.com return static_cast<T>(r); 11510386Sandreas.hansson@arm.com} 1162SN/A 1172SN/Atemplate <class T> 11810386Sandreas.hansson@arm.comtypename std::enable_if<std::is_integral<T>::value && 11910386Sandreas.hansson@arm.com !std::is_signed<T>::value, T>::type 12010386Sandreas.hansson@arm.com__to_number(const std::string &value) 1212SN/A{ 12210386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 12310386Sandreas.hansson@arm.com unsigned long long r = std::stoull(value, nullptr, 0); 12410386Sandreas.hansson@arm.com if (r > std::numeric_limits<T>::max()) 12510386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 12610386Sandreas.hansson@arm.com return static_cast<T>(r); 12710386Sandreas.hansson@arm.com} 12810386Sandreas.hansson@arm.com 12910386Sandreas.hansson@arm.comtemplate <class T> 13010386Sandreas.hansson@arm.comtypename std::enable_if<std::is_floating_point<T>::value, T>::type 13110386Sandreas.hansson@arm.com__to_number(const std::string &value) 13210386Sandreas.hansson@arm.com{ 13310386Sandreas.hansson@arm.com // start big and narrow it down if needed 13410386Sandreas.hansson@arm.com long double r = std::stold(value); 13510386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 13610386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 13710386Sandreas.hansson@arm.com return static_cast<T>(r); 13810386Sandreas.hansson@arm.com} 13910386Sandreas.hansson@arm.com/** @} */ 14010386Sandreas.hansson@arm.com 14110386Sandreas.hansson@arm.com/** 14210386Sandreas.hansson@arm.com * Turn a string representation of a number, either integral or 14310386Sandreas.hansson@arm.com * floating point, into an actual number. 14410386Sandreas.hansson@arm.com * 14510386Sandreas.hansson@arm.com * @param value The string representing the number 14610386Sandreas.hansson@arm.com * @param retval The resulting value 14710386Sandreas.hansson@arm.com * @return True if the parsing was successful 14810386Sandreas.hansson@arm.com */ 14910386Sandreas.hansson@arm.comtemplate <class T> 15010386Sandreas.hansson@arm.cominline bool 15110386Sandreas.hansson@arm.comto_number(const std::string &value, T &retval) 15210386Sandreas.hansson@arm.com{ 15310386Sandreas.hansson@arm.com try { 15410386Sandreas.hansson@arm.com retval = __to_number<T>(value); 15510386Sandreas.hansson@arm.com return true; 15610386Sandreas.hansson@arm.com } catch (const std::out_of_range&) { 15710386Sandreas.hansson@arm.com return false; 15810386Sandreas.hansson@arm.com } catch (const std::invalid_argument&) { 15910386Sandreas.hansson@arm.com return false; 16010386Sandreas.hansson@arm.com } 16110386Sandreas.hansson@arm.com} 16210386Sandreas.hansson@arm.com 16310386Sandreas.hansson@arm.com/** 16410386Sandreas.hansson@arm.com * Turn a string representation of a boolean into a boolean value. 16510386Sandreas.hansson@arm.com */ 16610386Sandreas.hansson@arm.cominline bool 16710386Sandreas.hansson@arm.comto_bool(const std::string &value, bool &retval) 16810386Sandreas.hansson@arm.com{ 16910386Sandreas.hansson@arm.com std::string s = to_lower(value); 17010386Sandreas.hansson@arm.com 17110386Sandreas.hansson@arm.com if (s == "true") { 17210386Sandreas.hansson@arm.com retval = true; 17310386Sandreas.hansson@arm.com return true; 17410386Sandreas.hansson@arm.com } else if (s == "false") { 17510386Sandreas.hansson@arm.com retval = false; 17610386Sandreas.hansson@arm.com return true; 17710386Sandreas.hansson@arm.com } 17810386Sandreas.hansson@arm.com 17910386Sandreas.hansson@arm.com return false; 1802SN/A} 1812SN/A 1822SN/A// Put quotes around string arg if it contains spaces. 1832SN/Ainline std::string 1842SN/Aquote(const std::string &s) 1852SN/A{ 1862SN/A std::string ret; 1872SN/A bool quote = s.find(' ') != std::string::npos; 1882SN/A 1892SN/A if (quote) 1902SN/A ret = '"'; 1912SN/A 1922SN/A ret += s; 1932SN/A 1942SN/A if (quote) 1952SN/A ret += '"'; 1962SN/A 1972SN/A return ret; 1982SN/A} 1992SN/A 2009142Ssteve.reinhardt@amd.com 2019142Ssteve.reinhardt@amd.com/** 2029142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2039142Ssteve.reinhardt@amd.com */ 2049142Ssteve.reinhardt@amd.cominline bool 2059142Ssteve.reinhardt@amd.comstartswith(const char *s, const char *prefix) 2069142Ssteve.reinhardt@amd.com{ 2079142Ssteve.reinhardt@amd.com return (strncmp(s, prefix, strlen(prefix)) == 0); 2089142Ssteve.reinhardt@amd.com} 2099142Ssteve.reinhardt@amd.com 2109142Ssteve.reinhardt@amd.com 2119142Ssteve.reinhardt@amd.com/** 2129142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2139142Ssteve.reinhardt@amd.com */ 2149142Ssteve.reinhardt@amd.cominline bool 2159142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const char *prefix) 2169142Ssteve.reinhardt@amd.com{ 2179142Ssteve.reinhardt@amd.com return (s.compare(0, strlen(prefix), prefix) == 0); 2189142Ssteve.reinhardt@amd.com} 2199142Ssteve.reinhardt@amd.com 2209142Ssteve.reinhardt@amd.com 2219142Ssteve.reinhardt@amd.com/** 2229142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2239142Ssteve.reinhardt@amd.com */ 2249142Ssteve.reinhardt@amd.cominline bool 2259142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const std::string &prefix) 2269142Ssteve.reinhardt@amd.com{ 2279142Ssteve.reinhardt@amd.com return (s.compare(0, prefix.size(), prefix) == 0); 2289142Ssteve.reinhardt@amd.com} 2299142Ssteve.reinhardt@amd.com 2309142Ssteve.reinhardt@amd.com 23110386Sandreas.hansson@arm.com#endif //__BASE_STR_HH__ 232