Class circular_buffer

src/fl/stl/circular_buffer.h:165–325

// Uses vector_inlined internally — inline when N > 0, heap when N == 0.
template <typename T, fl::size N = 0>
class circular_buffer {
  public:
    // Default constructor — pre-sizes to N (useful when N > 0).
    circular_buffer() FL_NOEXCEPT {
        mStorage.resize(N);
        mCore.assign(mStorage.data(), N);
    }

    // PMR-aware constructor.
    explicit circular_buffer(memory_resource* resource)
        : mStorage(resource) {
        mStorage.resize(N);
        mCore.assign(mStorage.data(), N);
    }

    // Capacity constructor — for dynamic (N==0) or overriding static size.
    explicit circular_buffer(fl::size capacity) {
        mStorage.resize(capacity);
        mCore.assign(mStorage.data(), capacity);
    }

    // Capacity constructor with PMR.
    circular_buffer(fl::size capacity, memory_resource* resource)
        : mStorage(resource) {
        mStorage.resize(capacity);
        mCore.assign(mStorage.data(), capacity);
    }

    circular_buffer(const circular_buffer& other) FL_NOEXCEPT
        : mStorage(other.mStorage),
          mCore(mStorage.data(), mStorage.size()) {
        mCore.setHead(other.mCore.head());
        mCore.setTail(other.mCore.tail());
        mCore.setFull(other.mCore.isFull());
    }

    circular_buffer(circular_buffer&& other) FL_NOEXCEPT
        : mStorage(fl::move(other.mStorage)),
          mCore(mStorage.data(), mStorage.size()) {
        mCore.setHead(other.mCore.head());
        mCore.setTail(other.mCore.tail());
        mCore.setFull(other.mCore.isFull());
        other.mCore.assign(nullptr, 0);
    }

    circular_buffer& operator=(const circular_buffer& other) FL_NOEXCEPT {
        if (this != &other) {
            mStorage = other.mStorage;
            mCore.assign(mStorage.data(), mStorage.size());
            mCore.setHead(other.mCore.head());
            mCore.setTail(other.mCore.tail());
            mCore.setFull(other.mCore.isFull());
        }
        return *this;
    }

    circular_buffer& operator=(circular_buffer&& other) FL_NOEXCEPT {
        if (this != &other) {