/* * DISTRHO Plugin Framework (DPF) * Copyright (C) 2012-2014 Filipe Coelho * * Permission to use, copy, modify, and/or distribute this software for any purpose with * or without fee is hereby granted, provided that the above copyright notice and this * permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD * TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN * NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef DISTRHO_STRING_HPP_INCLUDED #define DISTRHO_STRING_HPP_INCLUDED #include "d_leakdetector.hpp" // ----------------------------------------------------------------------- // d_string class class d_string { public: // ------------------------------------------------------------------- // constructors (no explicit conversions allowed) /* * Empty string. */ explicit d_string() noexcept { _init(); } /* * Simple character. */ explicit d_string(const char c) noexcept { char ch[2]; ch[0] = c; ch[1] = '\0'; _init(); _dup(ch); } /* * Simple char string. */ explicit d_string(char* const strBuf) noexcept { _init(); _dup(strBuf); } /* * Simple const char string. */ explicit d_string(const char* const strBuf) noexcept { _init(); _dup(strBuf); } /* * Integer. */ explicit d_string(const int value) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, "%d", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Unsigned integer, possibly in hexadecimal. */ explicit d_string(const unsigned int value, const bool hexadecimal = false) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, hexadecimal ? "0x%x" : "%u", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Long integer. */ explicit d_string(const long value) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, "%ld", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Long unsigned integer, possibly hexadecimal. */ explicit d_string(const unsigned long value, const bool hexadecimal = false) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, hexadecimal ? "0x%lx" : "%lu", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Long long integer. */ explicit d_string(const long long value) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, "%lld", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Long long unsigned integer, possibly hexadecimal. */ explicit d_string(const unsigned long long value, const bool hexadecimal = false) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, hexadecimal ? "0x%llx" : "%llu", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Single-precision floating point number. */ explicit d_string(const float value) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, "%f", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } /* * Double-precision floating point number. */ explicit d_string(const double value) noexcept { char strBuf[0xff+1]; std::snprintf(strBuf, 0xff, "%g", value); strBuf[0xff] = '\0'; _init(); _dup(strBuf); } // ------------------------------------------------------------------- // non-explicit constructor /* * Create string from another string. */ d_string(const d_string& str) noexcept { _init(); _dup(str.fBuffer); } // ------------------------------------------------------------------- // destructor /* * Destructor. */ ~d_string() noexcept { DISTRHO_SAFE_ASSERT_RETURN(fBuffer != nullptr,); if (fBuffer == _null()) return; std::free(fBuffer); fBuffer = nullptr; fBufferLen = 0; } // ------------------------------------------------------------------- // public methods /* * Get length of the string. */ size_t length() const noexcept { return fBufferLen; } /* * Check if the string is empty. */ bool isEmpty() const noexcept { return (fBufferLen == 0); } /* * Check if the string is not empty. */ bool isNotEmpty() const noexcept { return (fBufferLen != 0); } /* * Check if the string contains another string, optionally ignoring case. */ bool contains(const char* const strBuf, const bool ignoreCase = false) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(strBuf != nullptr, false); if (ignoreCase) { #ifdef __USE_GNU return (strcasestr(fBuffer, strBuf) != nullptr); #else d_string tmp1(fBuffer), tmp2(strBuf); // memory allocation failed or empty string(s) if (tmp1.fBuffer == _null() || tmp2.fBuffer == _null()) return false; tmp1.toLower(); tmp2.toLower(); return (std::strstr(tmp1, tmp2) != nullptr); #endif } return (std::strstr(fBuffer, strBuf) != nullptr); } /* * Check if character at 'pos' is a digit. */ bool isDigit(const size_t pos) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(pos < fBufferLen, false); return (fBuffer[pos] >= '0' && fBuffer[pos] <= '9'); } /* * Check if the string starts with the character 'c'. */ bool startsWith(const char c) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(c != '\0', false); return (fBufferLen > 0 && fBuffer[0] == c); } /* * Check if the string starts with the string 'prefix'. */ bool startsWith(const char* const prefix) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(prefix != nullptr, false); const size_t prefixLen(std::strlen(prefix)); if (fBufferLen < prefixLen) return false; return (std::strncmp(fBuffer, prefix, prefixLen) == 0); } /* * Check if the string ends with the character 'c'. */ bool endsWith(const char c) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(c != '\0', false); return (fBufferLen > 0 && fBuffer[fBufferLen-1] == c); } /* * Check if the string ends with the string 'suffix'. */ bool endsWith(const char* const suffix) const noexcept { DISTRHO_SAFE_ASSERT_RETURN(suffix != nullptr, false); const size_t suffixLen(std::strlen(suffix)); if (fBufferLen < suffixLen) return false; return (std::strncmp(fBuffer + (fBufferLen-suffixLen), suffix, suffixLen) == 0); } /* * Find the first occurrence of character 'c' in the string. * Returns "length()" if the character is not found. */ size_t find(const char c, bool* const found = nullptr) const noexcept { if (fBufferLen == 0 || c == '\0') { if (found != nullptr) *found = false; return fBufferLen; } for (size_t i=0; i < fBufferLen; ++i) { if (fBuffer[i] == c) { if (found != nullptr) *found = true; return i; } } if (found != nullptr) *found = false; return fBufferLen; } /* * Find the first occurrence of string 'strBuf' in the string. * Returns "length()" if the string is not found. */ size_t find(const char* const strBuf, bool* const found = nullptr) const noexcept { if (fBufferLen == 0 || strBuf == nullptr || strBuf[0] == '\0') { if (found != nullptr) *found = false; return fBufferLen; } if (char* const subStrBuf = std::strstr(fBuffer, strBuf)) { const ssize_t ret(subStrBuf - fBuffer); if (ret < 0) { // should never happen! d_safe_assert("ret >= 0", __FILE__, __LINE__); if (found != nullptr) *found = false; return fBufferLen; } if (found != nullptr) *found = true; return static_cast(ret); } if (found != nullptr) *found = false; return fBufferLen; } /* * Find the last occurrence of character 'c' in the string. * Returns "length()" if the character is not found. */ size_t rfind(const char c, bool* const found = nullptr) const noexcept { if (fBufferLen == 0 || c == '\0') { if (found != nullptr) *found = false; return fBufferLen; } for (size_t i=fBufferLen; i > 0; --i) { if (fBuffer[i-1] == c) { if (found != nullptr) *found = true; return i-1; } } if (found != nullptr) *found = false; return fBufferLen; } /* * Find the last occurrence of string 'strBuf' in the string. * Returns "length()" if the string is not found. */ size_t rfind(const char* const strBuf, bool* const found = nullptr) const noexcept { if (found != nullptr) *found = false; if (fBufferLen == 0 || strBuf == nullptr || strBuf[0] == '\0') return fBufferLen; const size_t strBufLen(std::strlen(strBuf)); size_t ret = fBufferLen; const char* tmpBuf = fBuffer; for (size_t i=0; i < fBufferLen; ++i) { if (std::strstr(tmpBuf+1, strBuf) == nullptr && std::strncmp(tmpBuf, strBuf, strBufLen) == 0) { if (found != nullptr) *found = true; break; } --ret; ++tmpBuf; } return fBufferLen-ret; } /* * Clear the string. */ void clear() noexcept { truncate(0); } /* * Replace all occurrences of character 'before' with character 'after'. */ void replace(const char before, const char after) noexcept { DISTRHO_SAFE_ASSERT_RETURN(before != '\0' && after != '\0',); for (size_t i=0; i < fBufferLen; ++i) { if (fBuffer[i] == before) fBuffer[i] = after; } } /* * Truncate the string to size 'n'. */ void truncate(const size_t n) noexcept { if (n >= fBufferLen) return; for (size_t i=n; i < fBufferLen; ++i) fBuffer[i] = '\0'; fBufferLen = n; } /* * Convert all non-basic characters to '_'. */ void toBasic() noexcept { for (size_t i=0; i < fBufferLen; ++i) { if (fBuffer[i] >= '0' && fBuffer[i] <= '9') continue; if (fBuffer[i] >= 'A' && fBuffer[i] <= 'Z') continue; if (fBuffer[i] >= 'a' && fBuffer[i] <= 'z') continue; if (fBuffer[i] == '_') continue; fBuffer[i] = '_'; } } /* * Convert to all ascii characters to lowercase. */ void toLower() noexcept { static const char kCharDiff('a' - 'A'); for (size_t i=0; i < fBufferLen; ++i) { if (fBuffer[i] >= 'A' && fBuffer[i] <= 'Z') fBuffer[i] = static_cast(fBuffer[i] + kCharDiff); } } /* * Convert to all ascii characters to uppercase. */ void toUpper() noexcept { static const char kCharDiff('a' - 'A'); for (size_t i=0; i < fBufferLen; ++i) { if (fBuffer[i] >= 'a' && fBuffer[i] <= 'z') fBuffer[i] = static_cast(fBuffer[i] - kCharDiff); } } /* * Direct access to the string buffer (read-only). */ const char* buffer() const noexcept { return fBuffer; } // ------------------------------------------------------------------- // public operators operator const char*() const noexcept { return fBuffer; } char operator[](const size_t pos) const noexcept { if (pos < fBufferLen) return fBuffer[pos]; d_safe_assert("pos < fBufferLen", __FILE__, __LINE__); static char fallback; fallback = '\0'; return fallback; } char& operator[](const size_t pos) noexcept { if (pos < fBufferLen) return fBuffer[pos]; d_safe_assert("pos < fBufferLen", __FILE__, __LINE__); static char fallback; fallback = '\0'; return fallback; } bool operator==(const char* const strBuf) const noexcept { return (strBuf != nullptr && std::strcmp(fBuffer, strBuf) == 0); } bool operator==(const d_string& str) const noexcept { return operator==(str.fBuffer); } bool operator!=(const char* const strBuf) const noexcept { return !operator==(strBuf); } bool operator!=(const d_string& str) const noexcept { return !operator==(str.fBuffer); } d_string& operator=(const char* const strBuf) noexcept { _dup(strBuf); return *this; } d_string& operator=(const d_string& str) noexcept { _dup(str.fBuffer); return *this; } d_string& operator+=(const char* const strBuf) noexcept { if (strBuf == nullptr) return *this; const size_t newBufSize = fBufferLen + std::strlen(strBuf) + 1; char newBuf[newBufSize]; std::strcpy(newBuf, fBuffer); std::strcat(newBuf, strBuf); _dup(newBuf, newBufSize-1); return *this; } d_string& operator+=(const d_string& str) noexcept { return operator+=(str.fBuffer); } d_string operator+(const char* const strBuf) noexcept { const size_t newBufSize = fBufferLen + ((strBuf != nullptr) ? std::strlen(strBuf) : 0) + 1; char newBuf[newBufSize]; std::strcpy(newBuf, fBuffer); if (strBuf != nullptr) std::strcat(newBuf, strBuf); return d_string(newBuf); } d_string operator+(const d_string& str) noexcept { return operator+(str.fBuffer); } // ------------------------------------------------------------------- private: char* fBuffer; // the actual string buffer size_t fBufferLen; // string length /* * Static null string. * Prevents allocation for new and/or empty strings. */ static char* _null() noexcept { static char sNull = '\0'; return &sNull; } /* * Shared init function. * Called on all constructors. */ void _init() noexcept { fBuffer = _null(); fBufferLen = 0; } /* * Helper function. * Called whenever the string needs to be allocated. * * Notes: * - Allocates string only if 'strBuf' is not null and new string contents are different * - If 'strBuf' is null, 'size' must be 0 */ void _dup(const char* const strBuf, const size_t size = 0) noexcept { if (strBuf != nullptr) { // don't recreate string if contents match if (std::strcmp(fBuffer, strBuf) == 0) return; if (fBuffer != _null()) std::free(fBuffer); fBufferLen = (size > 0) ? size : std::strlen(strBuf); fBuffer = (char*)std::malloc(fBufferLen+1); if (fBuffer == nullptr) return _init(); std::strcpy(fBuffer, strBuf); fBuffer[fBufferLen] = '\0'; } else { DISTRHO_SAFE_ASSERT(size == 0); // don't recreate null string if (fBuffer == _null()) return; DISTRHO_SAFE_ASSERT(fBuffer != nullptr); std::free(fBuffer); _init(); } } DISTRHO_LEAK_DETECTOR(d_string) DISTRHO_PREVENT_HEAP_ALLOCATION }; // ----------------------------------------------------------------------- static inline d_string operator+(const d_string& strBefore, const char* const strBufAfter) noexcept { const char* const strBufBefore = strBefore.buffer(); const size_t newBufSize = strBefore.length() + ((strBufAfter != nullptr) ? std::strlen(strBufAfter) : 0) + 1; char newBuf[newBufSize]; std::strcpy(newBuf, strBufBefore); std::strcat(newBuf, strBufAfter); return d_string(newBuf); } static inline d_string operator+(const char* const strBufBefore, const d_string& strAfter) noexcept { const char* const strBufAfter = strAfter.buffer(); const size_t newBufSize = ((strBufBefore != nullptr) ? std::strlen(strBufBefore) : 0) + strAfter.length() + 1; char newBuf[newBufSize]; std::strcpy(newBuf, strBufBefore); std::strcat(newBuf, strBufAfter); return d_string(newBuf); } // ----------------------------------------------------------------------- #endif // DISTRHO_STRING_HPP_INCLUDED