c4::yml::extra::string_vector Struct Reference

a string collection used by the event handler. More...

#include <string.hpp>

Public Types
enum	: id_type { sso_size = RYML_STRING_LIST_SSO_SIZE }

Public Member Functions
	string_vector ()
	~string_vector () noexcept
	string_vector (string_vector const &that) RYML_NOEXCEPT
	string_vector (string_vector &&that) noexcept
string_vector &	operator= (string_vector const &that) RYML_NOEXCEPT
string_vector &	operator= (string_vector &&that) noexcept
void	_free ()
id_type	size () const noexcept
id_type	capacity () const noexcept
void	clear ()
void	resize (id_type sz)
void	reserve (id_type sz)
string &	emplace_back ()
string &	operator[] (id_type i)
string const &	operator[] (id_type i) const

Public Attributes
union {
string   m_buf [sso_size]
char   m_buf_bytes [sso_size *sizeof(string)]
};
string *	m_arr
id_type	m_size
id_type	m_capacity

Detailed Description

a string collection used by the event handler.

using this instead of std::vector spares the dependency on the standard library.

Definition at line 268 of file string.hpp.

Member Enumeration Documentation

anonymous enum

anonymous enum : id_type

Enumerator
sso_size

Definition at line 270 of file string.hpp.

: id_type { sso_size = RYML_STRING_LIST_SSO_SIZE };

Constructor & Destructor Documentation

string_vector() [1/3]

c4::yml::extra::string_vector::string_vector ( )

inline

Definition at line 281 of file string.hpp.

        : m_arr(m_buf)
        , m_size(0)
        , m_capacity(sso_size)
    {}

~string_vector()

c4::yml::extra::string_vector::~string_vector ( )

inlinenoexcept

Definition at line 286 of file string.hpp.

    {
        _free();
    }

References _free().

string_vector() [2/3]

c4::yml::extra::string_vector::string_vector ( string_vector const &  that )

inline

Definition at line 291 of file string.hpp.

                                                           : string_vector()
    {
        reserve(that.m_size);
        m_size = that.m_size;
        for(id_type i = 0; i < that.m_size; ++i)
            new ((void*)(m_arr+i)) string(that.m_arr[i]);
    }

References m_arr, m_size, and reserve().

string_vector() [3/3]

c4::yml::extra::string_vector::string_vector ( string_vector &&  that )

inlinenoexcept

Definition at line 299 of file string.hpp.

                                                 : string_vector()
    {
        reserve(that.m_size);
        m_size = that.m_size;
        for(id_type i = 0; i < that.m_size; ++i)
            new ((void*)(m_arr+i)) string(std::move(that.m_arr[i]));
        that.~string_vector();
    }

References m_arr, m_size, and reserve().

Member Function Documentation

operator=() [1/2]

string_vector& c4::yml::extra::string_vector::operator= ( string_vector const &  that )

inline

Definition at line 308 of file string.hpp.

    {
        _free();
        reserve(that.m_size);
        for(id_type i = 0; i < that.m_size; ++i)
            m_arr[i].operator=(that.m_arr[i]);
        m_size = that.m_size;
        return *this;
    }

References _free(), m_arr, m_size, and reserve().

operator=() [2/2]

string_vector& c4::yml::extra::string_vector::operator= ( string_vector &&  that )

inlinenoexcept

Definition at line 318 of file string.hpp.

    {
        _free();
        reserve(that.m_size);
        for(id_type i = 0; i < that.m_size; ++i)
            m_arr[i].operator=(std::move(that.m_arr[i]));
        m_size = that.m_size;
        that.~string_vector();
        return *this;
    }

References _free(), m_arr, m_size, and reserve().

_free()

void c4::yml::extra::string_vector::_free ( )

inline

Definition at line 329 of file string.hpp.

    {
        _RYML_ASSERT_BASIC(m_arr != nullptr); // this structure cannot be memset() to zero
        for(id_type i = 0; i < m_size; ++i)
            m_arr[i].~string();
        if(m_arr != m_buf)
        {
            _RYML_CB_FREE(get_callbacks(), m_arr, string, (size_t)m_capacity);
            m_arr = m_buf;
            m_capacity = sso_size;
        }
        _RYML_ASSERT_BASIC(m_capacity == sso_size);
        m_size = 0;
    }

References c4::yml::get_callbacks(), m_arr, m_buf, m_capacity, m_size, and sso_size.

size()

id_type c4::yml::extra::string_vector::size ( ) const

inlinenoexcept

Definition at line 346 of file string.hpp.

{ return m_size; }

References m_size.

capacity()

id_type c4::yml::extra::string_vector::capacity ( ) const

inlinenoexcept

Definition at line 347 of file string.hpp.

{ return m_capacity; }

References m_capacity.

clear()

void c4::yml::extra::string_vector::clear ( )

inline

Definition at line 349 of file string.hpp.

    {
        resize(0);
    }

References resize().

resize()

void c4::yml::extra::string_vector::resize ( id_type  sz )

inline

Definition at line 354 of file string.hpp.

    {
        reserve(sz);
        if(sz >= m_size)
        {
            for(id_type i = m_size; i < sz; ++i)
                new ((void*)(m_arr + i)) string();
        }
        else
        {
            for(id_type i = sz; i < m_size; ++i)
                m_arr[i].~string();
        }
        m_size = sz;
    }

References m_arr, m_size, and reserve().

reserve()

void c4::yml::extra::string_vector::reserve ( id_type  sz )

inline

Definition at line 370 of file string.hpp.

    {
        if(sz <= m_capacity)
            return;
        id_type cap = m_capacity < string::sso_size ? string::sso_size : 2 * m_capacity;
        cap = cap > sz ? cap : sz;
        if(cap <= sso_size)
            return;
        Callbacks cb = get_callbacks();
        string *buf = (string*) _RYML_CB_ALLOC(cb, string, cap);
        for(id_type i = 0; i < m_size; ++i)
            new ((void*)(buf + i)) string(std::move(m_arr[i]));
        if(m_arr != m_buf)
        {
            _RYML_CB_FREE(cb, m_arr, string, m_size);
        }
        m_arr = buf;
        m_capacity = cap;
    }

References c4::yml::get_callbacks(), m_arr, m_buf, m_capacity, m_size, c4::yml::extra::string::sso_size, and sso_size.

emplace_back()

string& c4::yml::extra::string_vector::emplace_back ( )

inline

Definition at line 392 of file string.hpp.

    {
        _RYML_ASSERT_BASIC(m_size < m_capacity);
        if(m_size == m_capacity)
            reserve(m_size + 1);
        string& ret = m_arr[m_size++];
        new ((void*)&ret) string();
        return ret;
    }

References m_arr, m_capacity, m_size, and reserve().

operator[]() [1/2]

string& c4::yml::extra::string_vector::operator[] ( id_type  i )

inline

Definition at line 401 of file string.hpp.

    {
        _RYML_ASSERT_BASIC(m_size <= m_capacity);
        _RYML_ASSERT_BASIC(i < m_size);
        return m_arr[i];
    }

References m_arr, m_capacity, and m_size.

operator[]() [2/2]

string const& c4::yml::extra::string_vector::operator[] ( id_type  i ) const

inline

Definition at line 407 of file string.hpp.

    {
        _RYML_ASSERT_BASIC(m_size <= m_capacity);
        _RYML_ASSERT_BASIC(i < m_size);
        return m_arr[i];
    }

References m_arr, m_capacity, and m_size.

Member Data Documentation

m_buf

string c4::yml::extra::string_vector::m_buf[sso_size]

Definition at line 272 of file string.hpp.

m_buf_bytes

char c4::yml::extra::string_vector::m_buf_bytes[sso_size *sizeof(string)]

Definition at line 273 of file string.hpp.

union { ... }

m_arr

string* c4::yml::extra::string_vector::m_arr

Definition at line 275 of file string.hpp.

m_size

id_type c4::yml::extra::string_vector::m_size

Definition at line 276 of file string.hpp.

m_capacity

id_type c4::yml::extra::string_vector::m_capacity

Definition at line 277 of file string.hpp.

---

The documentation for this struct was generated from the following file:

• /home/docs/checkouts/readthedocs.org/user_builds/rapidyaml/checkouts/v0.12.0/src_extra/c4/yml/extra/string.hpp