tweak(string): Implement functions in AsciiString, UnicodeString to return the byte count of the contained string (#1407)

Author: Mauller

Core/GameEngine/Include/Common/AsciiString.h

@@ -154,9 +154,14 @@ class AsciiString
 	~AsciiString();
 
 	/**
-		Return the length, in characters (not bytes!), of the string.
+		Return the length, in characters, of the string up to the first zero or null terminator.
 	*/
 	int getLength() const;
+
+	/**
+		Return the number of bytes used by the string up to the first zero or null terminator.
+	*/
+	int getByteCount() const;
 	/**
 		Return true iff the length of the string is zero. Equivalent
 		to (getLength() == 0) but slightly more efficient.
@@ -391,6 +396,13 @@ inline int AsciiString::getLength() const
 	return m_data ? strlen(peek()) : 0;
 }
 
+// -----------------------------------------------------
+inline int AsciiString::getByteCount() const
+{
+	validate();
+	return m_data ? getLength() : 0;
+}
+
 // -----------------------------------------------------
 inline Bool AsciiString::isEmpty() const
 {

Core/GameEngine/Include/Common/UnicodeString.h

@@ -154,9 +154,14 @@ class UnicodeString
 	~UnicodeString();
 
 	/**
-		Return the length, in characters (not bytes!), of the string.
+		Return the length, in characters, of the string up to the first zero or null terminator.
 	*/
 	int getLength() const;
+
+	/**
+		Return the number of bytes used by the string up to the first zero or null terminator.
+	*/
+	int getByteCount() const;
 	/**
 		Return true iff the length of the string is zero. Equivalent
 		to (getLength() == 0) but slightly more efficient.
@@ -341,6 +346,13 @@ inline int UnicodeString::getLength() const
 	return m_data ? wcslen(peek()) : 0;
 }
 
+// -----------------------------------------------------
+inline int UnicodeString::getByteCount() const
+{
+	validate();
+	return m_data ? getLength() * sizeof(WideChar) : 0;
+}
+
 // -----------------------------------------------------
 inline Bool UnicodeString::isEmpty() const
 {