#include <UT_StringHolder.h>

Inheritance diagram for UT_StringRef:

Classes
class	Holder

struct	NumberedCompare

Public Types
enum	StorageMode { STORE_EXTERNAL, STORE_NEW, STORE_MALLOC, STORE_INLINE }

typedef char	value_type

typedef const char *	const_iterator
	Iterators. More...

Public Member Functions
SYS_FORCE_INLINE	UT_StringRef ()

SYS_FORCE_INLINE	UT_StringRef (const char *str)
	Will make a shallow reference. More...

SYS_FORCE_INLINE	UT_StringRef (const char *data, exint length)

SYS_FORCE_INLINE	UT_StringRef (const UT_StringLit &lit)
	Construct from string literal. More...

SYS_FORCE_INLINE	UT_StringRef (const std::string &str)
	This will make a shallow reference to the contents of the string. More...

	UT_StringRef (const UT_WorkBuffer &str)
	This will make a shallow reference to the contents of the string. More...

SYS_FORCE_INLINE	UT_StringRef (const UT_String &str)
	This will make a shallow reference to the contents of the string. More...

SYS_FORCE_INLINE	UT_StringRef (const UT_StringRef &s) noexcept
	Shares a reference with the source. More...

SYS_FORCE_INLINE	UT_StringRef (UT_StringRef &&s) noexcept
	Move constructor. Steals the working data from the original. More...

SYS_FORCE_INLINE	~UT_StringRef ()

bool	isUnique () const
	Returns true this object is the sole owner of the underlying string. More...

UT_StringRef &	operator= (const UT_StringRef &s)
	Shares a reference with the source. More...

SYS_FORCE_INLINE UT_StringRef &	operator= (UT_StringRef &&s)

bool	operator== (const UT_StringRef &s) const

bool	operator== (const char *s) const

bool	operator== (const UT_String &s) const

bool	operator!= (const UT_StringRef &s) const

bool	operator!= (const char *s) const

bool	operator!= (const UT_String &s) const

int	spaceship (const UT_StringRef &k) const

bool	operator< (const UT_StringRef &k) const

bool	operator<= (const UT_StringRef &k) const

bool	operator> (const UT_StringRef &k) const

bool	operator>= (const UT_StringRef &k) const

int	compare (const UT_StringRef &str, bool ignore_case=false) const

bool	equal (const UT_StringRef &str, bool ignore_case=false) const

SYS_FORCE_INLINE	operator bool () const
	Test whether the string is defined or not. More...

bool	startsWith (const UT_StringView &pfx, bool case_sense=true) const
	Imported from UT_String. More...

bool	endsWith (const UT_StringView &suffix, bool case_sense=true) const

bool	match (const char *pattern, bool case_sensitive=true) const

bool	contains (const char *pattern, bool case_sensitive=true) const

const char *	fcontain (const char *pattern, bool case_sensitive=true) const

const char *	findWord (const char *word) const

bool	multiMatch (const char *pattern, bool case_sensitive, char separator) const

bool	multiMatch (const char pattern, bool case_sensitive=true, const char separators=", ", bool explicitly_excluded=0, int match_index=0, ut_PatternRecord *pattern_record=nullptr) const

bool	multiMatch (const UT_StringMMPattern &pattern, bool explicitly_excluded=0, int match_index=0, ut_PatternRecord *pattern_record=nullptr) const

bool	matchRegex (const char *expr) const

int	toInt () const

fpreal	toFloat () const

bool	isFloat (bool skip_spaces=false, bool loose=false) const
	Determine if string can be seen as a single floating point number. More...

bool	isInteger (bool skip_spaces=false) const
	Determine if string can be seen as a single integer number. More...

SYS_FORCE_INLINE	operator const char * () const

SYS_FORCE_INLINE const char *	buffer () const

SYS_FORCE_INLINE const char *	nonNullBuffer () const

SYS_FORCE_INLINE const_iterator	begin () const

SYS_FORCE_INLINE const_iterator	end () const

std::string	toStdString () const

SYS_FORCE_INLINE void	swap (UT_StringRef &other)

SYS_FORCE_INLINE bool	isstring () const

bool	isEmpty () const
	Same as !isstring() More...

bool	empty () const
	method name that maches std::string More...

SYS_FORCE_INLINE bool	hasNonSpace () const

SYS_FORCE_INLINE exint	findCharIndex (char c) const
	Find the location of the character (or -1 if not found) More...

SYS_FORCE_INLINE exint	findCharIndex (const char *str) const
	Find the first location of any of the characters in the `str` passed in. More...

SYS_FORCE_INLINE exint	findCharIndex (char c, exint start_offset) const
	Find the location of the character (or -1 if not found) More...

SYS_FORCE_INLINE exint	findCharIndex (const char *str, exint start_offset) const
	Find the first location of any of the characters in the `str` passed in. More...

SYS_FORCE_INLINE exint	lastCharIndex (char c, int occurrence_number=1) const

SYS_FORCE_INLINE exint	countChar (char c) const
	Count the number of times the character `c` occurs. More...

SYS_FORCE_INLINE void	clear ()

SYS_FORCE_INLINE const char *	c_str () const

SYS_FORCE_INLINE const char *	data () const

exint	length () const

unsigned	hash () const

void	reference (const char *src)

void	reference (const char *str, exint length)

void	fastReferenceWithStrlen (const char *src, exint length)
	old name of method: More...

int64	getMemoryUsage (bool inclusive) const

SYS_NO_DISCARD_RESULT UT_StringRef	forceValidVariableName (const char *safechars=nullptr) const

SYS_NO_DISCARD_RESULT UT_StringRef	toLower () const

SYS_NO_DISCARD_RESULT UT_StringRef	toUpper () const

void	harden (const char *src)

void	adoptFromMalloc (const char *str, exint length)

void	adoptFromNew (const char *str, exint length)

void	adoptFromString (UT_String &str)

void	adoptFromCharArray (UT_Array< char > &data)

char *	stealAsMalloc ()

void	saveBinary (std::ostream &os) const
	Save string to binary stream. More...

void	saveAscii (std::ostream &os) const

Static Public Member Functions
static SYS_FORCE_INLINE unsigned	hashString (const char *str, exint len)

static SYS_FORCE_INLINE unsigned	hash_string (const char *str, exint len)

static bool	verifyStringLit ()

Friends
class	UT_StringHolder

void	swap (UT_StringRef &a, UT_StringRef &b)
	Friend specialization of std::swap() to use UT_StringRef::swap() More...

UT_API std::ostream &	operator<< (std::ostream &os, const UT_StringRef &d)

UT_API UT_OStream &	operator<< (UT_OStream &os, const UT_StringRef &d)

enum	UT_StringSentinelType { SENTINEL }

SYS_FORCE_INLINE	UT_StringRef (UT_StringSentinelType)

SYS_FORCE_INLINE	UT_StringRef (UT_StringSentinelType, const char *str)
	str==nullptr turns into sentinel, otherwise act like UT_StringRef(str) More...

SYS_FORCE_INLINE bool	isSentinel () const

SYS_FORCE_INLINE void	makeSentinel ()

Detailed Description

A holder for a string, which stores the length and caches the hash value. A UT_StringRef does not necessarily own the string, and it is therefore not safe to e.g. store a UT_StringRef in a container or member variable.

See Also: UT_StringHolder; UTmakeUnsafeRef

Examples:: packedshareddata/GU_PackedSharedData.C, packedsphere/GU_PackedSphere.C, and SOP/SOP_BouncyAgent.C.

Definition at line 223 of file UT_StringHolder.h.

Member Typedef Documentation

typedef const char* UT_StringRef::const_iterator

Iterators.

Definition at line 625 of file UT_StringHolder.h.

typedef char UT_StringRef::value_type

Definition at line 226 of file UT_StringHolder.h.

Member Enumeration Documentation

enum UT_StringRef::StorageMode

Enumerator
STORE_EXTERNAL
STORE_NEW
STORE_MALLOC
STORE_INLINE

Definition at line 228 of file UT_StringHolder.h.

enum UT_StringRef::UT_StringSentinelType

Special sentinel value support

Enumerator
SENTINEL

Definition at line 384 of file UT_StringHolder.h.

Constructor & Destructor Documentation

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( )

inline

Definition at line 305 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( const char * str )

inline

Will make a shallow reference.

Definition at line 314 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef	(	const char *	data,
		exint	length
	)

inline

Will make a shallow reference. This is NOT a string view, the string must actually null terminate

Definition at line 324 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( const UT_StringLit & lit )

inlineexplicit

Construct from string literal.

Definition at line 332 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( const std::string & str )

inline

This will make a shallow reference to the contents of the string.

Definition at line 339 of file UT_StringHolder.h.

UT_StringRef::UT_StringRef ( const UT_WorkBuffer & str )

This will make a shallow reference to the contents of the string.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( const UT_String & str )

inline

This will make a shallow reference to the contents of the string.

Definition at line 349 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( const UT_StringRef & s )

inlinenoexcept

Shares a reference with the source.

Definition at line 356 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( UT_StringRef && s )

inlinenoexcept

Move constructor. Steals the working data from the original.

Definition at line 366 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::~UT_StringRef ( )

inline

Definition at line 377 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef ( UT_StringSentinelType )

inlineexplicit

Special sentinel value support

Definition at line 387 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::UT_StringRef	(	UT_StringSentinelType	,
		const char *	str
	)

inline

str==nullptr turns into sentinel, otherwise act like UT_StringRef(str)

Definition at line 396 of file UT_StringHolder.h.

Member Function Documentation

void UT_StringRef::adoptFromCharArray ( UT_Array< char > & data )

void UT_StringRef::adoptFromMalloc	(	const char *	str,
		exint	length
	)

void UT_StringRef::adoptFromNew	(	const char *	str,
		exint	length
	)

void UT_StringRef::adoptFromString ( UT_String & str )

inline

Definition at line 889 of file UT_StringHolder.h.

SYS_FORCE_INLINE const_iterator UT_StringRef::begin ( void ) const

inline

Definition at line 628 of file UT_StringHolder.h.

SYS_FORCE_INLINE const char* UT_StringRef::buffer ( ) const

inline

Examples:: SOP/SOP_BouncyAgent.C.

Definition at line 612 of file UT_StringHolder.h.

SYS_FORCE_INLINE const char* UT_StringRef::c_str ( void ) const

inline

Examples:: RAY/RAY_DemoFile.C, and VOP/VOP_CustomContext.C.

Definition at line 768 of file UT_StringHolder.h.

SYS_FORCE_INLINE void UT_StringRef::clear ( )

inline

Definition at line 759 of file UT_StringHolder.h.

int UT_StringRef::compare	(	const UT_StringRef &	str,
		bool	ignore_case = `false`
	)		const

inline

Definition at line 526 of file UT_StringHolder.h.

bool UT_StringRef::contains	(	const char *	pattern,
		bool	case_sensitive = `true`
	)		const

inline

Definition at line 552 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::countChar ( char c ) const

inline

Count the number of times the character c occurs.

Definition at line 753 of file UT_StringHolder.h.

SYS_FORCE_INLINE const char* UT_StringRef::data ( ) const

inline

Definition at line 791 of file UT_StringHolder.h.

bool UT_StringRef::empty ( void ) const

inline

method name that maches std::string

Definition at line 662 of file UT_StringHolder.h.

SYS_FORCE_INLINE const_iterator UT_StringRef::end ( void ) const

inline

Definition at line 631 of file UT_StringHolder.h.

bool UT_StringRef::endsWith	(	const UT_StringView &	suffix,
		bool	case_sense = `true`
	)		const

inline

Definition at line 545 of file UT_StringHolder.h.

bool UT_StringRef::equal	(	const UT_StringRef &	str,
		bool	ignore_case = `false`
	)		const

inline

Definition at line 532 of file UT_StringHolder.h.

void UT_StringRef::fastReferenceWithStrlen	(	const char *	src,
		exint	length
	)

inline

old name of method:

Definition at line 827 of file UT_StringHolder.h.

const char* UT_StringRef::fcontain	(	const char *	pattern,
		bool	case_sensitive = `true`
	)		const

inline

Examples:: mocapstream/MocapStreamRokokoHDK.C.

Definition at line 554 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::findCharIndex ( char c ) const

inline

Find the location of the character (or -1 if not found)

Definition at line 679 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::findCharIndex ( const char * str ) const

inline

Find the first location of any of the characters in the str passed in.

Definition at line 689 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::findCharIndex	(	char	c,
		exint	start_offset
	)		const

inline

Find the location of the character (or -1 if not found)

Definition at line 704 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::findCharIndex	(	const char *	str,
		exint	start_offset
	)		const

inline

Find the first location of any of the characters in the str passed in.

Definition at line 720 of file UT_StringHolder.h.

const char* UT_StringRef::findWord ( const char * word ) const

inline

Definition at line 556 of file UT_StringHolder.h.

SYS_NO_DISCARD_RESULT UT_StringRef UT_StringRef::forceValidVariableName ( const char * safechars = nullptr ) const

Convert the string into a valid C style variable name. All non-alpha numerics will be converted to _. If the first letter is a digit, it is prefixed with an _. If the string is already valid, the string itself is returned. Note that this does NOT force the name to be non-zero in length. The safechars parameter is a string containing extra characters that should be considered safe. These characters are not converted to underscores.

int64 UT_StringRef::getMemoryUsage ( bool inclusive ) const

inline

Examples:: SOP/SOP_BouncyAgent.C.

Definition at line 832 of file UT_StringHolder.h.

void UT_StringRef::harden ( const char * src )

inline

Often people reflexively use this from UT_String days so this increases code compataibility.

Definition at line 879 of file UT_StringHolder.h.

unsigned UT_StringRef::hash ( ) const

inline

Definition at line 806 of file UT_StringHolder.h.

static SYS_FORCE_INLINE unsigned UT_StringRef::hash_string	(	const char *	str,
		exint	len
	)

inlinestatic

Definition at line 852 of file UT_StringHolder.h.

static SYS_FORCE_INLINE unsigned UT_StringRef::hashString	(	const char *	str,
		exint	len
	)

inlinestatic

Definition at line 843 of file UT_StringHolder.h.

SYS_FORCE_INLINE bool UT_StringRef::hasNonSpace ( ) const

inline

Definition at line 667 of file UT_StringHolder.h.

bool UT_StringRef::isEmpty ( ) const

inline

Same as !isstring()

Definition at line 658 of file UT_StringHolder.h.

bool UT_StringRef::isFloat	(	bool	skip_spaces = `false`,
		bool	loose = `false`
	)		const

inline

Determine if string can be seen as a single floating point number.

Definition at line 594 of file UT_StringHolder.h.

bool UT_StringRef::isInteger ( bool skip_spaces = false ) const

inline

Determine if string can be seen as a single integer number.

Definition at line 597 of file UT_StringHolder.h.

SYS_FORCE_INLINE bool UT_StringRef::isSentinel ( ) const

inline

Special sentinel value support

Definition at line 406 of file UT_StringHolder.h.

SYS_FORCE_INLINE bool UT_StringRef::isstring ( ) const

inline

Equivalent to (length() != 0) Returns false for isSentinel()

Examples:: RAY/RAY_DemoFile.C, and RAY/RAY_DemoSprite.C.

Definition at line 654 of file UT_StringHolder.h.

bool UT_StringRef::isUnique ( ) const

inline

Returns true this object is the sole owner of the underlying string.

Definition at line 422 of file UT_StringHolder.h.

SYS_FORCE_INLINE exint UT_StringRef::lastCharIndex	(	char	c,
		int	occurrence_number = `1`
	)		const

inline

Definition at line 734 of file UT_StringHolder.h.

exint UT_StringRef::length ( void ) const

inline

Examples:: SIM/GAS_NetVDBSliceExchange.C, and VOP/VOP_CustomContext.C.

Definition at line 796 of file UT_StringHolder.h.

SYS_FORCE_INLINE void UT_StringRef::makeSentinel ( )

inline

Special sentinel value support

Definition at line 412 of file UT_StringHolder.h.

bool UT_StringRef::match	(	const char *	pattern,
		bool	case_sensitive = `true`
	)		const

inline

Definition at line 549 of file UT_StringHolder.h.

bool UT_StringRef::matchRegex ( const char * expr ) const

Returns true if the entire string matches the provided regular expression, false otherwise. See UT_Regex.

bool UT_StringRef::multiMatch	(	const char *	pattern,
		bool	case_sensitive,
		char	separator
	)		const

inline

Definition at line 559 of file UT_StringHolder.h.

bool UT_StringRef::multiMatch	(	const char *	pattern,
		bool	case_sensitive = `true`,
		const char *	separators = `", "`,
		bool *	explicitly_excluded = `0`,
		int *	match_index = `0`,
		ut_PatternRecord *	pattern_record = `nullptr`
	)		const

inline

Definition at line 565 of file UT_StringHolder.h.

bool UT_StringRef::multiMatch	(	const UT_StringMMPattern &	pattern,
		bool *	explicitly_excluded = `0`,
		int *	match_index = `0`,
		ut_PatternRecord *	pattern_record = `nullptr`
	)		const

inline

Definition at line 575 of file UT_StringHolder.h.

SYS_FORCE_INLINE const char* UT_StringRef::nonNullBuffer ( ) const

inline

Definition at line 616 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::operator bool ( ) const

inlineexplicit

Test whether the string is defined or not.

Definition at line 538 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef::operator const char * ( ) const

inline

Definition at line 607 of file UT_StringHolder.h.

bool UT_StringRef::operator!= ( const UT_StringRef & s ) const

inline

Definition at line 491 of file UT_StringHolder.h.

bool UT_StringRef::operator!= ( const char * s ) const

inline

Definition at line 493 of file UT_StringHolder.h.

bool UT_StringRef::operator!= ( const UT_String & s ) const

inline

Definition at line 495 of file UT_StringHolder.h.

bool UT_StringRef::operator< ( const UT_StringRef & k ) const

inline

Definition at line 518 of file UT_StringHolder.h.

bool UT_StringRef::operator<= ( const UT_StringRef & k ) const

inline

Definition at line 520 of file UT_StringHolder.h.

UT_StringRef& UT_StringRef::operator= ( const UT_StringRef & s )

inline

Shares a reference with the source.

Definition at line 428 of file UT_StringHolder.h.

SYS_FORCE_INLINE UT_StringRef& UT_StringRef::operator= ( UT_StringRef && s )

inline

Move the contents of about-to-be-destructed string s to this string.

Definition at line 441 of file UT_StringHolder.h.

bool UT_StringRef::operator== ( const UT_StringRef & s ) const

inline

Definition at line 448 of file UT_StringHolder.h.

bool UT_StringRef::operator== ( const char * s ) const

inline

Definition at line 471 of file UT_StringHolder.h.

bool UT_StringRef::operator== ( const UT_String & s ) const

inline

Definition at line 488 of file UT_StringHolder.h.

bool UT_StringRef::operator> ( const UT_StringRef & k ) const

inline

Definition at line 522 of file UT_StringHolder.h.

bool UT_StringRef::operator>= ( const UT_StringRef & k ) const

inline

Definition at line 524 of file UT_StringHolder.h.

void UT_StringRef::reference ( const char * src )

inline

Make a light weight reference to the source. Caller must make sure src lives for the duration of this object, and any objects value copied from this!

Definition at line 816 of file UT_StringHolder.h.

void UT_StringRef::reference	(	const char *	str,
		exint	length
	)

Fast reference that takes the length of the string. This is NOT a string view, the string must actually null terminate at the given length or later functions will be confused.

void UT_StringRef::saveAscii ( std::ostream & os ) const

inline

Save string to ASCII stream. This will add double quotes and escape to the stream if necessary (empty string or contains spaces).

Definition at line 936 of file UT_StringHolder.h.

void UT_StringRef::saveBinary ( std::ostream & os ) const

inline

Save string to binary stream.

Definition at line 931 of file UT_StringHolder.h.

int UT_StringRef::spaceship ( const UT_StringRef & k ) const

inline

Spaceship comparison returns:

< 0 if *this < k
== 0 if *this == k
> 0 if *this > k

Definition at line 502 of file UT_StringHolder.h.

bool UT_StringRef::startsWith	(	const UT_StringView &	pfx,
		bool	case_sense = `true`
	)		const

inline

Imported from UT_String.

Definition at line 541 of file UT_StringHolder.h.

char* UT_StringRef::stealAsMalloc ( )

SYS_FORCE_INLINE void UT_StringRef::swap ( UT_StringRef & other )

inline

Definition at line 641 of file UT_StringHolder.h.

fpreal UT_StringRef::toFloat ( ) const

inline

Definition at line 590 of file UT_StringHolder.h.

int UT_StringRef::toInt ( ) const

inline

Definition at line 588 of file UT_StringHolder.h.

SYS_NO_DISCARD_RESULT UT_StringRef UT_StringRef::toLower ( ) const

Convert to lower case. If the string is already lower case, the string itself is returned.

std::string UT_StringRef::toStdString ( ) const

inline

Converts the contents of this UT_String to a std::string. Since we are never null this is easy

Definition at line 637 of file UT_StringHolder.h.

SYS_NO_DISCARD_RESULT UT_StringRef UT_StringRef::toUpper ( ) const

Convert to upper case. If the string is already upper case, the string itsef is returned.

static bool UT_StringRef::verifyStringLit ( )

static

Friends And Related Function Documentation

UT_API std::ostream& operator<<	(	std::ostream &	os,
		const UT_StringRef &	d
	)

friend

This operator saves the string to the stream via the string's saveAscii() method, protecting any whitespace (by adding quotes), backslashes or quotes in the string.

UT_API UT_OStream& operator<<	(	UT_OStream &	os,
		const UT_StringRef &	d
	)

friend

void swap	(	UT_StringRef &	a,
		UT_StringRef &	b
	)

friend

Friend specialization of std::swap() to use UT_StringRef::swap()

Definition at line 649 of file UT_StringHolder.h.

friend class UT_StringHolder

friend

Definition at line 993 of file UT_StringHolder.h.

Member Data Documentation

const void* UT_StringRef::myData

Definition at line 977 of file UT_StringHolder.h.

const char* UT_StringRef::myDataIfChars

Definition at line 978 of file UT_StringHolder.h.

Holder* UT_StringRef::myDataIfHolder

Definition at line 979 of file UT_StringHolder.h.

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

UT/UT_StringHolder.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation