#include <str.h>

Inheritance diagram for Common::String:

Public Types
typedef unsigned char	unsigned_type

Public Types inherited from Common::BaseString< char >
typedef char	value_type

typedef char *	iterator

typedef const char *	const_iterator

Public Member Functions
constexpr	String ()

	String (const char *str)

	String (const char *str, uint32 len)

	String (const char beginP, const char endP)

	String (const String &str)

	String (String &&str)

	String (char c)

	String (const U32String &str, CodePage page=kUtf8)

String &	operator= (const char *str)

String &	operator= (const String &str)

String &	operator= (String &&str)

String &	operator= (char c)

String &	operator+= (const char *str)

String &	operator+= (const String &str)

String &	operator+= (char c)

bool	equalsIgnoreCase (const String &x) const

int	compareToIgnoreCase (const String &x) const

bool	equalsIgnoreCase (const char *x) const

int	compareToIgnoreCase (const char *x) const

int	compareDictionary (const String &x) const

int	compareDictionary (const char *x) const

bool	hasSuffix (const String &x) const

bool	hasSuffix (const char *x) const

bool	hasSuffixIgnoreCase (const String &x) const

bool	hasSuffixIgnoreCase (const char *x) const

bool	hasPrefix (const String &x) const

bool	hasPrefix (const char *x) const

bool	hasPrefixIgnoreCase (const String &x) const

bool	hasPrefixIgnoreCase (const char *x) const

bool	contains (const String &x) const

bool	contains (const char *x) const

bool	matchString (const char pat, bool ignoreCase=false, const char wildcardExclusions=NULL) const

bool	matchString (const String &pat, bool ignoreCase=false, const char *wildcardExclusions=NULL) const

String	substr (size_t pos=0, size_t len=npos) const

String	forEachLine (String(*func)(const String, va_list args),...) const

U32String	decode (CodePage page=kUtf8) const

Public Member Functions inherited from Common::BaseString< char >
constexpr	BaseString ()

	BaseString (const BaseString &str)

	BaseString (BaseString &&str)

	BaseString (const value_type *str)

	BaseString (const value_type *str, uint32 len)

	BaseString (const value_type beginP, const value_type endP)

bool	operator== (const BaseString &x) const

bool	operator== (const value_type *x) const

bool	operator!= (const BaseString &x) const

bool	operator!= (const value_type *x) const

bool	operator< (const BaseString &x) const

bool	operator< (const value_type *x) const

bool	operator<= (const BaseString &x) const

bool	operator<= (const value_type *x) const

bool	operator> (const BaseString &x) const

bool	operator> (const value_type *x) const

bool	operator>= (const BaseString &x) const

bool	operator>= (const value_type *x) const

bool	equals (const BaseString &x) const

bool	equals (const value_type *x) const

bool	equalsC (const char *x) const

int	compareTo (const BaseString &x) const

int	compareTo (const value_type *x) const

int	compareToC (const char *x) const

void	setChar (value_type c, uint32 p)

void	deleteChar (uint32 p)

void	deleteLastChar ()

void	erase (uint32 p, uint32 len=npos)

iterator	erase (iterator it)

void	chop (uint32 len=1)

void	clear ()

iterator	begin ()

const_iterator	begin () const

iterator	end ()

const_iterator	end () const

const value_type *	c_str () const

uint	size () const

bool	empty () const

value_type	firstChar () const

value_type	lastChar () const

value_type	operator[] (int idx) const

bool	contains (const BaseString &otherString) const

bool	contains (value_type x) const

void	insertChar (value_type c, uint32 p)

void	insertString (const value_type *s, uint32 p)

void	insertString (const BaseString &s, uint32 p)

uint32	find (value_type x, uint32 pos=0) const

size_t	find (const value_type *s, uint32 pos=0) const

uint32	find (const BaseString &str, uint32 pos=0) const

size_t	rfind (const value_type *s) const

size_t	rfind (const BaseString &s) const

size_t	rfind (value_type c, size_t pos=npos) const

size_t	findFirstOf (value_type c, size_t pos=0) const

size_t	findFirstOf (const value_type *chars, size_t pos=0) const

size_t	findFirstOf (const BaseString &chars, size_t pos=0) const

size_t	findLastOf (value_type c, size_t pos=npos) const

size_t	findLastOf (const value_type *chars, size_t pos=npos) const

size_t	findLastOf (const BaseString &chars, size_t pos=npos) const

size_t	findFirstNotOf (value_type c, size_t pos=0) const

size_t	findFirstNotOf (const value_type *chars, size_t pos=0) const

size_t	findFirstNotOf (const BaseString &chars, size_t pos=0) const

size_t	findLastNotOf (value_type c) const

size_t	findLastNotOf (const value_type *chars) const

size_t	findLastNotOf (const BaseString &chars) const

void	replace (value_type from, value_type to)

void	append (const value_type begin, const value_type end)

void	wordWrap (const uint32 maxLength)

uint64	asUint64 () const

uint64	asUint64Ext () const

void	toLowercase ()

void	toUppercase ()

void	trim ()

uint	hash () const

void	replace (uint32 pos, uint32 count, const BaseString &str)

void	replace (uint32 pos, uint32 count, const value_type *str)

void	replace (iterator begin, iterator end, const BaseString &str)

void	replace (iterator begin, iterator end, const value_type *str)

void	replace (uint32 posOri, uint32 countOri, const BaseString &str, uint32 posDest, uint32 countDest)

void	replace (uint32 posOri, uint32 countOri, const value_type *str, uint32 posDest, uint32 countDest)

Static Public Member Functions
static String	format (MSVC_PRINTF const char *fmt,...) GCC_PRINTF(1

static String static String	vformat (const char *fmt, va_list args)

Static Public Member Functions inherited from Common::BaseString< char >
static void	releaseMemoryPoolMutex ()

Protected Member Functions
StringEncodingResult	encodeUTF8 (const U32String &src, char errorChar)

StringEncodingResult	encodeWindows932 (const U32String &src, char errorChar)

StringEncodingResult	encodeWindows936 (const U32String &src, char errorChar)

StringEncodingResult	encodeWindows949 (const U32String &src, char errorChar)

StringEncodingResult	encodeWindows950 (const U32String &src, bool translit, char errorChar)

StringEncodingResult	encodeJohab (const U32String &src, char errorChar)

StringEncodingResult	encodeOneByte (const U32String &src, CodePage page, bool translit, char errorChar)

StringEncodingResult	encodeInternal (const U32String &src, CodePage page, char errorChar)

StringEncodingResult	translitChar (U32String::value_type point, char errorChar)

Protected Member Functions inherited from Common::BaseString< char >
bool	isStorageIntern () const

void	makeUnique ()

void	ensureCapacity (uint32 new_size, bool keep_old)

void	incRefCount () const

void	decRefCount (int *oldRefCount)

void	initWithValueTypeStr (const value_type *str, uint32 len)

void	assignInsert (const value_type *str, uint32 p)

void	assignInsert (value_type c, uint32 p)

void	assignInsert (const BaseString &str, uint32 p)

void	assignAppend (const value_type *str)

void	assignAppend (value_type c)

void	assignAppend (const BaseString &str)

void	assign (const BaseString &str)

void	assign (BaseString &&str)

void	assign (value_type c)

void	assign (const value_type *str)

bool	pointerInOwnBuffer (const value_type *str) const

uint	getUnsignedValue (uint pos) const

void	toCase (int(*caseChangeFunc)(int))

Additional Inherited Members
Public Attributes inherited from Common::BaseString< char >
value_type	_storage [_builtinCapacity]

int *	_refCount

uint32	_capacity

struct {
int * _refCount

uint32 _capacity

}	_extern

Static Public Attributes inherited from Common::BaseString< char >
static const uint32	npos

Static Protected Member Functions inherited from Common::BaseString< char >
static uint32	cStrLen (const value_type *str)

static const value_type *	cMemChr (const value_type *ptr, value_type c, size_t count)

static value_type *	cMemChr (value_type *ptr, value_type c, size_t count)

static int	cMemCmp (const value_type ptr1, const value_type ptr2, size_t count)

Protected Attributes inherited from Common::BaseString< char >
uint32	_size

value_type *	_str

union {
value_type _storage [_builtinCapacity]

struct {
int * _refCount

uint32 _capacity

} _extern

};

Static Protected Attributes inherited from Common::BaseString< char >
static const uint32	_builtinCapacity

Detailed Description

Simple string class for ScummVM. Provides automatic storage managment, and overloads several operators in a 'natural' fashion, mimicking the std::string class. Even provides simple iterators.

This class tries to avoid allocating lots of small blocks on the heap, since that is inefficient on several platforms supported by ScummVM. Instead, small strings are stored 'inside' the string object (i.e. on the stack, for stack allocated objects), and only for strings exceeding a certain length do we allocate a buffer on the heap.

The presence of \0 characters in the string will cause undefined behavior in some operations.

Member Typedef Documentation

◆ unsigned_type

typedef unsigned char Common::String::unsigned_type

Unsigned version of the underlying type. This can be used to cast individual string characters to bigger integer types without sign extension happening.

Constructor & Destructor Documentation

◆ String() [1/8]

constexpr Common::String::String ( )

inline

Construct a new empty string.

◆ String() [2/8]

Common::String::String ( const char * str )

inline

Construct a new string from the given NULL-terminated C string.

◆ String() [3/8]

Common::String::String	(	const char *	str,
		uint32	len
	)

inline

Construct a new string containing exactly len characters read from address str.

◆ String() [4/8]

Common::String::String	(	const char *	beginP,
		const char *	endP
	)

inline

Construct a new string containing the characters between beginP (including) and endP (excluding).

◆ String() [5/8]

Common::String::String ( const String & str )

inline

Construct a copy of the given string.

◆ String() [6/8]

Common::String::String ( String && str )

inline

Construct a string by moving an existing string.

◆ String() [7/8]

Common::String::String ( char c )

explicit

Construct a string consisting of the given character.

◆ String() [8/8]

Common::String::String	(	const U32String &	str,
		CodePage	page = `kUtf8`
	)

Construct a new string from the given u32 string.

Member Function Documentation

◆ matchString()

bool Common::String::matchString	(	const char *	pat,
		bool	ignoreCase = `false`,
		const char *	wildcardExclusions = `NULL`
	)		const

Simple DOS-style pattern matching function (understands * and ? like used in DOS). Taken from exult/files/listfiles.cc

Token meaning: "*": any character, any amount of times. "?": any character, only once. "#": any decimal digit, only once. "\#": #, only once.

Example strings/patterns: String: monkey.s01 Pattern: monkey.s?? => true String: monkey.s101 Pattern: monkey.s?? => false String: monkey.s99 Pattern: monkey.s?1 => false String: monkey.s101 Pattern: monkey.s* => true String: monkey.s99 Pattern: monkey.s*1 => false String: monkey.s01 Pattern: monkey.s## => true String: monkey.s01 Pattern: monkey.### => false

Parameters

pat	Glob pattern.
ignoreCase	Whether to ignore the case when doing pattern match
wildcardExclusions	Characters which are excluded from wildcards and must be matched explicitly.

Returns: true if str matches the pattern, false otherwise.

◆ format()

static String Common::String::format	(	MSVC_PRINTF const char *	fmt,
			...
	)

static

Print formatted data into a String object. Similar to sprintf, except that it stores the result in (variably sized) String instead of a fixed size buffer.

◆ vformat()

static String static String Common::String::vformat	(	const char *	fmt,
		va_list	args
	)

static

Print formatted data into a String object. Similar to vsprintf, except that it stores the result in (variably sized) String instead of a fixed size buffer.

◆ substr()

String Common::String::substr	(	size_t	pos = `0`,
		size_t	len = `npos`
	)		const

Return a substring of this string

◆ forEachLine()

String Common::String::forEachLine	(	String(*)(const String, va_list args)	func,
			...
	)		const

Calls func on each line of the string, and returns a joined string

◆ decode()

U32String Common::String::decode ( CodePage page = kUtf8 ) const

Python-like method

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

common/str.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ unsigned_type

Constructor & Destructor Documentation

◆ String() [1/8]

◆ String() [2/8]

◆ String() [3/8]

◆ String() [4/8]

◆ String() [5/8]

◆ String() [6/8]

◆ String() [7/8]

◆ String() [8/8]

Member Function Documentation

◆ matchString()

◆ format()

◆ vformat()

◆ substr()

◆ forEachLine()

◆ decode()