wcstring.h

// =====================================================================================================================
//  fennec, a free and open source game engine
//  Copyright © 2025  Medusa Slockbower
//
//  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 <https://www.gnu.org/licenses/>.
// =====================================================================================================================
 
#ifndef FENNEC_STRING_wcstring_H
#define FENNEC_STRING_wcstring_H
 
#include <fennec/string/detail/_ctype.h>
#include <fennec/memory/detail/_string.h>
 
#include <fennec/lang/assert.h>
 
#include <fennec/math/common.h>
 
namespace fennec
{
 
// TODO: Document
 
using ::iswalnum;
using ::iswalpha;
using ::iswlower;
using ::iswupper;
using ::iswdigit;
using ::iswxdigit;
using ::iswcntrl;
using ::iswgraph;
using ::iswspace;
using ::iswblank;
using ::iswprint;
using ::iswpunct;
 
using ::towlower;
using ::towupper;
 
using ::towctrans;
using ::wctrans;
 
struct wcstring
{
public:
    static constexpr size_t npos = -1;
    using char_t = wchar_t;
 
// Constructors ========================================================================================================
 
    constexpr wcstring()
        : _str(nullptr), _size(0), _const(true) {
    }
 
    constexpr wcstring(nullptr_t)
        : _str(nullptr), _size(0), _const(true) {
    }
 
    constexpr wcstring(wchar_t* str, size_t n)
        : _str(str)
        , _size(n - 1)
        , _const(false) {
        assert(_str[n - 1] == '\0', "Invalid NTBS.");
    }
 
    template<size_t n>
    constexpr wcstring(wchar_t (&str)[n])
        : _str(str)
        , _size(n - 1)
        , _const(false) {
        assert(_str[n - 1] == '\0', "Invalid NTBS.");
    }
 
    constexpr wcstring(const wchar_t* str, size_t n)
        : _cstr(str)
        , _size(n - 1)
        , _const(true) {
        assert(_cstr[n - 1] == '\0', "Invalid NTBS.");
    }
 
    template<size_t n>
    constexpr wcstring(const wchar_t (&str)[n])
        : _cstr(str)
        , _size(n - 1)
        , _const(true) {
        assert(_cstr[n - 1] == '\0', "Invalid NTBS.");
    }
 
    constexpr wcstring(wcstring&& str) noexcept
        : _cstr(str._cstr)
        , _size(str._size)
        , _const(str._const) {
        str._cstr  = nullptr;
        str._size  = 0;
        str._const = true;
    }
 
    // TODO: Document
    constexpr wcstring(const wcstring&) = delete;
    constexpr ~wcstring() = default;
 
    constexpr wcstring& operator=(nullptr_t) {
        _str = nullptr, _size = 0, _const = true;
        return *this;
    }
 
    // TODO: Document
    template<size_t n>
    constexpr wcstring& operator=(wchar_t(&str)[n]) {
        assert(_str[n - 1] == '\0', "Invalid NTBS.");
        _str = str, _size = n - 1, _const = false;
        return *this;
    }
 
    // TODO: Document
    template<size_t n>
    constexpr wcstring& operator=(const wchar_t(&str)[n]) {
        assert(str[n - 1] == '\0', "Invalid NTBS.");
        _cstr = str; _size = n - 1; _const = true;
        return *this;
    }
 
    // TODO: Document
    constexpr wcstring& operator=(wcstring&& str) noexcept {
        _cstr  = str._cstr;  str._cstr  = nullptr;
        _size  = str._size;  str._size  = 0;
        _const = str._const; str._const = true;
        return *this;
    }
 
 
// Properties ==========================================================================================================
 
    constexpr size_t size() const { return _size; }
 
    constexpr size_t capacity() const { return _size + 1; }
 
    constexpr bool empty() const {
        return _cstr == nullptr || _size == 0;
    }
 
 
// Access ==============================================================================================================
 
    constexpr wchar_t& operator[](size_t i) {
        assertd(not _const, "Attempted to Access Const-Qualified Memory as Non-Const");
        assertd(i < size(), "Array Out of Bounds");
        return _str[i];
    }
 
    constexpr const wchar_t& operator[](size_t i) const {
        assertd(i < size(), "Array Out of Bounds");
        return _cstr[i];
    }
 
    constexpr wchar_t* data() {
        return _str;
    }
 
    constexpr const wchar_t* data() const {
        return _cstr;
    }
 
    constexpr operator const wchar_t*() const {
        return _cstr;
    }
 
 
// Examination =========================================================================================================
 
    constexpr size_t length() const {
        return find('\0');
    }
 
    constexpr int compare(const wcstring& str, size_t i = 0, size_t n = npos) const {
        if (i >= _size) {
            return -1;
        }
 
        n = min(n, max(_size, str._size) + 1);
        return ::wcsncmp(_cstr + i, str, n);
    }
 
    template<size_t n>
    constexpr bool operator==(const wchar_t (&str)[n]) const {
        return compare(wcstring(str)) == 0;
    }
 
    constexpr bool operator==(const wcstring& str) const {
        return compare(str) == 0;
    }
 
    constexpr size_t find(wchar_t c, size_t i = 0) const {
        if (i >= _size) { // bounds check
            return _size;
        }
 
        const wchar_t* loc = ::wcschr(_cstr + i, c); // get location using strchr
        return loc ? loc - _cstr : _size; // return size if not found
    }
 
    constexpr size_t find(const wcstring& str, size_t i = 0) const {
        if (i + str._size > _size) { // bounds check
            return _size;
        }
 
        const wchar_t* loc = ::wcsstr(_cstr + i, str); // get location using strstr
        return loc ? loc - _cstr : _size; // return size if not found
    }
 
    constexpr size_t rfind(char c, size_t i = npos) const {
        if (_size == 0) {
            return _size;
        }
 
        i = min(i, _size - 1); // clamp i to bounds
        do {
            if (_cstr[i] == c) return i; // loop backwards looking for c
        } while (i--);
        return _size; // base case
    }
 
    constexpr size_t rfind(const wcstring& str, size_t i = npos) const {
        if (_size == 0) {
            return _size;
        }
 
        const char first = str[0];
        i = min(i, _size - str._size);
        do {
            if(_cstr[i] == first) {
                if (compare(str, i, str._size - 1) == 0) {
                    return i;
                }
            } // loop backwards looking for str
        } while (i--);
        return _size; // base case
    }
 
private:
    union { // hack to allow both const qualified and non-const strings
        wchar_t*        _str;
        const wchar_t* _cstr;
    };
    size_t _size;
    bool  _const;
};
 
template<>
struct hash<wcstring> : hash<byte_array> {
    constexpr size_t operator()(const wcstring& str) const {
        return hash<byte_array>::operator()(byte_array(str, str.size()));
    }
};
 
}
 
#endif // FENNEC_STRING_wcstring_H