Class string_view

src/fl/stl/string_view.h:17–434

string_view: A non-owning view into a contiguous sequence of characters Provides std::string_view-like functionality for embedded environments Does NOT allocate memory or manage ownership Similar to span but with string-specific operations

// Does NOT allocate memory or manage ownership
// Similar to span<const char> but with string-specific operations
class string_view {
  public:
    // ======= STANDARD CONTAINER TYPE ALIASES =======
    using element_type = const char;
    using value_type = char;
    using size_type = fl::size;
    using difference_type = fl::i32;
    using pointer = const char*;
    using const_pointer = const char*;
    using reference = const char&;
    using const_reference = const char&;
    using iterator = const char*;
    using const_iterator = const char*;
    using reverse_iterator = const char*;
    using const_reverse_iterator = const char*;

    // Special value to indicate "not found" or "until end"
    // Using constexpr for C++11 implicit inline semantics - no ODR definition needed
    static constexpr fl::size npos = static_cast<fl::size>(-1);

    // ======= CONSTRUCTORS =======
    // Default constructor - empty view
    constexpr string_view() FL_NOEXCEPT : mData(nullptr), mSize(0) {}

    // Constructor from null-terminated C string
    constexpr string_view(const char* str) FL_NOEXCEPT
        : mData(str), mSize(str ? strlen(str) : 0) {}

    // Constructor from pointer and length
    constexpr string_view(const char* str, fl::size len) FL_NOEXCEPT
        : mData(str), mSize(len) {}

    // Constructor from C-array
    template <fl::size N>
    constexpr string_view(const char (&arr)[N]) FL_NOEXCEPT
        : mData(arr), mSize(N - 1) {}  // Subtract 1 for null terminator

    // Constructor from fl::basic_string (and therefore fl::string).
    // Defined in basic_string.cpp.hpp where basic_string is complete.
    string_view(const basic_string& str) FL_NOEXCEPT;

    // Copy constructor
    string_view(const string_view& other) FL_NOEXCEPT = default;

    // Assignment operator
    string_view& operator=(const string_view& other) = default;

    // ======= ITERATORS =======
    constexpr iterator begin() const FL_NOEXCEPT { return mData; }
    constexpr iterator end() const FL_NOEXCEPT { return mData + mSize; }
    constexpr const_iterator cbegin() const FL_NOEXCEPT { return mData; }
    constexpr const_iterator cend() const FL_NOEXCEPT { return mData + mSize; }

    constexpr reverse_iterator rbegin() const FL_NOEXCEPT { return mData + mSize - 1; }
    constexpr reverse_iterator rend() const FL_NOEXCEPT { return mData - 1; }
    constexpr const_reverse_iterator crbegin() const FL_NOEXCEPT { return mData + mSize - 1; }
    constexpr const_reverse_iterator crend() const FL_NOEXCEPT { return mData - 1; }