/* * Carla common utils * Copyright (C) 2011-2013 Filipe Coelho * * 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 2 of * the License, or 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. * * For a full copy of the GNU General Public License see the GPL.txt file */ #ifndef __CARLA_STRING_HPP__ #define __CARLA_STRING_HPP__ #include "CarlaBase64Utils.hpp" #include "CarlaJuceUtils.hpp" // ------------------------------------------------- // CarlaString class class CarlaString { public: // --------------------------------------------- // constructors (no explicit conversions allowed) explicit CarlaString() { _init(); _dup(nullptr); } explicit CarlaString(char* const strBuf) { _init(); _dup(strBuf); } explicit CarlaString(const char* const strBuf) { _init(); _dup(strBuf); } explicit CarlaString(const int value) { const size_t strBufSize = std::abs(value/10) + 3; char strBuf[strBufSize]; std::snprintf(strBuf, strBufSize, "%d", value); _init(); _dup(strBuf, strBufSize); } explicit CarlaString(const unsigned int value, const bool hexadecimal = false) { const size_t strBufSize = value/10 + 2 + (hexadecimal ? 2 : 0); char strBuf[strBufSize]; std::snprintf(strBuf, strBufSize, hexadecimal ? "0x%x" : "%u", value); _init(); _dup(strBuf, strBufSize); } explicit CarlaString(const long int value) { const size_t strBufSize = std::abs(value/10) + 3; char strBuf[strBufSize]; std::snprintf(strBuf, strBufSize, "%ld", value); _init(); _dup(strBuf, strBufSize); } explicit CarlaString(const unsigned long int value, const bool hexadecimal = false) { const size_t strBufSize = value/10 + 2 + (hexadecimal ? 2 : 0); char strBuf[strBufSize]; std::snprintf(strBuf, strBufSize, hexadecimal ? "0x%lx" : "%lu", value); _init(); _dup(strBuf, strBufSize); } explicit CarlaString(const float value) { char strBuf[0xff]; std::snprintf(strBuf, 0xff, "%f", value); _init(); _dup(strBuf); } explicit CarlaString(const double value) { char strBuf[0xff]; std::snprintf(strBuf, 0xff, "%g", value); _init(); _dup(strBuf); } // --------------------------------------------- // non-explicit constructor CarlaString(const CarlaString& str) { _init(); _dup(str.buffer); } // --------------------------------------------- // deconstructor ~CarlaString() { CARLA_ASSERT(buffer != nullptr); delete[] buffer; } // --------------------------------------------- // public methods size_t length() const { return bufferLen; } bool isEmpty() const { return (bufferLen == 0); } bool isNotEmpty() const { return (bufferLen != 0); } #if __USE_GNU bool contains(const char* const strBuf, const bool ignoreCase = false) const { if (strBuf == nullptr) return false; if (ignoreCase) return (strcasestr(buffer, strBuf) != nullptr); else return (std::strstr(buffer, strBuf) != nullptr); } bool contains(const CarlaString& str, const bool ignoreCase = false) const { return contains(str.buffer, ignoreCase); } #else bool contains(const char* const strBuf) const { if (strBuf == nullptr) return false; return (std::strstr(buffer, strBuf) != nullptr); } bool contains(const CarlaString& str) const { return contains(str.buffer); } #endif bool isDigit(const size_t pos) const { if (pos >= bufferLen) return false; return (buffer[pos] >= '0' && buffer[pos] <= '9'); } void clear() { truncate(0); } size_t find(const char c) { for (size_t i=0; i < bufferLen; i++) { if (buffer[i] == c) return i; } return 0; } size_t rfind(const char c) { size_t pos = 0; for (size_t i=0; i < bufferLen; i++) { if (buffer[i] == c) pos = i; } return pos; } void replace(const char before, const char after) { if (after == '\0') return; for (size_t i=0; i < bufferLen; i++) { if (buffer[i] == before) buffer[i] = after; else if (buffer[i] == '\0') break; } } void truncate(const size_t n) { if (n >= bufferLen) return; for (size_t i=n; i < bufferLen; i++) buffer[i] = '\0'; bufferLen = n; } void toBasic() { for (size_t i=0; i < bufferLen; i++) { if (buffer[i] >= '0' && buffer[i] <= '9') continue; if (buffer[i] >= 'A' && buffer[i] <= 'Z') continue; if (buffer[i] >= 'a' && buffer[i] <= 'z') continue; if (buffer[i] == '_') continue; buffer[i] = '_'; } } void toLower() { static const char charDiff = 'a' - 'A'; for (size_t i=0; i < bufferLen; i++) { if (buffer[i] >= 'A' && buffer[i] <= 'Z') buffer[i] += charDiff; } } void toUpper() { static const char charDiff = 'a' - 'A'; for (size_t i=0; i < bufferLen; i++) { if (buffer[i] >= 'a' && buffer[i] <= 'z') buffer[i] -= charDiff; } } void toBase64() { importBinaryAsBase64((const uint8_t*)buffer, bufferLen); } void fromBase64() { uint8_t buffer2[carla_base64_decoded_max_len(buffer)]; if (unsigned int len = carla_base64_decode(buffer, buffer2)) _dup((char*)buffer2, len); else clear(); } void importBinaryAsBase64(const uint8_t* const raw, const size_t rawLen) { const size_t rawBufferSize = carla_base64_encoded_len(rawLen) + 1; char rawBuffer[rawBufferSize]; carla_base64_encode(raw, rawLen, rawBuffer); _dup(rawBuffer, rawBufferSize-1); } template void importBinaryAsBase64(const T* const t) { const size_t tSize = sizeof(T); importBinaryAsBase64((const uint8_t*)t, tSize); } size_t exportAsBase64Binary(uint8_t** const rawPtr) { uint8_t binaryBuffer[carla_base64_decoded_max_len(buffer)]; if (unsigned int len = carla_base64_decode(buffer, binaryBuffer)) { uint8_t* const binaryBufferHeap = new uint8_t[len]; carla_copy(binaryBufferHeap, binaryBuffer, len); *rawPtr = binaryBufferHeap; return len; } return 0; } template T* exportAsBase64Binary() { uint8_t binaryBuffer[carla_base64_decoded_max_len(buffer)]; if (unsigned int len = carla_base64_decode(buffer, binaryBuffer)) { CARLA_ASSERT_INT2(len == sizeof(T), len, sizeof(T)); T* const t = new T(); std::memcpy(t, binaryBuffer, len); return t; } return nullptr; } // --------------------------------------------- // public operators operator const char*() const { return buffer; } char& operator[](const size_t pos) { return buffer[pos]; } bool operator==(const char* const strBuf) const { return (strBuf != nullptr && std::strcmp(buffer, strBuf) == 0); } bool operator==(const CarlaString& str) const { return operator==(str.buffer); } bool operator!=(const char* const strBuf) const { return !operator==(strBuf); } bool operator!=(const CarlaString& str) const { return !operator==(str.buffer); } CarlaString& operator=(const char* const strBuf) { _dup(strBuf); return *this; } CarlaString& operator=(const CarlaString& str) { return operator=(str.buffer); } CarlaString& operator+=(const char* const strBuf) { const size_t newBufSize = bufferLen + ((strBuf != nullptr) ? std::strlen(strBuf) : 0) + 1; char newBuf[newBufSize]; std::strcpy(newBuf, buffer); std::strcat(newBuf, strBuf); _dup(newBuf, newBufSize-1); return *this; } CarlaString& operator+=(const CarlaString& str) { return operator+=(str.buffer); } CarlaString operator+(const char* const strBuf) { const size_t newBufSize = bufferLen + ((strBuf != nullptr) ? std::strlen(strBuf) : 0) + 1; char newBuf[newBufSize]; std::strcpy(newBuf, buffer); std::strcat(newBuf, strBuf); return CarlaString(newBuf); } CarlaString operator+(const CarlaString& str) { return operator+(str.buffer); } // --------------------------------------------- private: char* buffer; size_t bufferLen; bool firstInit; void _init() { buffer = nullptr; bufferLen = 0; firstInit = true; } // allocate string strBuf if not null // size > 0 only if strBuf is valid void _dup(const char* const strBuf, const size_t size = 0) { if (strBuf != nullptr) { // don't recreate string if contents match if (firstInit || std::strcmp(buffer, strBuf) != 0) { if (! firstInit) { CARLA_ASSERT(buffer != nullptr); delete[] buffer; } bufferLen = (size > 0) ? size : std::strlen(strBuf); buffer = new char[bufferLen+1]; std::strcpy(buffer, strBuf); buffer[bufferLen] = '\0'; firstInit = false; } } else { CARLA_ASSERT(size == 0); // don't recreate null string if (firstInit || bufferLen != 0) { if (! firstInit) { CARLA_ASSERT(buffer != nullptr); delete[] buffer; } bufferLen = 0; buffer = new char[1]; buffer[0] = '\0'; firstInit = false; } } } CARLA_LEAK_DETECTOR(CarlaString) CARLA_PREVENT_HEAP_ALLOCATION }; static inline CarlaString operator+(const CarlaString& strBefore, const char* const strBufAfter) { const char* const strBufBefore = (const char*)strBefore; 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 CarlaString(newBuf); } static inline CarlaString operator+(const char* const strBufBefore, const CarlaString& strAfter) { const char* const strBufAfter = (const char*)strAfter; 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 CarlaString(newBuf); } // ------------------------------------------------- #endif // __CARLA_UTILS_HPP__