Burger::String32 Class Reference

UTF 32 bit string class. More...

Public Member Functions
	String32 (void) noexcept
	Creates an empty string.
	String32 (const String32 &rInput)
	Initialize a Burger::String32 with a Burger::String32.
	String32 (const String32 &rInput, uintptr_t uStart, uintptr_t uEnd=UINTPTR_MAX)
	Initialize a Burger::String32 by using a subsection of a different Burger::String32.
	String32 (const char *pInput) noexcept
	Initialize with a UTF8 "C" string.
	String32 (const char *pInput, uintptr_t uPadding)
	Initialize with a UTF8 "C" string with padding.
	String32 (const uint16_t *pInput)
	String32 (const uint32_t *pInput)
	Initialize with a UTF32 string.
	~String32 ()
	Release memory, if any.
	operator uint32_t * () noexcept
	Return the pointer to the string.
	operator const uint32_t * () const noexcept
	Return the const pointer to the string.
const uint32_t *	c_str () const noexcept
	Return the const pointer to the string.
uint32_t *	c_str () noexcept
	Return the pointer to the string.
const uint32_t *	data (void) const noexcept
uint32_t *	data (void) noexcept
	operator uint32_t () const noexcept
	Return the first character of the UTF32 "C" string.
uintptr_t	length (void) const noexcept
	Return the length of the "C" string.
uint_t	empty (void) const noexcept
uintptr_t	GetLength (void) const noexcept
	Return the length of the UTF32 "C" string.
uint32_t *	GetPtr () noexcept
	Return the pointer to the string.
const uint32_t *	GetPtr () const noexcept
	Return the const pointer to the string.
eError	assign (const char *pInput) noexcept
	Copy an 8 bit "C" string to a Burger::String32.
eError	assign (const uint32_t *pInput) noexcept
	Copy a "C" string to a Burger::String.
eError	SetBufferSize (uintptr_t uSize) noexcept
	Force a buffer size.
eError	resize (uintptr_t uSize) noexcept
String32 &	operator= (const String32 &rInput)
	Assign a Burger::String32.
String32 &	operator= (const uint32_t *pInput)
	Assign a "C" string to a Burger::String32.
String32 &	operator= (const char *pInput)
	Assign a "C" string to a Burger::String32.
String32 &	operator= (char cInput)
	Assign a single character length string to this Burger::String.
String32	operator() (uintptr_t uStart, uintptr_t uEnd) const noexcept
	Create a new Burger::String32 from a substring.
uint32_t &	operator() (uintptr_t uInput) noexcept
	Return the reference to a location in the string.
uint32_t const &	operator() (uintptr_t uInput) const noexcept
	Return the reference to a location in the string.
uint32_t &	operator[] (uintptr_t uInput) noexcept
	Return the reference to a location in the string.
uint32_t const &	operator[] (uintptr_t uInput) const noexcept
	Return the reference to a location in the string.
uint_t	operator! () const noexcept
	Return TRUE if the string is empty.
uint_t	is_valid (void) const noexcept
	Return TRUE if the string has characters.
void	clear (void) noexcept
	Clear out the data.

Static Public Attributes
static const uintptr_t	BUFFERSIZE
	Ensures the structure is 128 bytes in size on all platforms.

Private Attributes
uint32_t *	m_pData
	Pointer to the string.
uintptr_t	m_uLength
	Length of the string.
uint32_t	m_Raw [BUFFERSIZE]
	Temp preallocated buffer for most strings Structure size is 128 bytes.

Detailed Description

UTF 32 bit string class.

---

This commonly used string class was designed for performance in mind. Each instance takes 128 bytes to contain data for the string and a pointer to allocated memory if the internal string buffer is too large. Since most strings rarely exceed 120 bytes in length, this class will be able to allocate and free strings with no calls to a memory manager. Only when the string exceeds the internal buffer will Burger::allocate_memory() and Burger::free_memory() be used.

Functions exist to convert UTF8 and UTF16 data into UTF32 format, which this string class uses internally for data storage.

See also

Burger::String

Constructor & Destructor Documentation

String32() [1/7]

Burger::String32::String32 ( void )

inlinenoexcept

Creates an empty string.

---

String32() [2/7]

Burger::String32::String32

(

const String32 &

rInput

)

Initialize a Burger::String32 with a Burger::String32.

---

Parameters

rInput

Reference to a Burger::String32

String32() [3/7]

Burger::String32::String32	(	const String32 &	rInput,
		uintptr_t	uStart,
		uintptr_t	uEnd = UINTPTR_MAX )

Initialize a Burger::String32 by using a subsection of a different Burger::String32.

---

Given a starting (inclusive) and ending (exclusive) offset, grab the sub string and use it to create a new Burger::String32

Note

If uEnd is less than or equal to uStart, the resulting string will be empty.

Parameters

rInput	Burger::String32 to receive input from
uStart	Offset to the first character to read from
uEnd	Offset beyond the last character to read from

String32() [4/7]

Burger::String32::String32 ( const char * pInput )

noexcept

Initialize with a UTF8 "C" string.

---

Initialize the Burger::String32 with a copy of the passed string. The original string can be discarded after the call returns.

Note

This function will perform a conversion from UTF8 to UTF32

Parameters

pInput

Pointer to a valid UTF8 "C" string or NULL to create an empty string

String32() [5/7]

Burger::String32::String32	(	const char *	pInput,
		uintptr_t	uPadding )

Initialize with a UTF8 "C" string with padding.

---

Initialize the Burger::String32 with a copy of the passed string. The original string can be discarded after the call returns. Allocate a buffer that can hold the initialization string + the uPadding number of bytes so the programmer can manually append data to the end of the string with Burger::string_copy() or equivalent

Parameters

pInput	Pointer to a valid UTF8 "C" string or NULL to create an empty string
uPadding	Number of bytes to extend the string buffer. The extra bytes are NOT initialized

String32() [6/7]

Burger::String32::String32

(

const uint16_t *

pInput

)

String32() [7/7]

Burger::String32::String32

(

const uint32_t *

pInput

)

Initialize with a UTF32 string.

---

Copy the UTF32 encoded input string and initialize this class with it. The input string can be discarded after this call.

Parameters

pInput

A pointer to a valid UTF32 "C" string

~String32()

Burger::String32::~String32 ( )

inline

Release memory, if any.

---

Releases any allocated memory for the string. Under most cases, this performs no operation.

Member Function Documentation

assign() [1/2]

Burger::eError BURGER_API Burger::String32::assign ( const char * pInput )

noexcept

Copy an 8 bit "C" string to a Burger::String32.

---

Parameters

pInput

Pointer to a UTF16 "C" string. NULL generates an empty string.

Returns

Zero if no error, non zero if memory allocation failed

assign() [2/2]

Burger::eError BURGER_API Burger::String32::assign ( const uint32_t * pInput )

noexcept

Copy a "C" string to a Burger::String.

---

Note

This function allows using the tail end of the current string as input

Parameters

pInput

Pointer to a UTF8 "C" string. NULL generates an empty string.

Returns

Zero if no error, non zero if memory allocation failed

c_str() [1/2]

const uint32_t * Burger::String32::c_str ( ) const

inlinenoexcept

Return the const pointer to the string.

---

Helper to access the const pointer to the UTF32 string

Returns

Pointer to the const UTF16 "C" string.

c_str() [2/2]

uint32_t * Burger::String32::c_str ( )

inlinenoexcept

Return the pointer to the string.

---

Helper to access the pointer to the UTF32 string

Returns

Pointer to the UTF32 "C" string.

clear()

void Burger::String32::clear ( void )

noexcept

Clear out the data.

---

Set the string to an empty string

data() [1/2]

const uint32_t * Burger::String32::data ( void ) const

inlinenoexcept

data() [2/2]

uint32_t * Burger::String32::data ( void )

inlinenoexcept

empty()

uint_t Burger::String32::empty ( void ) const

inlinenoexcept

GetLength()

uintptr_t Burger::String32::GetLength ( void ) const

inlinenoexcept

Return the length of the UTF32 "C" string.

---

Returns

The length in shorts of the UTF32 "C" string

GetPtr() [1/2]

const uint32_t * Burger::String32::GetPtr ( ) const

inlinenoexcept

Return the const pointer to the string.

---

Helper to access the const pointer to the UTF32 string

Returns

Pointer to the const UTF32 "C" string.

GetPtr() [2/2]

uint32_t * Burger::String32::GetPtr ( )

inlinenoexcept

Return the pointer to the string.

---

Helper to access the pointer to the UTF32 string

Returns

Pointer to the UTF32 "C" string.

is_valid()

uint_t Burger::String32::is_valid ( void ) const

inlinenoexcept

Return TRUE if the string has characters.

---

Returns

FALSE on an empty string, TRUE if there are characters in the string

length()

uintptr_t Burger::String32::length ( void ) const

inlinenoexcept

Return the length of the "C" string.

---

Returns

The length in longs of the UTF32 "C" string

operator const uint32_t *()

Burger::String32::operator const uint32_t * ( ) const

inlinenoexcept

Return the const pointer to the string.

---

Helper to access the const pointer to the UTF32 string

Returns

Pointer to the const UTF32 "C" string.

operator uint32_t()

Burger::String32::operator uint32_t ( ) const

inlinenoexcept

Return the first character of the UTF32 "C" string.

---

Helper to access the first character of the UTF32 "C" string. It can be zero.

Returns

The first character of the UTF32 "C" string

operator uint32_t *()

Burger::String32::operator uint32_t * ( )

inlinenoexcept

Return the pointer to the string.

---

Helper to access the pointer to the UTF32 string

Returns

Pointer to the UTF32 "C" string.

operator!()

uint_t Burger::String32::operator! ( ) const

inlinenoexcept

Return TRUE if the string is empty.

---

Returns

TRUE on an empty string, FALSE if there are characters in the string

operator()() [1/3]

uint32_t const & Burger::String32::operator() ( uintptr_t uInput ) const

inlinenoexcept

Return the reference to a location in the string.

---

Given an offset into the string, return the reference to the character. If the offset exceeds the length of the string, it will be clamped to the terminating zero.

Parameters

uInput

Offset to the starting character of the new string

Returns

A constant reference to the character in the string.

See also

Burger::String32::operator [] (uintptr_t) const

operator()() [2/3]

uint32_t & Burger::String32::operator() ( uintptr_t uInput )

inlinenoexcept

Return the reference to a location in the string.

---

Given an offset into the string, return the reference to the character. If the offset exceeds the length of the string, it will be clamped to the terminating zero.

Parameters

uInput

Offset to the starting character of the new string

Returns

A reference to the character in the string.

See also

Burger::String32::operator [] (uintptr_t)

operator()() [3/3]

String32 Burger::String32::operator() ( uintptr_t uStart, uintptr_t uEnd ) const

inlinenoexcept

Create a new Burger::String32 from a substring.

---

Given the start and end offsets of a string, create a new string with those offsets and return the resulting string

Parameters

uStart	Offset to the starting character of the new string
uEnd	Offset to the character AFTER the last character of the new string

Returns

A class instance of Burger::String32 containing the new string.

See also

Burger::String32::String32(const Burger::String32 &,uintptr_t,uintptr_t)

operator=() [1/4]

Burger::String32 & Burger::String32::operator=

(

char

cInput

)

Assign a single character length string to this Burger::String.

---

If the input is zero, the string is empty.

Note

Since the default encoding is UFT8, input that's greater than 127 will yield a possibly invalid string due to UTF8 decoding.

Parameters

cInput

Single low ASCII character to create a string.

Returns

A reference to the this pointer

operator=() [2/4]

Burger::String32 & Burger::String32::operator=

(

const char *

pInput

)

Assign a "C" string to a Burger::String32.

---

Copy the contents of a UTF8 "C" string into this Burger::String32

Parameters

pInput

Pointer to a UTF8 "C" string. NULL generates an empty string.

Returns

A reference to the this pointer

operator=() [3/4]

Burger::String32 & Burger::String32::operator=

(

const String32 &

rInput

)

Assign a Burger::String32.

---

Copy the contents of a Burger::String32 into this Burger::String32

Parameters

rInput

Reference to a Burger::String32 to copy from

Returns

A reference to the this pointer

operator=() [4/4]

Burger::String32 & Burger::String32::operator=

(

const uint32_t *

pInput

)

Assign a "C" string to a Burger::String32.

---

Copy the contents of a UTF8 "C" string into this Burger::String32

Parameters

pInput

Pointer to a UTF8 "C" string. NULL generates an empty string.

Returns

A reference to the this pointer

operator[]() [1/2]

uint32_t const & Burger::String32::operator[] ( uintptr_t uInput ) const

inlinenoexcept

Return the reference to a location in the string.

---

Given an offset into the string, return the reference to the character. If the offset exceeds the length of the string, it will be clamped to the terminating zero.

Parameters

uInput

Offset to the starting character of the new string

Returns

A constant reference to the character in the string.

See also

Burger::String32::operator () (uintptr_t) const

operator[]() [2/2]

uint32_t & Burger::String32::operator[] ( uintptr_t uInput )

inlinenoexcept

Return the reference to a location in the string.

---

Given an offset into the string, return the reference to the character. If the offset exceeds the length of the string, it will be clamped to the terminating zero.

Parameters

uInput

Offset to the starting character of the new string

Returns

A reference to the character in the string.

See also

Burger::String32::operator () (uintptr_t)

resize()

eError Burger::String32::resize ( uintptr_t uSize )

inlinenoexcept

SetBufferSize()

Burger::eError BURGER_API Burger::String32::SetBufferSize ( uintptr_t uSize )

noexcept

Force a buffer size.

---

Set the buffer to a specific size while retaining the existing string. If the preexisting string is too long for the new buffer, it will be truncated. The buffer size will be padded to reserve two bytes for the terminating zero.

Note

If a buffer of 100 characters is requested, 202 bytes will be allocated to hold a string up to 100 characters in length with the 101st short being the terminating zero. The output of Burger::string_length( const uint32_t *) is acceptable as input for a new string.

Parameters

uSize

Number of characters to set the buffer to

Member Data Documentation

BUFFERSIZE

const uintptr_t Burger::String32::BUFFERSIZE

static

Initial value:

= static_cast<uintptr_t>(
        (128 - (sizeof(uint32_t*) + sizeof(uintptr_t))) / sizeof(uint32_t))

Ensures the structure is 128 bytes in size on all platforms.

m_pData

uint32_t* Burger::String32::m_pData

private

Pointer to the string.

m_Raw

uint32_t Burger::String32::m_Raw[BUFFERSIZE]

private

Temp preallocated buffer for most strings Structure size is 128 bytes.

m_uLength

uintptr_t Burger::String32::m_uLength

private

Length of the string.