roland/xo-object2
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

xo-object2: + DString::assign

Browse source
This commit is contained in:
Roland Conybeare 2026-01-13 17:07:03 -05:00
commit d3ba2900d6
3 changed files with 108 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

63
include/xo/object2/DString.hpp
View file

@ -7,6 +7,7 @@
#include <xo/alloc2/Allocator.hpp>
#include <xo/facet/obj.hpp>
#include <string_view>
#include <cstdint>
namespace xo {
@ -27,6 +28,9 @@ namespace xo {
using size_type = std::uint32_t;
using AAllocator = xo::mm::AAllocator;
/** @defgroup dstring-ctors constructors **/
///@{
/** create empty string with space for @cap chars
* (including null terminator).
* Use memory from allocator @p mm
@ -40,10 +44,69 @@ namespace xo {
static DString * from_cstr(obj<AAllocator> mm,
const char * cstr);
///@}
/** @defgroup dstring-access access methods **/
///@{
size_type capacity() const noexcept { return capacity_; }
size_type size() const noexcept { return size_; }
const char * chars() const noexcept { return chars_; }
///@}
/** @defgroup dstring-iterators iterators **/
///@{
///@}
/** @defgroup dstring-assign assignment **/
///@{
/** put string into empty state **/
void clear() noexcept { size_ = 0; chars_[0] = '\0'; }
/** replace contents with @p other, or prefix of up to @p capacity - 1 chars **/
DString & assign(const DString & other);
// TODO - behave like std::string, to the extent feasible
// insert
// insert_range
// erase
// push_back
// append
// append_range
// operator+=
// replace
// replace_with_range
// copy
// find
// rfind
// find_first_of
// find_first_not_of
// find_last_of
// find_last_not_of
// compare
// starts_with
// end_with
// contains
// substr
///@}
/** @defgroup dstring-conversion-operators conversion operators **/
///@{
operator std::string_view() const noexcept { return std::string_view(chars_); }
/** @brief conversion oeprator to C-style string.
*
* Example
* @code
* DString s = ...;
* ::strcmp(s, "obey...");
* @endcode
**/
operator const char * () const noexcept { return &(chars_[0]); }
///@}
private:
/** extent of @ref chars_ array **/
size_type capacity_ = 0;