str.hh revision 13439
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 4213439Sgabeblack@google.com#include "base/logging.hh" 4313439Sgabeblack@google.com 442SN/Ainline void 452SN/Aeat_lead_white(std::string &s) 462SN/A{ 472SN/A std::string::size_type off = s.find_first_not_of(' '); 482SN/A if (off != std::string::npos) { 492SN/A std::string::iterator begin = s.begin(); 502SN/A s.erase(begin, begin + off); 512SN/A } 522SN/A} 532SN/A 542SN/Ainline void 552SN/Aeat_end_white(std::string &s) 562SN/A{ 572SN/A std::string::size_type off = s.find_last_not_of(' '); 582SN/A if (off != std::string::npos) 592SN/A s.erase(s.begin() + off + 1, s.end()); 602SN/A} 612SN/A 622SN/Ainline void 632SN/Aeat_white(std::string &s) 642SN/A{ 652SN/A eat_lead_white(s); 662SN/A eat_end_white(s); 672SN/A} 682SN/A 692SN/Ainline std::string 702SN/Ato_lower(const std::string &s) 712SN/A{ 722SN/A std::string lower; 732SN/A int len = s.size(); 742SN/A 752SN/A lower.reserve(len); 762SN/A 7710386Sandreas.hansson@arm.com for (const auto &c : s) 7810386Sandreas.hansson@arm.com lower.push_back(std::tolower(c)); 792SN/A 802SN/A return lower; 812SN/A} 822SN/A 831380SN/A// Split the string s into lhs and rhs on the first occurence of the 841380SN/A// character c. 851380SN/Abool 861380SN/Asplit_first(const std::string &s, std::string &lhs, std::string &rhs, char c); 871380SN/A 881380SN/A// Split the string s into lhs and rhs on the last occurence of the 891380SN/A// character c. 901380SN/Abool 911380SN/Asplit_last(const std::string &s, std::string &lhs, std::string &rhs, char c); 921380SN/A 931380SN/A// Tokenize the string <s> splitting on the character <token>, and 941380SN/A// place the result in the string vector <vector>. If <ign> is true, 951380SN/A// then empty result strings (due to trailing tokens, or consecutive 961380SN/A// tokens) are skipped. 972SN/Avoid 982SN/Atokenize(std::vector<std::string> &vector, const std::string &s, 992SN/A char token, bool ign = true); 1002SN/A 10110386Sandreas.hansson@arm.com/** 10210386Sandreas.hansson@arm.com * @{ 10310386Sandreas.hansson@arm.com * 10410386Sandreas.hansson@arm.com * @name String to number helper functions for signed and unsigned 10510386Sandreas.hansson@arm.com * integeral type, as well as floating-point types. 10610386Sandreas.hansson@arm.com */ 10710386Sandreas.hansson@arm.comtemplate <class T> 10810386Sandreas.hansson@arm.comtypename std::enable_if<std::is_integral<T>::value && 10910386Sandreas.hansson@arm.com std::is_signed<T>::value, T>::type 11010386Sandreas.hansson@arm.com__to_number(const std::string &value) 11110386Sandreas.hansson@arm.com{ 11210386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 11310386Sandreas.hansson@arm.com long long r = std::stoll(value, nullptr, 0); 11410386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 11510386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 11610386Sandreas.hansson@arm.com return static_cast<T>(r); 11710386Sandreas.hansson@arm.com} 1182SN/A 1192SN/Atemplate <class T> 12010386Sandreas.hansson@arm.comtypename std::enable_if<std::is_integral<T>::value && 12110386Sandreas.hansson@arm.com !std::is_signed<T>::value, T>::type 12210386Sandreas.hansson@arm.com__to_number(const std::string &value) 1232SN/A{ 12410386Sandreas.hansson@arm.com // start big and narrow it down if needed, determine the base dynamically 12510386Sandreas.hansson@arm.com unsigned long long r = std::stoull(value, nullptr, 0); 12610386Sandreas.hansson@arm.com if (r > std::numeric_limits<T>::max()) 12710386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 12810386Sandreas.hansson@arm.com return static_cast<T>(r); 12910386Sandreas.hansson@arm.com} 13010386Sandreas.hansson@arm.com 13110386Sandreas.hansson@arm.comtemplate <class T> 13210386Sandreas.hansson@arm.comtypename std::enable_if<std::is_floating_point<T>::value, T>::type 13310386Sandreas.hansson@arm.com__to_number(const std::string &value) 13410386Sandreas.hansson@arm.com{ 13510386Sandreas.hansson@arm.com // start big and narrow it down if needed 13610386Sandreas.hansson@arm.com long double r = std::stold(value); 13710386Sandreas.hansson@arm.com if (r < std::numeric_limits<T>::min() || r > std::numeric_limits<T>::max()) 13810386Sandreas.hansson@arm.com throw std::out_of_range("Out of range"); 13910386Sandreas.hansson@arm.com return static_cast<T>(r); 14010386Sandreas.hansson@arm.com} 14110386Sandreas.hansson@arm.com/** @} */ 14210386Sandreas.hansson@arm.com 14310386Sandreas.hansson@arm.com/** 14410386Sandreas.hansson@arm.com * Turn a string representation of a number, either integral or 14510386Sandreas.hansson@arm.com * floating point, into an actual number. 14610386Sandreas.hansson@arm.com * 14710386Sandreas.hansson@arm.com * @param value The string representing the number 14810386Sandreas.hansson@arm.com * @param retval The resulting value 14910386Sandreas.hansson@arm.com * @return True if the parsing was successful 15010386Sandreas.hansson@arm.com */ 15110386Sandreas.hansson@arm.comtemplate <class T> 15210386Sandreas.hansson@arm.cominline bool 15310386Sandreas.hansson@arm.comto_number(const std::string &value, T &retval) 15410386Sandreas.hansson@arm.com{ 15510386Sandreas.hansson@arm.com try { 15610386Sandreas.hansson@arm.com retval = __to_number<T>(value); 15710386Sandreas.hansson@arm.com return true; 15810386Sandreas.hansson@arm.com } catch (const std::out_of_range&) { 15910386Sandreas.hansson@arm.com return false; 16010386Sandreas.hansson@arm.com } catch (const std::invalid_argument&) { 16110386Sandreas.hansson@arm.com return false; 16213439Sgabeblack@google.com } catch (...) { 16313439Sgabeblack@google.com panic("Unrecognized exception.\n"); 16410386Sandreas.hansson@arm.com } 16510386Sandreas.hansson@arm.com} 16610386Sandreas.hansson@arm.com 16710386Sandreas.hansson@arm.com/** 16810386Sandreas.hansson@arm.com * Turn a string representation of a boolean into a boolean value. 16910386Sandreas.hansson@arm.com */ 17010386Sandreas.hansson@arm.cominline bool 17110386Sandreas.hansson@arm.comto_bool(const std::string &value, bool &retval) 17210386Sandreas.hansson@arm.com{ 17310386Sandreas.hansson@arm.com std::string s = to_lower(value); 17410386Sandreas.hansson@arm.com 17510386Sandreas.hansson@arm.com if (s == "true") { 17610386Sandreas.hansson@arm.com retval = true; 17710386Sandreas.hansson@arm.com return true; 17810386Sandreas.hansson@arm.com } else if (s == "false") { 17910386Sandreas.hansson@arm.com retval = false; 18010386Sandreas.hansson@arm.com return true; 18110386Sandreas.hansson@arm.com } 18210386Sandreas.hansson@arm.com 18310386Sandreas.hansson@arm.com return false; 1842SN/A} 1852SN/A 1862SN/A// Put quotes around string arg if it contains spaces. 1872SN/Ainline std::string 1882SN/Aquote(const std::string &s) 1892SN/A{ 1902SN/A std::string ret; 1912SN/A bool quote = s.find(' ') != std::string::npos; 1922SN/A 1932SN/A if (quote) 1942SN/A ret = '"'; 1952SN/A 1962SN/A ret += s; 1972SN/A 1982SN/A if (quote) 1992SN/A ret += '"'; 2002SN/A 2012SN/A return ret; 2022SN/A} 2032SN/A 2049142Ssteve.reinhardt@amd.com 2059142Ssteve.reinhardt@amd.com/** 2069142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2079142Ssteve.reinhardt@amd.com */ 2089142Ssteve.reinhardt@amd.cominline bool 2099142Ssteve.reinhardt@amd.comstartswith(const char *s, const char *prefix) 2109142Ssteve.reinhardt@amd.com{ 2119142Ssteve.reinhardt@amd.com return (strncmp(s, prefix, strlen(prefix)) == 0); 2129142Ssteve.reinhardt@amd.com} 2139142Ssteve.reinhardt@amd.com 2149142Ssteve.reinhardt@amd.com 2159142Ssteve.reinhardt@amd.com/** 2169142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2179142Ssteve.reinhardt@amd.com */ 2189142Ssteve.reinhardt@amd.cominline bool 2199142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const char *prefix) 2209142Ssteve.reinhardt@amd.com{ 2219142Ssteve.reinhardt@amd.com return (s.compare(0, strlen(prefix), prefix) == 0); 2229142Ssteve.reinhardt@amd.com} 2239142Ssteve.reinhardt@amd.com 2249142Ssteve.reinhardt@amd.com 2259142Ssteve.reinhardt@amd.com/** 2269142Ssteve.reinhardt@amd.com * Return true if 's' starts with the prefix string 'prefix'. 2279142Ssteve.reinhardt@amd.com */ 2289142Ssteve.reinhardt@amd.cominline bool 2299142Ssteve.reinhardt@amd.comstartswith(const std::string &s, const std::string &prefix) 2309142Ssteve.reinhardt@amd.com{ 2319142Ssteve.reinhardt@amd.com return (s.compare(0, prefix.size(), prefix) == 0); 2329142Ssteve.reinhardt@amd.com} 2339142Ssteve.reinhardt@amd.com 2349142Ssteve.reinhardt@amd.com 23510386Sandreas.hansson@arm.com#endif //__BASE_STR_HH__ 236