运行期构造、长期保留的 NUL 结尾字符串视图。 Runtime-built retained NUL-terminated string view. More...

#include <libxr_string.hpp>

Public Member Functions
constexpr	RuntimeStringView ()=default
	构造一个空的有效视图 / Constructs an empty valid view.

	RuntimeStringView (const RuntimeStringView &)=delete

RuntimeStringView &	operator= (const RuntimeStringView &)=delete

	RuntimeStringView (RuntimeStringView &&other) noexcept
	移动构造并接管保留存储句柄 / Move-constructs by taking the retained storage handle.

RuntimeStringView &	operator= (RuntimeStringView &&)=delete

	RuntimeStringView (std::string_view text)
	拷贝文本到保留存储 / Copies text into retained storage.

template<size_t N> requires (Source.Size() == 0 && sizeof...(Args) == 0)
	RuntimeStringView (char(&text)[N])
	按文本语义拷贝一个有界可变字符数组 / Copies one bounded mutable char array as text.

template<size_t N> requires (Source.Size() == 0 && sizeof...(Args) == 0)
	RuntimeStringView (const char(&text)[N])
	按文本语义拷贝一个有界只读字符数组 / Copies one bounded const char array as text.

template<typename CharPtr > requires (Source.Size() == 0 && sizeof...(Args) == 0 && (std::is_same_v<CharPtr, char> \|\| std::is_same_v<CharPtr, const char>))
	RuntimeStringView (CharPtr text)

	RuntimeStringView (std::nullptr_t text)

template<typename First , typename Second , typename... Rest> requires (Source.Size() == 0 && sizeof...(Args) == 0)
	RuntimeStringView (First &&first, Second &&second, Rest &&... rest)
	拼接多个文本片段到保留存储 / Concatenates text parts into retained storage.

template<typename... CallArgs> requires ((Source.Size() != 0 \|\| sizeof...(Args) != 0) && Detail::RuntimeStringArgumentTypes<Args...>::template matches<CallArgs...>)
ErrorCode	Reformat (CallArgs &&... args)
	使用绑定的 brace-style 格式重写当前内容。 Rewrite current content with the bound brace-style format.

template<typename... CallArgs> requires ((Source.Size() != 0 \|\| sizeof...(Args) != 0) && Detail::RuntimeStringArgumentTypes<Args...>::template matches<CallArgs...>)
ErrorCode	Reprintf (CallArgs &&... args)
	使用绑定的 printf-style 格式重写当前内容。 Rewrite current content with the bound printf-style format.

constexpr std::string_view	View () const
	返回当前只读视图 / Returns the current read-only view.

const char *	CStr () const
	返回 NUL 结尾 C 字符串 / Returns a NUL-terminated C string.

constexpr size_t	Size () const
	返回不含结尾 NUL 的文本长度 / Returns the text size excluding the trailing NUL.

constexpr bool	Empty () const
	返回当前可见文本是否为空 / Returns whether the current visible text is empty.

constexpr ErrorCode	Status () const
	返回最近一次操作状态 / Returns the latest operation status.

constexpr	operator std::string_view () const
	转换为只读字符串视图 / Converts to a read-only string view.

	operator const char * () const
	转换为 NUL 结尾 C 字符串 / Converts to a NUL-terminated C string.

Detailed Description

template<Print::Text Source = "", typename... Args>
class LibXR::RuntimeStringView< Source, Args >

运行期构造、长期保留的 NUL 结尾字符串视图。 Runtime-built retained NUL-terminated string view.

文本构造用于模块名、topic 名、后缀拼接等只构造一次的名字。格式化构造绑定字面量和参数类型，第一次 Reformat() / Reprintf() 前从编译后的格式元数据计算最大容量，之后只复用该容量。对象析构时不释放已分配存储。

Text construction is for retained names such as module names and topic suffixes. Formatted instances bind the literal and argument types, compute maximum capacity from compiled format metadata before the first rewrite, then reuse that capacity. Allocated storage is intentionally not released by the object destructor.

Definition at line 250 of file libxr_string.hpp.

Constructor & Destructor Documentation

◆ RuntimeStringView() [1/7]

template<Print::Text Source = "", typename... Args>

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( RuntimeStringView< Source, Args > && other )

inlinenoexcept

移动构造并接管保留存储句柄 / Move-constructs by taking the retained storage handle.

Definition at line 269 of file libxr_string.hpp.

      : data_(other.data_),
        size_(other.size_),
        capacity_(other.capacity_),
        status_(other.status_)
  {
    other.data_ = nullptr;
    other.size_ = 0;
    other.capacity_ = 0;
    other.status_ = ErrorCode::OK;
  }

◆ RuntimeStringView() [2/7]

template<Print::Text Source = "", typename... Args>

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( std::string_view text )

inlineexplicit

拷贝文本到保留存储 / Copies text into retained storage.

Definition at line 284 of file libxr_string.hpp.

  {
    static_cast<void>(AssignCopy(text));
  }

◆ RuntimeStringView() [3/7]

template<Print::Text Source = "", typename... Args>

template<size_t N>
requires (Source.Size() == 0 && sizeof...(Args) == 0)

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( char(&) text[N] )

inlineexplicit

按文本语义拷贝一个有界可变字符数组 / Copies one bounded mutable char array as text.

Definition at line 292 of file libxr_string.hpp.

  {
    static_cast<void>(AssignCopy(std::string_view(text, BoundedTextLength(text, N))));
  }

◆ RuntimeStringView() [4/7]

template<Print::Text Source = "", typename... Args>

template<size_t N>
requires (Source.Size() == 0 && sizeof...(Args) == 0)

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( const char(&) text[N] )

inlineexplicit

按文本语义拷贝一个有界只读字符数组 / Copies one bounded const char array as text.

Definition at line 300 of file libxr_string.hpp.

  {
    static_cast<void>(AssignCopy(std::string_view(text, BoundedTextLength(text, N))));
  }

◆ RuntimeStringView() [5/7]

template<Print::Text Source = "", typename... Args>

template<typename CharPtr >
requires (Source.Size() == 0 && sizeof...(Args) == 0 && (std::is_same_v<CharPtr, char*> || std::is_same_v<CharPtr, const char*>))

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( CharPtr text )

inlineexplicit

拷贝 NUL 结尾 C 字符串指针到保留存储。 Copies a NUL-terminated C-string pointer into retained storage.

Definition at line 311 of file libxr_string.hpp.

  {
    static_cast<void>(AssignCopy(text));
  }

◆ RuntimeStringView() [6/7]

template<Print::Text Source = "", typename... Args>

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView ( std::nullptr_t text )

inlineexplicit

保留裸 nullptr 入口以维持运行期空指针检查语义。 Preserves the old bare-nullptr entry for runtime null checks.

Definition at line 318 of file libxr_string.hpp.

  {
    static_cast<void>(AssignCopy(static_cast<const char*>(text)));
  }

◆ RuntimeStringView() [7/7]

template<Print::Text Source = "", typename... Args>

template<typename First , typename Second , typename... Rest>
requires (Source.Size() == 0 && sizeof...(Args) == 0)

LibXR::RuntimeStringView< Source, Args >::RuntimeStringView	(	First &&	first,
		Second &&	second,
		Rest &&...	rest )

inlineexplicit

拼接多个文本片段到保留存储 / Concatenates text parts into retained storage.

Definition at line 326 of file libxr_string.hpp.

  {
    static_cast<void>(AssignConcat(std::forward<First>(first),
                                   std::forward<Second>(second),
                                   std::forward<Rest>(rest)...));
  }

Member Function Documentation

◆ CStr()

template<Print::Text Source = "", typename... Args>

const char * LibXR::RuntimeStringView< Source, Args >::CStr ( ) const

inlinenodiscard

返回 NUL 结尾 C 字符串 / Returns a NUL-terminated C string.

Definition at line 389 of file libxr_string.hpp.

389{ return data_ == nullptr ? "" : data_; }

◆ Empty()

template<Print::Text Source = "", typename... Args>

bool LibXR::RuntimeStringView< Source, Args >::Empty ( ) const

inlinenodiscardconstexpr

返回当前可见文本是否为空 / Returns whether the current visible text is empty.

Definition at line 393 of file libxr_string.hpp.

393{ return size_ == 0; }

◆ operator const char *()

template<Print::Text Source = "", typename... Args>

LibXR::RuntimeStringView< Source, Args >::operator const char * ( ) const

inlinenodiscard

转换为 NUL 结尾 C 字符串 / Converts to a NUL-terminated C string.

Definition at line 399 of file libxr_string.hpp.

399{ return CStr(); }

LibXR::RuntimeStringView::CStr

const char * CStr() const

返回 NUL 结尾 C 字符串 / Returns a NUL-terminated C string.

Definition libxr_string.hpp:389

◆ operator std::string_view()

template<Print::Text Source = "", typename... Args>

LibXR::RuntimeStringView< Source, Args >::operator std::string_view ( ) const

inlinenodiscardconstexpr

转换为只读字符串视图 / Converts to a read-only string view.

Definition at line 397 of file libxr_string.hpp.

397{ return View(); }

LibXR::RuntimeStringView::View

constexpr std::string_view View() const

返回当前只读视图 / Returns the current read-only view.

Definition libxr_string.hpp:383

◆ Reformat()

template<Print::Text Source = "", typename... Args>

template<typename... CallArgs>
requires ((Source.Size() != 0 || sizeof...(Args) != 0) && Detail::RuntimeStringArgumentTypes<Args...>::template matches<CallArgs...>)

ErrorCode LibXR::RuntimeStringView< Source, Args >::Reformat ( CallArgs &&... args )

inlinenodiscard

使用绑定的 brace-style 格式重写当前内容。 Rewrite current content with the bound brace-style format.

Definition at line 339 of file libxr_string.hpp.

  {
    static_assert(LibXR::Format<Source>::template Matches<Args...>(),
                  "LibXR::RuntimeStringView format argument types do not match "
                  "the format");
    using Built = typename LibXR::Format<Source>::template Compiled<Args...>;
    static constexpr size_t max_size =
        Detail::RuntimeStringMaxFormattedSize<Built>(Source.Size());
    static_assert(max_size != Detail::runtime_string_unbounded_capacity,
                  "LibXR::RuntimeStringView cannot retain unbounded formatted "
                  "runtime strings");
 
    return AssignFormatted(
        max_size, [&](auto& sink)
        { return Print::FormatTo<Source>(sink, std::forward<CallArgs>(args)...); });
  }

◆ Reprintf()

template<Print::Text Source = "", typename... Args>

template<typename... CallArgs>
requires ((Source.Size() != 0 || sizeof...(Args) != 0) && Detail::RuntimeStringArgumentTypes<Args...>::template matches<CallArgs...>)

ErrorCode LibXR::RuntimeStringView< Source, Args >::Reprintf ( CallArgs &&... args )

inlinenodiscard

使用绑定的 printf-style 格式重写当前内容。 Rewrite current content with the bound printf-style format.

Definition at line 363 of file libxr_string.hpp.

  {
    static_assert(Print::Printf::Matches<Source, Args...>(),
                  "LibXR::RuntimeStringView printf argument types do not match "
                  "the format");
    using Built = Print::Printf::Compiled<Source>;
    static constexpr size_t max_size =
        Detail::RuntimeStringMaxFormattedSize<Built>(Source.Size());
    static_assert(max_size != Detail::runtime_string_unbounded_capacity,
                  "LibXR::RuntimeStringView cannot retain unbounded formatted "
                  "runtime strings");
 
    return AssignFormatted(
        max_size, [&](auto& sink)
        { return Print::PrintfTo<Source>(sink, std::forward<CallArgs>(args)...); });
  }

◆ Size()

template<Print::Text Source = "", typename... Args>

size_t LibXR::RuntimeStringView< Source, Args >::Size ( ) const

inlinenodiscardconstexpr

返回不含结尾 NUL 的文本长度 / Returns the text size excluding the trailing NUL.

Definition at line 391 of file libxr_string.hpp.

391{ return size_; }

◆ Status()

template<Print::Text Source = "", typename... Args>

ErrorCode LibXR::RuntimeStringView< Source, Args >::Status ( ) const

inlinenodiscardconstexpr

返回最近一次操作状态 / Returns the latest operation status.

Definition at line 395 of file libxr_string.hpp.

395{ return status_; }

◆ View()

template<Print::Text Source = "", typename... Args>

std::string_view LibXR::RuntimeStringView< Source, Args >::View ( ) const

inlinenodiscardconstexpr

返回当前只读视图 / Returns the current read-only view.

Definition at line 383 of file libxr_string.hpp.

  {
    return data_ == nullptr ? std::string_view{} : std::string_view(data_, size_);
  }

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

src/core/libxr_string.hpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ RuntimeStringView() [1/7]

◆ RuntimeStringView() [2/7]

◆ RuntimeStringView() [3/7]

◆ RuntimeStringView() [4/7]

◆ RuntimeStringView() [5/7]

◆ RuntimeStringView() [6/7]

◆ RuntimeStringView() [7/7]

Member Function Documentation

◆ CStr()

◆ Empty()

◆ operator const char *()

◆ operator std::string_view()

◆ Reformat()

◆ Reprintf()

◆ Size()

◆ Status()

◆ View()