str.hh revision 13689
12SN/A/* 213530Sgiacomo.travaglini@arm.com * Copyright (c) 2018 ARM Limited 313530Sgiacomo.travaglini@arm.com * All rights reserved 413530Sgiacomo.travaglini@arm.com * 51762SN/A * Copyright (c) 2001-2005 The Regents of The University of Michigan 62SN/A * All rights reserved. 72SN/A * 82SN/A * Redistribution and use in source and binary forms, with or without 92SN/A * modification, are permitted provided that the following conditions are 102SN/A * met: redistributions of source code must retain the above copyright 112SN/A * notice, this list of conditions and the following disclaimer; 122SN/A * redistributions in binary form must reproduce the above copyright 132SN/A * notice, this list of conditions and the following disclaimer in the 142SN/A * documentation and/or other materials provided with the distribution; 152SN/A * neither the name of the copyright holders nor the names of its 162SN/A * contributors may be used to endorse or promote products derived from 172SN/A * this software without specific prior written permission. 182SN/A * 192SN/A * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 202SN/A * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 212SN/A * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 222SN/A * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 232SN/A * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 242SN/A * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 252SN/A * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 262SN/A * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 272SN/A * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 282SN/A * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 292SN/A * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 302665Ssaidi@eecs.umich.edu * 312665Ssaidi@eecs.umich.edu * Authors: Nathan Binkert 322665Ssaidi@eecs.umich.edu * Steve Reinhardt 332SN/A */ 342SN/A 3510386Sandreas.hansson@arm.com#ifndef __BASE_STR_HH__ 3610386Sandreas.hansson@arm.com#define __BASE_STR_HH__ 372SN/A 389142Ssteve.reinhardt@amd.com#include <cstring> 3910386Sandreas.hansson@arm.com#include <limits> 4010386Sandreas.hansson@arm.com#include <locale> 4110386Sandreas.hansson@arm.com#include <stdexcept> 422SN/A#include <string> 4313689Sgiacomo.travaglini@arm.com#include <type_traits> 442SN/A#include <vector> 452SN/A 4613439Sgabeblack@google.com#include "base/logging.hh" 4713439Sgabeblack@google.com 482SN/Ainline void 492SN/Aeat_lead_white(std::string &s) 502SN/A{ 512SN/A std::string::size_type off = s.find_first_not_of(' '); 522SN/A if (off != std::string::npos) { 532SN/A std::string::iterator begin = s.begin(); 542SN/A s.erase(begin, begin + off); 552SN/A } 562SN/A} 572SN/A 582SN/Ainline void 592SN/Aeat_end_white(std::string &s) 602SN/A{ 612SN/A std::string::size_type off = s.find_last_not_of(' '); 622SN/A if (off != std::string::npos) 632SN/A s.erase(s.begin() + off + 1, s.end()); 642SN/A} 652SN/A 662SN/Ainline void 672SN/Aeat_white(std::string &s) 682SN/A{ 692SN/A eat_lead_white(s); 702SN/A eat_end_white(s); 712SN/A} 722SN/A 732SN/Ainline std::string 742SN/Ato_lower(const std::string &s) 752SN/A{ 762SN/A std::string lower; 772SN/A int len = s.size(); 782SN/A 792SN/A lower.reserve(len); 802SN/A 8110386Sandreas.hansson@arm.com for (const auto &c : s) 8210386Sandreas.hansson@arm.com lower.push_back(std::tolower(c)); 832SN/A 842SN/A return lower; 852SN/A} 862SN/A 871380SN/A// Split the string s into lhs and rhs on the first occurence of the 881380SN/A// character c. 891380SN/Abool 901380SN/Asplit_first(const std::string &s, std::string &lhs, std::string &rhs, char c); 911380SN/A 921380SN/A// Split the string s into lhs and rhs on the last occurence of the 931380SN/A// character c. 941380SN/Abool 951380SN/Asplit_last(const std::string &s, std::string &lhs, std::string &rhs, char c); 961380SN/A 971380SN/A// Tokenize the string <s> splitting on the character <token>, and 981380SN/A// place the result in the string vector <vector>. If <ign> is true, 991380SN/A// then empty result strings (due to trailing tokens, or consecutive 1001380SN/A// tokens) are skipped. 1012SN/Avoid 1022SN/Atokenize(std::vector<std::string> &vector, const std::string &s, 1032SN/A char token, bool ign = true); 1042SN/A 10510386Sandreas.hansson@arm.com/** 10610386Sandreas.hansson@arm.com * @{ 10710386Sandreas.hansson@arm.com * 10810386Sandreas.hansson@arm.com * @name String to number helper functions for signed and unsigned 10913530Sgiacomo.travaglini@arm.com * integeral type, as well as enums and floating-point types. 11010386Sandreas.hansson@arm.com */ 11110386Sandreas.hansson@arm.comtemplate <class T> 11213689Sgiacomo.travaglini@arm.comtypename std::enable_if<std::is_integral<T>::value && 11310386Sandreas.hansson@arm.com std::is_signed<T>::value, T>::type 11410386Sandreas.hansson@arm.com__to_number(const std::string &value) 11510386Sandreas.hansson@arm.com{ 11610386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 11710386Sandreas.hansson@arm.com long long r = std::stoll(value, nullptr, 0); 11810386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 11910386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 12010386Sandreas.hansson@arm.com return static_cast<T>(r); 12110386Sandreas.hansson@arm.com} 1222SN/A 1232SN/Atemplate <class T> 12413689Sgiacomo.travaglini@arm.comtypename std::enable_if<std::is_integral<T>::value && 12510386Sandreas.hansson@arm.com !std::is_signed<T>::value, T>::type 12610386Sandreas.hansson@arm.com__to_number(const std::string &value) 1272SN/A{ 12810386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 12910386Sandreas.hansson@arm.com unsigned long long r = std::stoull(value, nullptr, 0); 13010386Sandreas.hansson@arm.com if (r > std::numeric_limits<T>::max()) 13110386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 13210386Sandreas.hansson@arm.com return static_cast<T>(r); 13310386Sandreas.hansson@arm.com} 13410386Sandreas.hansson@arm.com 13510386Sandreas.hansson@arm.comtemplate <class T> 13613689Sgiacomo.travaglini@arm.comtypename std::enable_if<std::is_enum<T>::value, T>::type 13713689Sgiacomo.travaglini@arm.com__to_number(const std::string &value) 13813689Sgiacomo.travaglini@arm.com{ 13913689Sgiacomo.travaglini@arm.com auto r = __to_number<typename std::underlying_type<T>::type>(value); 14013689Sgiacomo.travaglini@arm.com return static_cast<T>(r); 14113689Sgiacomo.travaglini@arm.com} 14213689Sgiacomo.travaglini@arm.com 14313689Sgiacomo.travaglini@arm.comtemplate <class T> 14410386Sandreas.hansson@arm.comtypename std::enable_if<std::is_floating_point<T>::value, T>::type 14510386Sandreas.hansson@arm.com__to_number(const std::string &value) 14610386Sandreas.hansson@arm.com{ 14710386Sandreas.hansson@arm.com // start big and narrow it down if needed 14810386Sandreas.hansson@arm.com long double r = std::stold(value); 14910386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 15010386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 15110386Sandreas.hansson@arm.com return static_cast<T>(r); 15210386Sandreas.hansson@arm.com} 15310386Sandreas.hansson@arm.com/** @} */ 15410386Sandreas.hansson@arm.com 15510386Sandreas.hansson@arm.com/** 15610386Sandreas.hansson@arm.com * Turn a string representation of a number, either integral or 15710386Sandreas.hansson@arm.com * floating point, into an actual number. 15810386Sandreas.hansson@arm.com * 15910386Sandreas.hansson@arm.com * @param value The string representing the number 16010386Sandreas.hansson@arm.com * @param retval The resulting value 16110386Sandreas.hansson@arm.com * @return True if the parsing was successful 16210386Sandreas.hansson@arm.com */ 16310386Sandreas.hansson@arm.comtemplate <class T> 16410386Sandreas.hansson@arm.cominline bool 16510386Sandreas.hansson@arm.comto_number(const std::string &value, T &retval) 16610386Sandreas.hansson@arm.com{ 16710386Sandreas.hansson@arm.com try { 16810386Sandreas.hansson@arm.com retval = __to_number<T>(value); 16910386Sandreas.hansson@arm.com return true; 17010386Sandreas.hansson@arm.com } catch (const std::out_of_range&) { 17110386Sandreas.hansson@arm.com return false; 17210386Sandreas.hansson@arm.com } catch (const std::invalid_argument&) { 17310386Sandreas.hansson@arm.com return false; 17413439Sgabeblack@google.com } catch (...) { 17513439Sgabeblack@google.com panic("Unrecognized exception.\n"); 17610386Sandreas.hansson@arm.com } 17710386Sandreas.hansson@arm.com} 17810386Sandreas.hansson@arm.com 17910386Sandreas.hansson@arm.com/** 18010386Sandreas.hansson@arm.com * Turn a string representation of a boolean into a boolean value. 18110386Sandreas.hansson@arm.com */ 18210386Sandreas.hansson@arm.cominline bool 18310386Sandreas.hansson@arm.comto_bool(const std::string &value, bool &retval) 18410386Sandreas.hansson@arm.com{ 18510386Sandreas.hansson@arm.com std::string s = to_lower(value); 18610386Sandreas.hansson@arm.com 18710386Sandreas.hansson@arm.com if (s == "true") { 18810386Sandreas.hansson@arm.com retval = true; 18910386Sandreas.hansson@arm.com return true; 19010386Sandreas.hansson@arm.com } else if (s == "false") { 19110386Sandreas.hansson@arm.com retval = false; 19210386Sandreas.hansson@arm.com return true; 19310386Sandreas.hansson@arm.com } 19410386Sandreas.hansson@arm.com 19510386Sandreas.hansson@arm.com return false; 1962SN/A} 1972SN/A 1982SN/A// Put quotes around string arg if it contains spaces. 1992SN/Ainline std::string 2002SN/Aquote(const std::string &s) 2012SN/A{ 2022SN/A std::string ret; 2032SN/A bool quote = s.find(' ') != std::string::npos; 2042SN/A 2052SN/A if (quote) 2062SN/A ret = '"'; 2072SN/A 2082SN/A ret += s; 2092SN/A 2102SN/A if (quote) 2112SN/A ret += '"'; 2122SN/A 2132SN/A return ret; 2142SN/A} 2152SN/A 2169142Ssteve.reinhardt@amd.com 2179142Ssteve.reinhardt@amd.com/** 2189142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2199142Ssteve.reinhardt@amd.com */ 2209142Ssteve.reinhardt@amd.cominline bool 2219142Ssteve.reinhardt@amd.comstartswith(const char *s, const char *prefix) 2229142Ssteve.reinhardt@amd.com{ 2239142Ssteve.reinhardt@amd.com return (strncmp(s, prefix, strlen(prefix)) == 0); 2249142Ssteve.reinhardt@amd.com} 2259142Ssteve.reinhardt@amd.com 2269142Ssteve.reinhardt@amd.com 2279142Ssteve.reinhardt@amd.com/** 2289142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2299142Ssteve.reinhardt@amd.com */ 2309142Ssteve.reinhardt@amd.cominline bool 2319142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const char *prefix) 2329142Ssteve.reinhardt@amd.com{ 2339142Ssteve.reinhardt@amd.com return (s.compare(0, strlen(prefix), prefix) == 0); 2349142Ssteve.reinhardt@amd.com} 2359142Ssteve.reinhardt@amd.com 2369142Ssteve.reinhardt@amd.com 2379142Ssteve.reinhardt@amd.com/** 2389142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2399142Ssteve.reinhardt@amd.com */ 2409142Ssteve.reinhardt@amd.cominline bool 2419142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const std::string &prefix) 2429142Ssteve.reinhardt@amd.com{ 2439142Ssteve.reinhardt@amd.com return (s.compare(0, prefix.size(), prefix) == 0); 2449142Ssteve.reinhardt@amd.com} 2459142Ssteve.reinhardt@amd.com 2469142Ssteve.reinhardt@amd.com 24710386Sandreas.hansson@arm.com#endif //__BASE_STR_HH__ 248