61 String(
const char* cStr,
size_t len);
112 void Append(
const char* str);
163 void __cdecl
Format(
const char* fmtString, ...);
165 void __cdecl
FormatArgList(
const char* fmtString, va_list argList);
238 template<
typename T>
void Set(
const T& t);
261 template<
typename T>
void Append(
const T& t);
266 const char*
Get()
const;
300 template<
typename T> T
As()
const;
372 static constexpr uint Hash(
const char* c, std::size_t s);
375 template<
typename INTEGER>
414 inline size_t length()
const {
return this->Length(); }
416 inline bool empty()
const {
return this->IsEmpty(); }
437 static int StrCmp(
const char* str0,
const char* str1);
439 static int StrICmp(
const char* str0,
const char* str1);
441 static int StrLen(
const char* str);
443 static const char*
StrChr(
const char* str,
int c);
489 this->heapBuffer =
nullptr;
556 rhs.heapBuffer =
nullptr;
558 rhs.heapBufferSize = 0;
565 Memory::Copy(rhs.localBuffer, this->localBuffer, this->strLen);
568 rhs.heapBuffer =
nullptr;
570 rhs.heapBufferSize = 0;
621 this->
strLen = rhs.strLen;
627 rhs.heapBuffer =
nullptr;
628 rhs.heapBufferSize = 0;
634 Memory::Copy(rhs.localBuffer, this->localBuffer, this->strLen);
714 return (0 == this->
strLen);
723 return (0 != this->
strLen);
756 char* ptr =
const_cast<char*
>(this->
AsCharPtr());
758 for (i = 0; i <= this->
strLen; i++)
798 pathString = &(lastSlash[1]);
841 if (substring[it] != copy[it])
845 while (copy[it] ==
'/')
848 if (it < substring.
strLen)
862 for (i = 0; i < this->
strLen; i++)
1158template<
typename INTEGER>
1162 constexpr SizeT hexLength =
sizeof(INTEGER) << 1;
1168 for (
SizeT n = 0, j = (hexLength - 1) * 4; n < hexLength; ++n, j -= 4)
1305 for (i = 0; i < s; i++)
1326Util::String operator ""_str(
const char* c, std::size_t s);
1333operator ""_hash(
const char* c, std::size_t s)
Nebula's dynamic array class.
Definition array.h:61
The Util::Blob class encapsulates a chunk of raw memory into a C++ object which can be copied,...
Definition blob.h:22
A collection of key/value pairs with quick value retrieval by key at roughly O(log n).
Definition dictionary.h:35
Set()
default constructor
Definition set.h:79
Nebula's universal string class.
Definition string.h:50
void SetCharPtr(const char *s)
set content to char ptr
Definition string.cc:789
T As() const
convert to "anything"
static String FromVec3(const Math::vec3 &v)
construct a string from vec3
Definition string.h:1070
void SetInt(int val)
set as int value
Definition string.cc:1539
Math::mat4 AsMat4() const
return contents as mat4
Definition string.cc:731
Util::Blob AsBlob() const
return contents as blob
Definition string.cc:1338
static bool IsAlpha(char c)
test if provided character is an alphabet character (A..Z, a..z)
Definition string.cc:1154
static String FromUByte(ubyte i)
construct a string from a ubyte
Definition string.h:915
void SetShort(short val)
set as short value
Definition string.cc:1521
void ToLower()
convert string to lower case
Definition string.cc:939
bool IsValidVec4() const
return true if the content is a valid vec4
Definition string.cc:1757
String ExtractToLastSlash() const
extract path until last slash
Definition string.h:814
static String FromUInt(uint i)
construct a string from a uint
Definition string.h:959
static String FromFloat2(const Math::float2 &v)
construct a string from float2
Definition string.h:1092
void Clear()
clear the string
Definition string.h:703
void SetTransform44(const Math::transform44 &v)
set as transform44 value
Definition string.cc:1729
~String()
destructor
Definition string.h:500
static const char * StrChr(const char *str, int c)
find character in string
Definition string.cc:1253
void Capitalize()
convert first char of string to upper case
Definition string.cc:967
void SetInt64(int64_t val)
set as int64 value
Definition string.cc:1557
void AppendVec4(const Math::vec4 &v)
append vec4 value
Definition string.h:1253
SizeT Length() const
return length of string
Definition string.h:694
size_t length() const
Definition string.h:414
void AppendChar(char val)
append character
Definition string.h:1180
bool IsValidBool() const
return true if the content is a valid bool
Definition string.cc:1042
friend bool operator!=(const String &a, const String &b)
inequality operator
Definition string.cc:894
static String FromBool(bool b)
construct a string from a bool
Definition string.h:1047
static String FromByte(byte i)
construct a string from a byte
Definition string.h:904
void AppendRange(const char *str, SizeT numChars)
append a range of characters
Definition string.cc:151
void AppendFloat(float val)
append float value
Definition string.h:1216
static String FromInt64(int64_t i)
construct a string from a int64
Definition string.h:970
void AppendByte(byte val)
append byte value
Definition string.h:1198
static String FromQuat(const Math::quat &q)
construct a string from quat
Definition string.h:1125
void ConvertBackslashes()
convert backslashes to slashes
Definition string.h:772
void SetVec2(const Math::vec2 &v)
set as vec2 value
Definition string.cc:1650
static String FromDouble(double f)
construct a string from a double
Definition string.h:1036
IndexT FindCharIndex(char c, IndexT startIndex=0) const
return index of character in string, or InvalidIndex if not found
Definition string.cc:369
void ChangeAssignMapping(const Util::String &newMapping, const Util::String &oldMapping)
Change assign mapping (not just the prefix).
Definition string.cc:1300
bool IsValid() const
return true if string object is not empty
Definition string.h:721
void StripFileExtension()
remove file extension
Definition string.cc:827
void SetBool(bool val)
set as bool value
Definition string.cc:1620
void AppendBool(bool val)
append bool value
Definition string.h:1225
static String FromTransform44(const Math::transform44 &m)
construct a string from transform44
Definition string.h:1147
void SetDouble(double val)
set as double value
Definition string.cc:1611
void AppendVec2(const Math::vec2 &v)
append vec2 value
Definition string.h:1235
bool AsBool() const
return contents as bool
Definition string.cc:1123
void SetLongLong(long long val)
set as long long value
Definition string.cc:1593
void ToUpper()
convert string to upper case
Definition string.cc:953
friend bool operator<=(const String &a, const String &b)
less-or-equal operator
Definition string.cc:921
static int StrICmp(const char *str0, const char *str1)
lowlevel case-insensitive string compare function
Definition string.cc:1220
static bool IsDigit(char c)
test if provided character is a digit (0..9)
Definition string.cc:1145
static String Concatenate(const Array< String > &strArray, const String &whiteSpace)
concatenate array of strings into new string
Definition string.cc:768
void TrimLeft(const String &charSet)
delete characters from charset at left side of string
Definition string.cc:434
friend bool operator==(const String &a, const String &b)
equality operator
Definition string.cc:856
void SetUInt64(uint64_t val)
set as uint64 value
Definition string.cc:1566
void StripAssignPrefix()
remove assign prefix (for example tex:)
Definition string.cc:842
void SetFloat4(const Math::float4 &v)
set as vec4 value
Definition string.cc:1695
char operator[](IndexT i) const
read-only index operator
Definition string.h:672
void Fill(SizeT length, unsigned char character)
set string length and fill all characters with arg
Definition string.cc:1636
bool IsValidInt() const
return true if the content is a valid integer
Definition string.h:876
static String FromInt(int i)
construct a string from an int
Definition string.h:948
static String FromFloat(float f)
construct a string from a float
Definition string.h:1025
static String FromVec4(const Math::vec4 &v)
construct a string from vec4
Definition string.h:1081
void __cdecl FormatArgList(const char *fmtString, va_list argList)
format string printf-style with varargs list
Definition string.cc:78
float AsFloat() const
return contents as float
Definition string.cc:1114
String()
constructor
Definition string.h:472
void ChangeAssignPrefix(const Util::String &newPref)
change assign prefix
Definition string.cc:1290
void ReplaceIllegalFilenameChars(char replacement)
replace illegal filename characters
Definition string.h:895
void __cdecl Format(const char *fmtString,...)
format string printf-style
Definition string.cc:57
void Delete()
delete contents
Definition string.h:484
Util::String AsBase64() const
return contents as base64 string
Definition string.cc:1391
bool CopyToBuffer(char *buf, SizeT bufSize) const
copy to char buffer (return false if buffer is too small)
Definition string.cc:38
Math::vec4 AsVec4() const
return contents as vec4
Definition string.cc:1824
bool CheckFileExtension(const String &ext) const
check file extension
Definition string.h:781
int64_t AsInt64() const
return contents as int64_t
Definition string.cc:1078
void ReplaceChars(const String &charSet, char replacement)
replace any char set character within a string with the replacement character
Definition string.cc:708
String ExtractFileName() const
extract the part after the last directory separator
Definition string.h:792
void Append(const T &t)
generic append
String ExtractToEnd(IndexT fromIndex) const
extract substring to end of this string
Definition string.cc:317
static String FromBase64(const String &)
create from base64
Definition string.cc:1408
void SetMat4(const Math::mat4 &v)
set as mat4 value
Definition string.cc:1713
bool IsValidFloat() const
return true if the content is a valid float
Definition string.h:886
void SetSizeT(size_t val)
set as long value
Definition string.cc:1584
Math::float3 AsFloat3() const
return contents as vec3
Definition string.cc:1850
void TrimRight(const String &charSet)
delete characters from charset at right side of string
Definition string.cc:476
void Alloc(SizeT size)
allocate the string buffer (discards old content)
Definition string.cc:1435
static String FromUInt64(uint64_t i)
construct a string from a uint64
Definition string.h:981
Math::vec2 AsVec2() const
return contents as vec2
Definition string.cc:1795
static String FromFloat3(const Math::float3 &v)
construct a string from float2
Definition string.h:1103
void ChangeFileExtension(const Util::String &newExt)
change file extension
Definition string.cc:1280
static bool IsUpper(char c)
test if provided character is an upper-case character
Definition string.cc:1181
Math::transform44 AsTransform44() const
return contents as transform44
Definition string.cc:748
void Set(const T &t)
generic setter
void Append(const String &str)
append string
Definition string.h:654
Math::float4 AsFloat4() const
return contents as vec4
Definition string.cc:1863
friend bool operator<(const String &a, const String &b)
less-then operator
Definition string.cc:903
void AppendUByte(ubyte val)
append unsigned byte value
Definition string.h:1207
String ExtractDirName() const
extract the part before the last directory separator
Definition string.cc:606
static constexpr uint Hash(const char *c, std::size_t s)
Hash a string.
Definition string.h:1301
static int StrCmp(const char *str0, const char *str1)
lowlevel string compare wrapper function
Definition string.cc:1208
char * GetLastSlash() const
get pointer to last directory separator, or nullptr if there is none
Definition string.cc:1029
SizeT heapBufferSize
Definition string.h:465
static String From(const T &t)
convert from "anything"
void operator=(const String &rhs)
assignment operator
Definition string.h:604
String StripSubstring(const String &substring) const
removes the leading substring from this string as long as it's matching
Definition string.h:834
void SetLong(long val)
set as long value
Definition string.cc:1575
static String FromLongLong(long long i)
construct a string from a long long
Definition string.h:1014
void SetByte(byte val)
set as byte value
Definition string.cc:1503
Math::float2 AsFloat2() const
return contents as vec2
Definition string.cc:1837
static String FromMat4(const Math::mat4 &m)
construct a string from mat4
Definition string.h:1136
int AsInt() const
return contents as integer
Definition string.cc:1066
const char * data() const
Definition string.h:418
void SetVec3(const Math::vec3 &v)
set as vec3 value
Definition string.cc:1659
void SetUInt(uint val)
set as uint value
Definition string.cc:1548
static String FromBlob(const Util::Blob &b)
create from blob
Definition string.cc:1312
static String FromShort(short i)
construct a string from a short
Definition string.h:926
void AppendVec3(const Math::vec3 &v)
append vec3 value
Definition string.h:1244
void Strip(const String &charSet)
terminate string at first occurence of character in set
Definition string.cc:328
static String FromUShort(ushort i)
construct a string from a ushort
Definition string.h:937
void TerminateAtIndex(IndexT index)
terminate string at given index
Definition string.cc:814
bool BeginsWithString(const String &s) const
returns true if string begins with string
Definition string.cc:406
void SetVec4(const Math::vec4 &v)
set as vec4 value
Definition string.cc:1668
void AppendMat4(const Math::mat4 &v)
append mat4 value
Definition string.h:1262
const char * AsCharPtr() const
return contents as character pointer
Definition string.h:579
void AppendInt(int val)
append int value
Definition string.h:1189
static String FromVec2(const Math::vec2 &v)
construct a string from vec2
Definition string.h:1059
void Realloc(SizeT newSize)
(re-)allocate the string buffer (copies old content)
Definition string.cc:1458
String ExtractLastDirName() const
extract the last directory of the path
Definition string.cc:566
@ LocalStringSize
Definition string.h:460
void SetFloat(float val)
set as float value
Definition string.cc:1602
static int StrLen(const char *str)
lowlevel string length function
Definition string.cc:1243
char * heapBuffer
Definition string.h:462
SizeT Tokenize(const String &whiteSpace, Array< String > &outTokens) const
tokenize string into a provided String array (faster if tokens array can be reused)
Definition string.cc:201
static Dictionary< String, String > ParseKeyValuePairs(const String &str)
parse key/value pair string ("key0=value0 key1=value1")
Definition string.cc:1263
void SetFloat2(const Math::float2 &v)
set as vec2 value
Definition string.cc:1677
bool IsValidTransform44() const
return true if content is a valid transform44
Definition string.cc:1781
void Trim(const String &charSet)
trim characters from charset at both sides of string
Definition string.cc:519
friend bool operator>(const String &a, const String &b)
greater-then operator
Definition string.cc:912
bool IsValidMat4() const
return true if content is a valid mat4
Definition string.cc:1769
const char * Get() const
*** OBSOLETE *** only Nebula2 compatibility
Definition string.h:595
static bool IsLower(char c)
test if provided character is a lower case character
Definition string.cc:1172
bool IsEmpty() const
return true if string object is empty
Definition string.h:712
String GetFileExtension() const
get filename extension without dot
Definition string.cc:1011
void SubstituteString(const String &str, const String &substStr)
substitute every occurance of a string with another string
Definition string.cc:530
String & AppendPath(const String &path)
Appends a directory or file to current string.
Definition string.h:1272
static bool MatchPattern(const String &str, const String &pattern)
pattern matching
Definition string.cc:633
static String FromLong(long i)
construct a string from a long
Definition string.h:992
char localBuffer[LocalStringSize]
Definition string.h:463
void operator+=(const String &rhs)
+= operator
Definition string.h:663
bool EndsWithString(const String &s) const
returns true if string ends with string
Definition string.cc:419
static String Sprintf(const char *fmtString,...)
static constructor for string using printf
Definition string.cc:96
void SetQuaternion(const Math::quat &v)
set as quaternion
Definition string.cc:1704
const char * c_str() const
helpers to interface with libraries that expect std::string like apis
Definition string.h:412
void CamelCaseToWords()
insert spaces before each capital letter in the string.
Definition string.cc:977
static String FromSize(size_t i)
construct a string from a size_t
Definition string.h:1003
IndexT FindStringIndex(const String &s, IndexT startIndex=0) const
return start index of substring, or InvalidIndex if not found
Definition string.cc:344
uint32_t HashCode() const
return a 32-bit hash code for the string
Definition string.h:732
uint32_t AsUInt() const
return contents as unsigned integer
Definition string.cc:1090
void SubstituteChar(char c, char subst)
substitute every occurance of a character with another character
Definition string.h:754
static String Hex(INTEGER i)
construct a hex string from an int
Definition string.h:1160
void SetUByte(ubyte val)
set as ubyte value
Definition string.cc:1512
String ExtractRange(IndexT fromIndex, SizeT numChars) const
extract substring
Definition string.cc:302
void SetUShort(ushort val)
set as ushort value
Definition string.cc:1530
static String FromFloat4(const Math::float4 &v)
construct a string from float2
Definition string.h:1114
Math::vec3 AsVec3() const
return contents as vec3
Definition string.cc:1808
friend bool operator>=(const String &a, const String &b)
greater-then operator
Definition string.cc:930
bool CheckValidCharSet(const String &charSet) const
return true if string only contains characters from charSet argument
Definition string.h:859
bool IsValid() const
generic valid checker
uint64_t AsUInt64() const
return contents as unsigned uint64_t
Definition string.cc:1102
bool empty() const
Definition string.h:416
SizeT strLen
Definition string.h:464
IndexT FindCharIndexReverse(char c, IndexT startIndex=0) const
return index of character in string, or InvalidIndex if not found
Definition string.cc:388
void Reserve(SizeT newSize)
reserve internal buffer size to prevent heap allocs
Definition string.cc:1491
bool ContainsCharFromSet(const String &charSet) const
returns true if string contains any character from set
Definition string.cc:999
void SetFloat3(const Math::float3 &v)
set as vec3 value
Definition string.cc:1686
static bool IsAlNum(char c)
test if provided character is an alpha-numeric character (A..Z,a..z,0..9)
Definition string.cc:1163
bool IsValidVec2() const
return true if the content is a valid vec2
Definition string.cc:1745
#define n_assert(exp)
Definition debug.h:58
Different curves.
Definition angularpfeedbackloop.h:17
half operator+(half one, half two)
Definition half.h:105
void Copy(const void *from, void *to, size_t numBytes)
Copy a chunk of memory (note the argument order is different from memcpy()!
Definition osxmemory.cc:213
void Free(HeapType heapType, void *ptr)
Free a block of memory.
Definition osxmemory.cc:136
@ StringDataHeap
Definition osxmemoryconfig.h:31
A quad tree designed to return regions of free 2D space.
Definition Random.cs:5
auto Format
Definition string.h:1317
A 4x4 single point precision float matrix.
Definition mat4.h:55
A quaternion is usually used to represent an orientation in 3D space.
Definition quat.h:30
A 2-component float vector class.
Definition vec2.h:21
A 3D vector.
Definition vec3.h:37
A 4D vector.
Definition vec4.h:24
unsigned char ubyte
Definition types.h:44
int SizeT
Definition types.h:50
unsigned int uint
Definition types.h:41
unsigned short ushort
Definition types.h:42
int IndexT
Definition types.h:49