mirror of
https://github.com/electronicarts/CnC_Renegade.git
synced 2026-01-17 19:57:01 +01:00
Initial commit of Command & Conquer Renegade source code.
This commit is contained in:
LFeenanEA
784
Code/wwlib/wwstring.h
Normal file
784
Code/wwlib/wwstring.h
Normal file
@@ -0,0 +1,784 @@
|
||||
/*
|
||||
** Command & Conquer Renegade(tm)
|
||||
** Copyright 2025 Electronic Arts Inc.
|
||||
**
|
||||
** This program is free software: you can redistribute it and/or modify
|
||||
** it under the terms of the GNU General Public License as published by
|
||||
** the Free Software Foundation, either version 3 of the License, or
|
||||
** (at your option) any later version.
|
||||
**
|
||||
** This program is distributed in the hope that it will be useful,
|
||||
** but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
** GNU General Public License for more details.
|
||||
**
|
||||
** You should have received a copy of the GNU General Public License
|
||||
** along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
/***********************************************************************************************
|
||||
*** C O N F I D E N T I A L --- W E S T W O O D S T U D I O S ***
|
||||
***********************************************************************************************
|
||||
* *
|
||||
* Project Name : WWSaveLoad *
|
||||
* *
|
||||
* $Archive:: /Commando/Code/wwlib/wwstring.h $*
|
||||
* *
|
||||
* Author:: Patrick Smith *
|
||||
* *
|
||||
* $Modtime:: 12/13/01 5:11p $*
|
||||
* *
|
||||
* $Revision:: 37 $*
|
||||
* *
|
||||
*---------------------------------------------------------------------------------------------*
|
||||
* Functions: *
|
||||
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
|
||||
|
||||
#if defined(_MSC_VER)
|
||||
#pragma once
|
||||
#endif
|
||||
|
||||
#ifndef __WWSTRING_H
|
||||
#define __WWSTRING_H
|
||||
|
||||
#include "always.h"
|
||||
#include "mutex.h"
|
||||
#include "win.h"
|
||||
#include <string.h>
|
||||
#include <stdarg.h>
|
||||
#include <tchar.h>
|
||||
#include "trim.h"
|
||||
#include "wwdebug.h"
|
||||
#ifdef _UNIX
|
||||
#include "osdep.h"
|
||||
#endif
|
||||
|
||||
|
||||
|
||||
//////////////////////////////////////////////////////////////////////
|
||||
//
|
||||
// StringClass
|
||||
//
|
||||
// Note: This class is UNICODE friendly. That means it can be
|
||||
// compiled using either single-byte or double-byte strings. There
|
||||
// are no assumptions made as to the size of a character.
|
||||
//
|
||||
// Any method that takes a parameter with the word 'len' or 'length'
|
||||
// in it refers to a count of characters. If the name contains 'byte'
|
||||
// it is talking about the memory size.
|
||||
//
|
||||
//////////////////////////////////////////////////////////////////////
|
||||
class StringClass
|
||||
{
|
||||
public:
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Public constructors/destructors
|
||||
////////////////////////////////////////////////////////////
|
||||
StringClass (bool hint_temporary);
|
||||
StringClass (int initial_len = 0, bool hint_temporary = false);
|
||||
StringClass (const StringClass &string, bool hint_temporary = false);
|
||||
StringClass (const TCHAR *string, bool hint_temporary = false);
|
||||
StringClass (TCHAR ch, bool hint_temporary = false);
|
||||
StringClass (const WCHAR *string, bool hint_temporary = false);
|
||||
~StringClass (void);
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Public operators
|
||||
////////////////////////////////////////////////////////////
|
||||
bool operator== (const TCHAR *rvalue) const;
|
||||
bool operator!= (const TCHAR *rvalue) const;
|
||||
|
||||
inline const StringClass &operator= (const StringClass &string);
|
||||
inline const StringClass &operator= (const TCHAR *string);
|
||||
inline const StringClass &operator= (TCHAR ch);
|
||||
inline const StringClass &operator= (const WCHAR *string);
|
||||
|
||||
const StringClass &operator+= (const StringClass &string);
|
||||
const StringClass &operator+= (const TCHAR *string);
|
||||
const StringClass &operator+= (TCHAR ch);
|
||||
|
||||
friend StringClass operator+ (const StringClass &string1, const StringClass &string2);
|
||||
friend StringClass operator+ (const TCHAR *string1, const StringClass &string2);
|
||||
friend StringClass operator+ (const StringClass &string1, const TCHAR *string2);
|
||||
|
||||
bool operator < (const TCHAR *string) const;
|
||||
bool operator <= (const TCHAR *string) const;
|
||||
bool operator > (const TCHAR *string) const;
|
||||
bool operator >= (const TCHAR *string) const;
|
||||
|
||||
const TCHAR & operator[] (int index) const;
|
||||
TCHAR & operator[] (int index);
|
||||
inline operator const TCHAR * (void) const;
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Public methods
|
||||
////////////////////////////////////////////////////////////
|
||||
int Compare (const TCHAR *string) const;
|
||||
int Compare_No_Case (const TCHAR *string) const;
|
||||
|
||||
inline int Get_Length (void) const;
|
||||
bool Is_Empty (void) const;
|
||||
|
||||
void Erase (int start_index, int char_count);
|
||||
int _cdecl Format (const TCHAR *format, ...);
|
||||
int _cdecl Format_Args (const TCHAR *format, const va_list & arg_list );
|
||||
|
||||
// Trim leading and trailing whitespace characters (values <= 32)
|
||||
void Trim(void);
|
||||
|
||||
TCHAR * Get_Buffer (int new_length);
|
||||
TCHAR * Peek_Buffer (void);
|
||||
const TCHAR * Peek_Buffer (void) const;
|
||||
|
||||
bool Copy_Wide (const WCHAR *source);
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Static methods
|
||||
////////////////////////////////////////////////////////////
|
||||
static void Release_Resources (void);
|
||||
|
||||
private:
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Private structures
|
||||
////////////////////////////////////////////////////////////
|
||||
typedef struct _HEADER
|
||||
{
|
||||
int allocated_length;
|
||||
int length;
|
||||
} HEADER;
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Private constants
|
||||
////////////////////////////////////////////////////////////
|
||||
// Note: Don't change these enums without withs checking the Get_String() and Free_String() function!
|
||||
enum
|
||||
{
|
||||
MAX_TEMP_STRING = 8,
|
||||
MAX_TEMP_LEN = 256-sizeof(_HEADER),
|
||||
MAX_TEMP_BYTES = (MAX_TEMP_LEN * sizeof (TCHAR)) + sizeof (HEADER),
|
||||
ALL_TEMP_STRINGS_USED_MASK = 0xff
|
||||
};
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Private methods
|
||||
////////////////////////////////////////////////////////////
|
||||
void Get_String (int length, bool is_temp);
|
||||
TCHAR * Allocate_Buffer (int length);
|
||||
void Resize (int size);
|
||||
void Uninitialised_Grow (int length);
|
||||
void Free_String (void);
|
||||
|
||||
inline void Store_Length (int length);
|
||||
inline void Store_Allocated_Length (int allocated_length);
|
||||
inline HEADER * Get_Header (void) const;
|
||||
int Get_Allocated_Length (void) const;
|
||||
|
||||
void Set_Buffer_And_Allocated_Length (TCHAR *buffer, int length);
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Private member data
|
||||
////////////////////////////////////////////////////////////
|
||||
TCHAR * m_Buffer;
|
||||
|
||||
////////////////////////////////////////////////////////////
|
||||
// Static member data
|
||||
////////////////////////////////////////////////////////////
|
||||
static unsigned ReservedMask;
|
||||
static char m_TempStrings[];
|
||||
|
||||
static FastCriticalSectionClass m_Mutex;
|
||||
|
||||
static TCHAR m_NullChar;
|
||||
static TCHAR * m_EmptyString;
|
||||
};
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator= (const StringClass &string)
|
||||
{
|
||||
int len = string.Get_Length();
|
||||
Uninitialised_Grow(len+1);
|
||||
Store_Length(len);
|
||||
|
||||
::memcpy (m_Buffer, string.m_Buffer, (len+1) * sizeof (TCHAR));
|
||||
return (*this);
|
||||
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator= (const TCHAR *string)
|
||||
{
|
||||
if (string != 0) {
|
||||
|
||||
int len = _tcslen (string);
|
||||
Uninitialised_Grow (len+1);
|
||||
Store_Length (len);
|
||||
|
||||
::memcpy (m_Buffer, string, (len + 1) * sizeof (TCHAR));
|
||||
}
|
||||
|
||||
return (*this);
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator= (const WCHAR *string)
|
||||
{
|
||||
if (string != 0) {
|
||||
Copy_Wide (string);
|
||||
}
|
||||
|
||||
return (*this);
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator= (TCHAR ch)
|
||||
{
|
||||
Uninitialised_Grow (2);
|
||||
|
||||
m_Buffer[0] = ch;
|
||||
m_Buffer[1] = m_NullChar;
|
||||
Store_Length (1);
|
||||
|
||||
return (*this);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
Get_String (MAX_TEMP_LEN, hint_temporary);
|
||||
m_Buffer[0] = m_NullChar;
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (int initial_len, bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
Get_String (initial_len, hint_temporary);
|
||||
m_Buffer[0] = m_NullChar;
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (TCHAR ch, bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
Get_String (2, hint_temporary);
|
||||
(*this) = ch;
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (const StringClass &string, bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
if (hint_temporary || (string.Get_Length()>0)) {
|
||||
Get_String (string.Get_Length()+1, hint_temporary);
|
||||
}
|
||||
|
||||
(*this) = string;
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (const TCHAR *string, bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
int len=string ? _tcsclen(string) : 0;
|
||||
if (hint_temporary || len>0) {
|
||||
Get_String (len+1, hint_temporary);
|
||||
}
|
||||
|
||||
(*this) = string;
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::StringClass (const WCHAR *string, bool hint_temporary)
|
||||
: m_Buffer (m_EmptyString)
|
||||
{
|
||||
int len = string ? wcslen (string) : 0;
|
||||
if (hint_temporary || len > 0) {
|
||||
Get_String (len + 1, hint_temporary);
|
||||
}
|
||||
|
||||
(*this) = string;
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// ~StringClass
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::~StringClass (void)
|
||||
{
|
||||
Free_String ();
|
||||
return ;
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Is_Empty
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::Is_Empty (void) const
|
||||
{
|
||||
return (m_Buffer[0] == m_NullChar);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Compare
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline int
|
||||
StringClass::Compare (const TCHAR *string) const
|
||||
{
|
||||
return _tcscmp (m_Buffer, string);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Compare_No_Case
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline int
|
||||
StringClass::Compare_No_Case (const TCHAR *string) const
|
||||
{
|
||||
return _tcsicmp (m_Buffer, string);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator[]
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const TCHAR &
|
||||
StringClass::operator[] (int index) const
|
||||
{
|
||||
WWASSERT (index >= 0 && index < Get_Length ());
|
||||
return m_Buffer[index];
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator[]
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline TCHAR &
|
||||
StringClass::operator[] (int index)
|
||||
{
|
||||
WWASSERT (index >= 0 && index < Get_Length ());
|
||||
return m_Buffer[index];
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator const TCHAR *
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline
|
||||
StringClass::operator const TCHAR * (void) const
|
||||
{
|
||||
return m_Buffer;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator==
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator== (const TCHAR *rvalue) const
|
||||
{
|
||||
return (Compare (rvalue) == 0);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator!=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator!= (const TCHAR *rvalue) const
|
||||
{
|
||||
return (Compare (rvalue) != 0);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator <
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator < (const TCHAR *string) const
|
||||
{
|
||||
return (_tcscmp (m_Buffer, string) < 0);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator <=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator <= (const TCHAR *string) const
|
||||
{
|
||||
return (_tcscmp (m_Buffer, string) <= 0);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator >
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator > (const TCHAR *string) const
|
||||
{
|
||||
return (_tcscmp (m_Buffer, string) > 0);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator >=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline bool
|
||||
StringClass::operator >= (const TCHAR *string) const
|
||||
{
|
||||
return (_tcscmp (m_Buffer, string) >= 0);
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Erase
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline void
|
||||
StringClass::Erase (int start_index, int char_count)
|
||||
{
|
||||
int len = Get_Length ();
|
||||
|
||||
if (start_index < len) {
|
||||
|
||||
if (start_index + char_count > len) {
|
||||
char_count = len - start_index;
|
||||
}
|
||||
|
||||
::memmove ( &m_Buffer[start_index],
|
||||
&m_Buffer[start_index + char_count],
|
||||
(len - (start_index + char_count) + 1) * sizeof (TCHAR));
|
||||
|
||||
Store_Length( len - char_count );
|
||||
}
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Trim leading and trailing whitespace characters (values <= 32)
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline void StringClass::Trim(void)
|
||||
{
|
||||
strtrim(m_Buffer);
|
||||
}
|
||||
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator+= (const TCHAR *string)
|
||||
{
|
||||
WWASSERT (string != NULL);
|
||||
|
||||
int cur_len = Get_Length ();
|
||||
int src_len = _tcslen (string);
|
||||
int new_len = cur_len + src_len;
|
||||
|
||||
//
|
||||
// Make sure our buffer is large enough to hold the new string
|
||||
//
|
||||
Resize (new_len + 1);
|
||||
Store_Length (new_len);
|
||||
|
||||
//
|
||||
// Copy the new string onto our the end of our existing buffer
|
||||
//
|
||||
::memcpy (&m_Buffer[cur_len], string, (src_len + 1) * sizeof (TCHAR));
|
||||
return (*this);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator+= (TCHAR ch)
|
||||
{
|
||||
int cur_len = Get_Length ();
|
||||
Resize (cur_len + 2);
|
||||
|
||||
m_Buffer[cur_len] = ch;
|
||||
m_Buffer[cur_len + 1] = m_NullChar;
|
||||
|
||||
if (ch != m_NullChar) {
|
||||
Store_Length (cur_len + 1);
|
||||
}
|
||||
|
||||
return (*this);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Get_Buffer
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline TCHAR *
|
||||
StringClass::Get_Buffer (int new_length)
|
||||
{
|
||||
Uninitialised_Grow (new_length);
|
||||
|
||||
return m_Buffer;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Peek_Buffer
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline TCHAR *
|
||||
StringClass::Peek_Buffer (void)
|
||||
{
|
||||
return m_Buffer;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Peek_Buffer
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const TCHAR *
|
||||
StringClass::Peek_Buffer (void) const
|
||||
{
|
||||
return m_Buffer;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline const StringClass &
|
||||
StringClass::operator+= (const StringClass &string)
|
||||
{
|
||||
int src_len = string.Get_Length();
|
||||
if (src_len > 0) {
|
||||
int cur_len = Get_Length ();
|
||||
int new_len = cur_len + src_len;
|
||||
|
||||
//
|
||||
// Make sure our buffer is large enough to hold the new string
|
||||
//
|
||||
Resize (new_len + 1);
|
||||
Store_Length (new_len);
|
||||
|
||||
//
|
||||
// Copy the new string onto our the end of our existing buffer
|
||||
//
|
||||
::memcpy (&m_Buffer[cur_len], (const TCHAR *)string, (src_len + 1) * sizeof (TCHAR));
|
||||
}
|
||||
|
||||
return (*this);
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline StringClass
|
||||
operator+ (const StringClass &string1, const StringClass &string2)
|
||||
{
|
||||
StringClass new_string(string1, true);
|
||||
new_string += string2;
|
||||
return new_string;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline StringClass
|
||||
operator+ (const TCHAR *string1, const StringClass &string2)
|
||||
{
|
||||
StringClass new_string(string1, true);
|
||||
new_string += string2;
|
||||
return new_string;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// operator+=
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline StringClass
|
||||
operator+ (const StringClass &string1, const TCHAR *string2)
|
||||
{
|
||||
StringClass new_string(string1, true);
|
||||
StringClass new_string2(string2, true);
|
||||
new_string += new_string2;
|
||||
return new_string;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Get_Allocated_Length
|
||||
//
|
||||
// Return allocated size of the string buffer
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline int
|
||||
StringClass::Get_Allocated_Length (void) const
|
||||
{
|
||||
int allocated_length = 0;
|
||||
|
||||
//
|
||||
// Read the allocated length from the header
|
||||
//
|
||||
if (m_Buffer != m_EmptyString) {
|
||||
HEADER *header = Get_Header ();
|
||||
allocated_length = header->allocated_length;
|
||||
}
|
||||
|
||||
return allocated_length;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Get_Length
|
||||
//
|
||||
// Return text legth. If length is not known calculate it, otherwise
|
||||
// just return the previously stored value (strlen tends to take
|
||||
// quite a lot cpu time if a lot of string combining operations are
|
||||
// performed.
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline int
|
||||
StringClass::Get_Length (void) const
|
||||
{
|
||||
int length = 0;
|
||||
|
||||
if (m_Buffer != m_EmptyString) {
|
||||
|
||||
//
|
||||
// Read the length from the header
|
||||
//
|
||||
HEADER *header = Get_Header ();
|
||||
length = header->length;
|
||||
|
||||
//
|
||||
// Hmmm, a zero length was stored in the header,
|
||||
// we better manually get the string length.
|
||||
//
|
||||
if (length == 0) {
|
||||
length = _tcslen (m_Buffer);
|
||||
((StringClass *)this)->Store_Length (length);
|
||||
}
|
||||
}
|
||||
|
||||
return length;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Set_Buffer_And_Allocated_Length
|
||||
//
|
||||
// Set buffer pointer and init size variable. Length is set to 0
|
||||
// as the contents of the new buffer are not necessarily defined.
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline void
|
||||
StringClass::Set_Buffer_And_Allocated_Length (TCHAR *buffer, int length)
|
||||
{
|
||||
Free_String ();
|
||||
m_Buffer = buffer;
|
||||
|
||||
//
|
||||
// Update the header (if necessary)
|
||||
//
|
||||
if (m_Buffer != m_EmptyString) {
|
||||
Store_Allocated_Length (length);
|
||||
Store_Length (0);
|
||||
} else {
|
||||
WWASSERT (length == 0);
|
||||
}
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Allocate_Buffer
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline TCHAR *
|
||||
StringClass::Allocate_Buffer (int length)
|
||||
{
|
||||
//
|
||||
// Allocate a buffer that is 'length' characters long, plus the
|
||||
// bytes required to hold the header.
|
||||
//
|
||||
char *buffer = new char[(sizeof (TCHAR) * length) + sizeof (StringClass::_HEADER)];
|
||||
|
||||
//
|
||||
// Fill in the fields of the header
|
||||
//
|
||||
HEADER *header = reinterpret_cast<HEADER *>(buffer);
|
||||
header->length = 0;
|
||||
header->allocated_length = length;
|
||||
|
||||
//
|
||||
// Return the buffer as if it was a TCHAR pointer
|
||||
//
|
||||
return reinterpret_cast<TCHAR *>(buffer + sizeof (StringClass::_HEADER));
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Get_Header
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline StringClass::HEADER *
|
||||
StringClass::Get_Header (void) const
|
||||
{
|
||||
return reinterpret_cast<HEADER *>(((char *)m_Buffer) - sizeof (StringClass::_HEADER));
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Store_Allocated_Length
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline void
|
||||
StringClass::Store_Allocated_Length (int allocated_length)
|
||||
{
|
||||
if (m_Buffer != m_EmptyString) {
|
||||
HEADER *header = Get_Header ();
|
||||
header->allocated_length = allocated_length;
|
||||
} else {
|
||||
WWASSERT (allocated_length == 0);
|
||||
}
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
///////////////////////////////////////////////////////////////////
|
||||
// Store_Length
|
||||
//
|
||||
// Set length... The caller of this (private) function better
|
||||
// be sure that the len is correct.
|
||||
///////////////////////////////////////////////////////////////////
|
||||
inline void
|
||||
StringClass::Store_Length (int length)
|
||||
{
|
||||
if (m_Buffer != m_EmptyString) {
|
||||
HEADER *header = Get_Header ();
|
||||
header->length = length;
|
||||
} else {
|
||||
WWASSERT (length == 0);
|
||||
}
|
||||
|
||||
return ;
|
||||
}
|
||||
|
||||
#endif //__WWSTRING_H
|
||||
|
||||
Reference in New Issue
Block a user