str.hh revision 13530
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> 432SN/A#include <vector> 442SN/A 4513439Sgabeblack@google.com#include "base/logging.hh" 4613439Sgabeblack@google.com 472SN/Ainline void 482SN/Aeat_lead_white(std::string &s) 492SN/A{ 502SN/A std::string::size_type off = s.find_first_not_of(' '); 512SN/A if (off != std::string::npos) { 522SN/A std::string::iterator begin = s.begin(); 532SN/A s.erase(begin, begin + off); 542SN/A } 552SN/A} 562SN/A 572SN/Ainline void 582SN/Aeat_end_white(std::string &s) 592SN/A{ 602SN/A std::string::size_type off = s.find_last_not_of(' '); 612SN/A if (off != std::string::npos) 622SN/A s.erase(s.begin() + off + 1, s.end()); 632SN/A} 642SN/A 652SN/Ainline void 662SN/Aeat_white(std::string &s) 672SN/A{ 682SN/A eat_lead_white(s); 692SN/A eat_end_white(s); 702SN/A} 712SN/A 722SN/Ainline std::string 732SN/Ato_lower(const std::string &s) 742SN/A{ 752SN/A std::string lower; 762SN/A int len = s.size(); 772SN/A 782SN/A lower.reserve(len); 792SN/A 8010386Sandreas.hansson@arm.com for (const auto &c : s) 8110386Sandreas.hansson@arm.com lower.push_back(std::tolower(c)); 822SN/A 832SN/A return lower; 842SN/A} 852SN/A 861380SN/A// Split the string s into lhs and rhs on the first occurence of the 871380SN/A// character c. 881380SN/Abool 891380SN/Asplit_first(const std::string &s, std::string &lhs, std::string &rhs, char c); 901380SN/A 911380SN/A// Split the string s into lhs and rhs on the last occurence of the 921380SN/A// character c. 931380SN/Abool 941380SN/Asplit_last(const std::string &s, std::string &lhs, std::string &rhs, char c); 951380SN/A 961380SN/A// Tokenize the string <s> splitting on the character <token>, and 971380SN/A// place the result in the string vector <vector>. If <ign> is true, 981380SN/A// then empty result strings (due to trailing tokens, or consecutive 991380SN/A// tokens) are skipped. 1002SN/Avoid 1012SN/Atokenize(std::vector<std::string> &vector, const std::string &s, 1022SN/A char token, bool ign = true); 1032SN/A 10410386Sandreas.hansson@arm.com/** 10510386Sandreas.hansson@arm.com * @{ 10610386Sandreas.hansson@arm.com * 10710386Sandreas.hansson@arm.com * @name String to number helper functions for signed and unsigned 10813530Sgiacomo.travaglini@arm.com * integeral type, as well as enums and floating-point types. 10910386Sandreas.hansson@arm.com */ 11010386Sandreas.hansson@arm.comtemplate <class T> 11113530Sgiacomo.travaglini@arm.comtypename std::enable_if<(std::is_integral<T>::value || 11213530Sgiacomo.travaglini@arm.com std::is_enum<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> 12413530Sgiacomo.travaglini@arm.comtypename std::enable_if<(std::is_integral<T>::value || 12513530Sgiacomo.travaglini@arm.com std::is_enum<T>::value) && 12610386Sandreas.hansson@arm.com !std::is_signed<T>::value, T>::type 12710386Sandreas.hansson@arm.com__to_number(const std::string &value) 1282SN/A{ 12910386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 13010386Sandreas.hansson@arm.com unsigned long long r = std::stoull(value, nullptr, 0); 13110386Sandreas.hansson@arm.com if (r > std::numeric_limits<T>::max()) 13210386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 13310386Sandreas.hansson@arm.com return static_cast<T>(r); 13410386Sandreas.hansson@arm.com} 13510386Sandreas.hansson@arm.com 13610386Sandreas.hansson@arm.comtemplate <class T> 13710386Sandreas.hansson@arm.comtypename std::enable_if<std::is_floating_point<T>::value, T>::type 13810386Sandreas.hansson@arm.com__to_number(const std::string &value) 13910386Sandreas.hansson@arm.com{ 14010386Sandreas.hansson@arm.com // start big and narrow it down if needed 14110386Sandreas.hansson@arm.com long double r = std::stold(value); 14210386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 14310386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 14410386Sandreas.hansson@arm.com return static_cast<T>(r); 14510386Sandreas.hansson@arm.com} 14610386Sandreas.hansson@arm.com/** @} */ 14710386Sandreas.hansson@arm.com 14810386Sandreas.hansson@arm.com/** 14910386Sandreas.hansson@arm.com * Turn a string representation of a number, either integral or 15010386Sandreas.hansson@arm.com * floating point, into an actual number. 15110386Sandreas.hansson@arm.com * 15210386Sandreas.hansson@arm.com * @param value The string representing the number 15310386Sandreas.hansson@arm.com * @param retval The resulting value 15410386Sandreas.hansson@arm.com * @return True if the parsing was successful 15510386Sandreas.hansson@arm.com */ 15610386Sandreas.hansson@arm.comtemplate <class T> 15710386Sandreas.hansson@arm.cominline bool 15810386Sandreas.hansson@arm.comto_number(const std::string &value, T &retval) 15910386Sandreas.hansson@arm.com{ 16010386Sandreas.hansson@arm.com try { 16110386Sandreas.hansson@arm.com retval = __to_number<T>(value); 16210386Sandreas.hansson@arm.com return true; 16310386Sandreas.hansson@arm.com } catch (const std::out_of_range&) { 16410386Sandreas.hansson@arm.com return false; 16510386Sandreas.hansson@arm.com } catch (const std::invalid_argument&) { 16610386Sandreas.hansson@arm.com return false; 16713439Sgabeblack@google.com } catch (...) { 16813439Sgabeblack@google.com panic("Unrecognized exception.\n"); 16910386Sandreas.hansson@arm.com } 17010386Sandreas.hansson@arm.com} 17110386Sandreas.hansson@arm.com 17210386Sandreas.hansson@arm.com/** 17310386Sandreas.hansson@arm.com * Turn a string representation of a boolean into a boolean value. 17410386Sandreas.hansson@arm.com */ 17510386Sandreas.hansson@arm.cominline bool 17610386Sandreas.hansson@arm.comto_bool(const std::string &value, bool &retval) 17710386Sandreas.hansson@arm.com{ 17810386Sandreas.hansson@arm.com std::string s = to_lower(value); 17910386Sandreas.hansson@arm.com 18010386Sandreas.hansson@arm.com if (s == "true") { 18110386Sandreas.hansson@arm.com retval = true; 18210386Sandreas.hansson@arm.com return true; 18310386Sandreas.hansson@arm.com } else if (s == "false") { 18410386Sandreas.hansson@arm.com retval = false; 18510386Sandreas.hansson@arm.com return true; 18610386Sandreas.hansson@arm.com } 18710386Sandreas.hansson@arm.com 18810386Sandreas.hansson@arm.com return false; 1892SN/A} 1902SN/A 1912SN/A// Put quotes around string arg if it contains spaces. 1922SN/Ainline std::string 1932SN/Aquote(const std::string &s) 1942SN/A{ 1952SN/A std::string ret; 1962SN/A bool quote = s.find(' ') != std::string::npos; 1972SN/A 1982SN/A if (quote) 1992SN/A ret = '"'; 2002SN/A 2012SN/A ret += s; 2022SN/A 2032SN/A if (quote) 2042SN/A ret += '"'; 2052SN/A 2062SN/A return ret; 2072SN/A} 2082SN/A 2099142Ssteve.reinhardt@amd.com 2109142Ssteve.reinhardt@amd.com/** 2119142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2129142Ssteve.reinhardt@amd.com */ 2139142Ssteve.reinhardt@amd.cominline bool 2149142Ssteve.reinhardt@amd.comstartswith(const char *s, const char *prefix) 2159142Ssteve.reinhardt@amd.com{ 2169142Ssteve.reinhardt@amd.com return (strncmp(s, prefix, strlen(prefix)) == 0); 2179142Ssteve.reinhardt@amd.com} 2189142Ssteve.reinhardt@amd.com 2199142Ssteve.reinhardt@amd.com 2209142Ssteve.reinhardt@amd.com/** 2219142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2229142Ssteve.reinhardt@amd.com */ 2239142Ssteve.reinhardt@amd.cominline bool 2249142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const char *prefix) 2259142Ssteve.reinhardt@amd.com{ 2269142Ssteve.reinhardt@amd.com return (s.compare(0, strlen(prefix), prefix) == 0); 2279142Ssteve.reinhardt@amd.com} 2289142Ssteve.reinhardt@amd.com 2299142Ssteve.reinhardt@amd.com 2309142Ssteve.reinhardt@amd.com/** 2319142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2329142Ssteve.reinhardt@amd.com */ 2339142Ssteve.reinhardt@amd.cominline bool 2349142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const std::string &prefix) 2359142Ssteve.reinhardt@amd.com{ 2369142Ssteve.reinhardt@amd.com return (s.compare(0, prefix.size(), prefix) == 0); 2379142Ssteve.reinhardt@amd.com} 2389142Ssteve.reinhardt@amd.com 2399142Ssteve.reinhardt@amd.com 24010386Sandreas.hansson@arm.com#endif //__BASE_STR_HH__ 241