Class asset_ref

src/fl/asset/asset.h:84–117

Opaque handle to a sketch-local asset. Value type: cheap to copy (a single pointer + size). Created via the `FL_ASSET()` macro or `fl::asset(const char*)` below. The `FL_ASSET()` macro performs an `FL_STATIC_ASSERT` that the path contains no `..` segments.

/// `FL_ASSET()` macro or `fl::asset(const char*)` below. The `FL_ASSET()`
/// macro performs an `FL_STATIC_ASSERT` that the path contains no `..` segments.
class asset_ref {
  public:
    /// Construct from a pointer to a null-terminated string with known length.
    /// The pointer MUST outlive the `asset_ref` — typically a string literal.
    constexpr asset_ref(const char* path, fl::size length) FL_NOEXCEPT
        : mPath(path), mLength(length) {}

    /// Default-constructed handle refers to no asset.
    constexpr asset_ref() FL_NOEXCEPT : mPath(nullptr), mLength(0) {}

    /// Copy/move: trivial — pointer + length. Can't combine `constexpr` with
    /// `= default` on the assignment operator pre-C++14, so we leave these as
    /// the implicitly-declared operations (the class is trivially copyable).
    asset_ref(const asset_ref&) FL_NOEXCEPT = default;
    asset_ref& operator=(const asset_ref&) FL_NOEXCEPT = default;

    /// True if this handle refers to an asset path.
    constexpr explicit operator bool() const FL_NOEXCEPT {
        return mPath != nullptr && mLength > 0;
    }

    /// The relative asset path as a string view (e.g. "data/track.mp3").
    fl::string_view path() const FL_NOEXCEPT {
        return fl::string_view(mPath, mLength);
    }

    /// Pointer accessor — useful for JSON serialization.
    constexpr const char* c_str() const FL_NOEXCEPT { return mPath; }
    constexpr fl::size size() const FL_NOEXCEPT { return mLength; }

  private:
    const char* mPath;
    fl::size mLength;
};

/// Construct an asset handle from a relative sketch path at runtime.
///