/* * Cppcheck - A tool for static C/C++ code analysis * Copyright (C) 2007-2023 Cppcheck team. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ //--------------------------------------------------------------------------- #ifndef utilsH #define utilsH //--------------------------------------------------------------------------- #include "config.h" #include #include #include #include #include #include #include #include #include struct SelectMapKeys { template typename Pair::first_type operator()(const Pair& p) const { return p.first; } }; struct SelectMapValues { template typename Pair::second_type operator()(const Pair& p) const { return p.second; } }; template bool contains(const Range& r, const T& x) { return std::find(r.cbegin(), r.cend(), x) != r.cend(); } template bool contains(const std::initializer_list& r, const T& x) { return std::find(r.begin(), r.end(), x) != r.end(); } template bool contains(const std::initializer_list& r, const U& x) { return std::find(r.begin(), r.end(), x) != r.end(); } template inline std::array makeArray(T x, Ts... xs) { return {std::move(x), std::move(xs)...}; } // Enum hash for C++11. This is not needed in C++14 struct EnumClassHash { template std::size_t operator()(T t) const { return static_cast(t); } }; inline bool endsWith(const std::string &str, char c) { return !str.empty() && str.back() == c; } inline bool endsWith(const std::string &str, const char end[], std::size_t endlen) { return (str.size() >= endlen) && (str.compare(str.size()-endlen, endlen, end)==0); } template bool endsWith(const std::string& str, const char (&end)[N]) { return endsWith(str, end, N - 1); } inline static bool isPrefixStringCharLiteral(const std::string &str, char q, const std::string& p) { // str must be at least the prefix plus the start and end quote if (str.length() < p.length() + 2) return false; // check for end quote if (!endsWith(str, q)) return false; // check for start quote if (str[p.size()] != q) return false; // check for prefix if (str.compare(0, p.size(), p) != 0) return false; return true; } inline static bool isStringCharLiteral(const std::string &str, char q) { // early out to avoid the loop if (!endsWith(str, q)) return false; static const std::array suffixes{"", "u8", "u", "U", "L"}; return std::any_of(suffixes.cbegin(), suffixes.cend(), [&](const std::string& p) { return isPrefixStringCharLiteral(str, q, p); }); } inline static bool isStringLiteral(const std::string &str) { return isStringCharLiteral(str, '"'); } inline static bool isCharLiteral(const std::string &str) { return isStringCharLiteral(str, '\''); } inline static std::string getStringCharLiteral(const std::string &str, char q) { const std::size_t quotePos = str.find(q); return str.substr(quotePos + 1U, str.size() - quotePos - 2U); } inline static std::string getStringLiteral(const std::string &str) { if (isStringLiteral(str)) return getStringCharLiteral(str, '"'); return ""; } inline static std::string getCharLiteral(const std::string &str) { if (isCharLiteral(str)) return getStringCharLiteral(str, '\''); return ""; } inline static const char *getOrdinalText(int i) { if (i == 1) return "st"; if (i == 2) return "nd"; if (i == 3) return "rd"; return "th"; } CPPCHECKLIB int caseInsensitiveStringCompare(const std::string& lhs, const std::string& rhs); CPPCHECKLIB bool isValidGlobPattern(const std::string& pattern); CPPCHECKLIB bool matchglob(const std::string& pattern, const std::string& name); CPPCHECKLIB bool matchglobs(const std::vector &patterns, const std::string &name); CPPCHECKLIB void strTolower(std::string& str); template::value, bool>::type=true> bool strToInt(const std::string& str, T &num, std::string* err = nullptr) { long long tmp; try { std::size_t idx = 0; tmp = std::stoll(str, &idx); if (idx != str.size()) { if (err) *err = "not an integer"; return false; } } catch (const std::out_of_range&) { if (err) *err = "out of range (stoll)"; return false; } catch (const std::invalid_argument &) { if (err) *err = "not an integer"; return false; } if (str.front() == '-' && std::numeric_limits::min() == 0) { if (err) *err = "needs to be positive"; return false; } if (tmp < std::numeric_limits::min() || tmp > std::numeric_limits::max()) { if (err) *err = "out of range (limits)"; return false; } num = static_cast(tmp); return true; } template::value, bool>::type=true> bool strToInt(const std::string& str, T &num, std::string* err = nullptr) { unsigned long long tmp; try { std::size_t idx = 0; tmp = std::stoull(str, &idx); if (idx != str.size()) { if (err) *err = "not an integer"; return false; } } catch (const std::out_of_range&) { if (err) *err = "out of range (stoull)"; return false; } catch (const std::invalid_argument &) { if (err) *err = "not an integer"; return false; } if (str.front() == '-') { if (err) *err = "needs to be positive"; return false; } if (tmp > std::numeric_limits::max()) { if (err) *err = "out of range (limits)"; return false; } num = tmp; return true; } template T strToInt(const std::string& str) { T tmp = 0; std::string err; if (!strToInt(str, tmp, &err)) throw std::runtime_error("converting '" + str + "' to integer failed - " + err); return tmp; } /** * Simple helper function: * \return size of array * */ template std::size_t getArrayLength(const T (& /*unused*/)[size]) { return size; } /** this is meant as a replacement for when we cannot print a pointer via the stream insertion operator (operator<<) for performance reasons */ // TODO: should give portable value / only used by Tokenizer::dump() and underlying functions - something deterministic would also help with comparing the output static inline std::string ptr_to_string(const void* p) { #if (defined(__APPLE__) && defined(__MACH__)) if (p == nullptr) return "0x0"; #elif !defined(_WIN32) || defined(__MINGW32__) if (p == nullptr) return "0"; #endif static constexpr int ptr_size = sizeof(void*); #if defined(_WIN32) && !defined(__MINGW32__) // two characters of each byte / contains terminating \0 static constexpr int buf_size = (ptr_size * 2) + 1; #else // two characters of each byte / contains 0x prefix and contains terminating \0 static constexpr int buf_size = (ptr_size * 2) + 2 + 1; #endif char buf[buf_size]; // needs to be signed so we don't underflow in padding loop int idx = sizeof(buf) - 1; buf[idx--] = '\0'; // terminate string uintptr_t l = reinterpret_cast(p); while (l != 0) { char c; const uintptr_t temp = l % 16; // get the remainder if (temp < 10) { // 0-9 c = '0' + temp; } else { #if !defined(_WIN32) || defined(__MINGW32__) // a-f c = 'a' + (temp - 10); #else // A-F c = 'A' + (temp - 10); #endif } buf[idx--] = c; // store in reverse order l = l / 16; } #if defined(_WIN32) && !defined(__MINGW32__) // pad address with 0 while (idx >= 0) { buf[idx--] = '0'; } // 000000F0A61FF122 or 0230FB33 return buf; #else // add 0x prefix buf[idx--] = 'x'; buf[idx--] = '0'; // 0x7ffc5aa334d8 return &buf[idx+1]; #endif } static inline std::string bool_to_string(bool b) { return b ? "true" : "false"; } #endif