Catch::StringRef Class Reference

A non-owning string class (similar to the forthcoming std::string_view) Note that, because a StringRef may be a substring of another string, it may not be null terminated. c_str() must return a null terminated string, however, and so the StringRef will internally take ownership (taking a copy), if necessary. In theory this ownership is not externally visible - but it does mean (substring) StringRefs should not be shared between threads.

Public Types
using	size_type = std::size_t

Public Member Functions
	StringRef () noexcept
	StringRef (StringRef const &other) noexcept
	StringRef (StringRef &&other) noexcept
	StringRef (char const *rawChars) noexcept
	StringRef (char const *rawChars, size_type size) noexcept
	StringRef (std::string const &stdString) noexcept
	~StringRef () noexcept
auto	operator= (StringRef const &other) noexcept-> StringRef &
	operator std::string () const
void	swap (StringRef &other) noexcept
auto	operator== (StringRef const &other) const noexcept-> bool
auto	operator!= (StringRef const &other) const noexcept-> bool
auto	operator[] (size_type index) const noexcept-> char
auto	empty () const noexcept-> bool
auto	size () const noexcept-> size_type
auto	numberOfCharacters () const noexcept-> size_type
auto	c_str () const -> char const *
auto	substr (size_type start, size_type size) const noexcept-> StringRef
auto	currentData () const noexcept-> char const *

Private Member Functions
void	takeOwnership ()
auto	isOwned () const noexcept-> bool
auto	isSubstring () const noexcept-> bool

Private Attributes
char const *	m_start
size_type	m_size
char *	m_data

Static Private Attributes
static constexpr char const *const	s_empty

Friends
struct	StringRefTestAccess

Member Typedef Documentation

using Catch::StringRef::size_type = std::size_t

Constructor & Destructor Documentation

Catch::StringRef::StringRef ( )

inlinenoexcept

Catch::StringRef::StringRef ( StringRef const &  other )

inlinenoexcept

Catch::StringRef::StringRef ( StringRef &&  other )

inlinenoexcept

Catch::StringRef::StringRef ( char const *  rawChars )

noexcept

Catch::StringRef::StringRef ( char const *  rawChars, size_type  size  )

inlinenoexcept

Catch::StringRef::StringRef ( std::string const &  stdString )

inlinenoexcept

Catch::StringRef::~StringRef ( )

inlinenoexcept

Member Function Documentation

auto Catch::StringRef::c_str

(

)

const -> char const *

auto Catch::StringRef::currentData ( ) const -> char const *

noexcept

auto Catch::StringRef::empty ( ) const -> bool

inlinenoexcept

auto Catch::StringRef::isOwned ( ) const -> bool

privatenoexcept

auto Catch::StringRef::isSubstring ( ) const -> bool

privatenoexcept

auto Catch::StringRef::numberOfCharacters ( ) const -> size_type

noexcept

Catch::StringRef::operator std::string

(

)

const

auto Catch::StringRef::operator!= ( StringRef const &  other ) const -> bool

noexcept

auto Catch::StringRef::operator= ( StringRef const &  other ) -> StringRef&

inlinenoexcept

References m_start.

auto Catch::StringRef::operator== ( StringRef const &  other ) const -> bool

noexcept

auto Catch::StringRef::operator[] ( size_type  index ) const -> char

noexcept

auto Catch::StringRef::size ( ) const -> size_type

inlinenoexcept

auto Catch::StringRef::substr ( size_type  start, size_type  size  ) const -> StringRef

noexcept

void Catch::StringRef::swap ( StringRef &  other )

noexcept

void Catch::StringRef::takeOwnership ( )

private

Friends And Related Function Documentation

friend struct StringRefTestAccess

friend

Field Documentation

char* Catch::StringRef::m_data

private

size_type Catch::StringRef::m_size

private

char const* Catch::StringRef::m_start

private

Referenced by operator=().

constexpr char const* const Catch::StringRef::s_empty

staticprivate