string.hpp

Go to the documentation of this file.

 
namespace flecs {
 
struct string_view;
 
// This removes dependencies on std::string (and therefore STL) and allows the 
// API to return allocated strings without incurring additional allocations when
// wrapping in an std::string.
struct string {
    explicit string() 
        : str_(nullptr)
        , const_str_("")
        , length_(0) { }
 
    explicit string(char *str) 
        : str_(str)
        , const_str_(str ? str : "")
        , length_(str ? ecs_os_strlen(str) : 0) { }
 
    ~string() {
        // If flecs is included in a binary but is not used, it is possible that
        // the OS API is not initialized. Calling ecs_os_free in that case could
        // crash the application during exit. However, if a string has been set
        // flecs has been used, and OS API should have been initialized.
        if (str_) {
            ecs_os_free(str_);
        }
    }
 
    string(string&& str) noexcept {
        ecs_os_free(str_);
        str_ = str.str_;
        const_str_ = str.const_str_;
        length_ = str.length_;
        str.str_ = nullptr;
    }
 
    operator const char*() const {
        return const_str_;
    }
 
    string& operator=(string&& str) noexcept {
        ecs_os_free(str_);
        str_ = str.str_;
        const_str_ = str.const_str_;
        length_ = str.length_;
        str.str_ = nullptr;
        return *this;
    }
 
    // Ban implicit copies/allocations
    string& operator=(const string& str) = delete;
    string(const string& str) = delete;
 
    bool operator==(const flecs::string& str) const {
        if (str.const_str_ == const_str_) {
            return true;
        }
 
        if (!const_str_ || !str.const_str_) {
            return false;
        }
 
        if (str.length_ != length_) {
            return false;
        }
 
        return ecs_os_strcmp(str, const_str_) == 0;
    }
 
    bool operator!=(const flecs::string& str) const {
        return !(*this == str);
    }    
 
    bool operator==(const char *str) const {
        if (const_str_ == str) {
            return true;
        }
 
        if (!const_str_ || !str) {
            return false;
        }
 
        return ecs_os_strcmp(str, const_str_) == 0;
    }
 
    bool operator!=(const char *str) const {
        return !(*this == str);
    }    
 
    const char* c_str() const {
        return const_str_;
    }
 
    std::size_t length() const {
        return static_cast<std::size_t>(length_);
    }
 
    template <size_t N>
    static constexpr size_t length( char const (&)[N] ) {
        return N - 1;
    }
 
    std::size_t size() const {
        return length();
    }
 
    void clear() {
        ecs_os_free(str_);
        str_ = nullptr;
        const_str_ = nullptr;
    }
 
    bool contains(const char *substr) {
        if (const_str_) {
            return strstr(const_str_, substr) != nullptr;
        } else {
            return false;
        }
    }
 
protected:
    // Must be constructed through string_view. This allows for using the string
    // class for both owned and non-owned strings, which can reduce allocations
    // when code conditionally should store a literal or an owned string.
    // Making this constructor private forces the code to explicitly create a
    // string_view which emphasizes that the string won't be freed by the class.
    string(const char *str)
        : str_(nullptr)
        , const_str_(str ? str : "")
        , length_(str ? ecs_os_strlen(str) : 0) { }
 
    char *str_ = nullptr;
    const char *const_str_;
    ecs_size_t length_;
};
 
// For consistency, the API returns a string_view where it could have returned
// a const char*, so an application won't have to think about whether to call
// c_str() or not. The string_view is a thin wrapper around a string that forces
// the API to indicate explicitly when a string is owned or not.
struct string_view : string {
    explicit string_view(const char *str)
        : string(str) { }
};
 
}