winamp/Src/Wasabi/bfc/string/StringW.h
2024-09-24 14:54:57 +02:00

468 lines
14 KiB
C++

#ifndef _STRINGW_H_WASABI
#define _STRINGW_H_WASABI
#ifdef __cplusplus
/**
This is a very basic string class. It is not trying to be a be-all end-all
string class. It's meant to be just enough functionality to avoid STRDUP().
It is available to use in client apps, but no API in Wasabi depends on its
use by client code, so you can ignore it if you like. ;)
Also note that one of the design goals is to use same storage space as
a char *, which means no virtual methods.
@short Basic string class, to replace STRDUP/FREE
@see StringPrintf
@see DebugString
*/
#include <bfc/platform/types.h>
class StringW
{
public:
StringW(const wchar_t *initial_val = NULL);
StringW(const StringW &s);
StringW(const StringW *s);
~StringW();
/**
Returns the value of the string. It is a pointer to the internal storage
used by the class, so you must not assume the pointer will not change,
because it will.
@see getValueSafe();
@ret The value of the string.
*/
const wchar_t *getValue() const { return val; }
const wchar_t *v() const { return getValue(); } // for ease of typing
operator const wchar_t *() const { return getValue(); }
/**
Gets the value of the string, or a safe value if the value is NULL.
@param def_val The value to return if the string's value is NULL. Defaults to "".
@see getValue()
@ret The value of the string, or a safe value if the value is NULL.
*/
const wchar_t *getValueSafe(const wchar_t *def_val = L"") const; // returns def_val if NULL
/**
Returns the value of the character at a position in the string. If the
position is invalid, returns -1. Note that unless bounds_check is set to
TRUE, the pos will only be checked for negative values.
@param pos The position of the character to return.
@param bounds_check If TRUE, pos is checked against the length of the string.
@see setChar()
@ret The value of the character at the position in the string, or -1 if the position is invalid.
*/
//int getChar(int pos, int bounds_check = FALSE);
/**
Sets the value of the character at a position in the string. Not multibyte UTF-8 safe yet. No lengthwise bounds checking yet.
@param pos The position to set.
@param value The value to set.
@ret The value of the character set, or -1 if pos < 0.
*/
//int setChar(int pos, int value);
/**
Sets the value of the string. The given value will be copied.
Can accept NULL. Note that this may cause the
pointer returned by getValue() et al to change.
@param newval The new value of the string, nul-terminated.
@ret The new value of the string.
@see getValue()
*/
const wchar_t *setValue(const wchar_t *newval);
/**
Gets the value of the string in the form of a non-const wchar_t *. WARNING: you
don't usually need to call this. If you want to modify the string,
you can generally just use setChar(), or setValue().
@ret The value of the string, casted to a non-const wchar_t *.
@see getValue()
@see setValue();
@see setChar();
*/
wchar_t *getNonConstVal() { return const_cast<wchar_t *>(getValue()); }
const wchar_t *operator =(const wchar_t *newval) { return setValue(newval); }
const wchar_t *operator +=(const wchar_t *addval)
{
return cat(addval);
}
const wchar_t *operator +=(wchar_t value);
const wchar_t *operator +=(int value);
const wchar_t *operator +=(GUID guid);
// copy assignment operator
StringW &operator =(const StringW &s)
{
if (this != &s)
setValue(s);
return *this;
}
// comparator operators
//inline int operator ==(const wchar_t *val) const
//{
// if (!val) return isempty();
// return isequal(val);
//}
//inline int operator <(const wchar_t *val) const
//{
// return islessthan(val);
//}
//inline int operator !=(const wchar_t *val) const
//{
// if (!val) return !isempty();
// return !isequal(val);
//}
//inline int operator >(const wchar_t *val) const
//{
// return (!islessthan(val)) && (!isequal(val));
//}
inline StringW operator +(const wchar_t *val)
{
StringW retval = *this;
return retval += val;
}
//inline int operator ==(const StringW &val) const
//{
// return isequal(val);
//}
//inline int operator <(const StringW &val) const
//{
// return islessthan(val);
//}
//inline int operator !=(const StringW &val) const
//{
// return !isequal(val);
//}
//inline int operator >(const StringW &val) const
//{
// return (!islessthan(val)) && (!isequal(val));
//}
//inline StringW operator +(const StringW &val)
//{
// StringW retval = *this;
// return retval += val;
//}
//inline StringW operator +(const wchar_t val)
//{
// StringW retval = *this;
// return retval += val;
//}
/**
Gets the length of the string's value. Note that a 0 length can result from
both a value of NULL and a value of "".
@ret The length of the string's value;
*/
size_t len() const;
/**
Returns TRUE if the string's value is either NULL or "".
@ret TRUE if the string's value is either NULL or "", FALSE otherwise.
*/
int isempty() const;
/**
Converts entire string to uppercase. Not multibyte UTF-8 safe yet.
@see tolower()
*/
void toupper();
/**
Converts entire string to lowercase. Not multibyte UTF-8 safe yet.
@see tolower()
*/
void tolower();
/**
Checks string value equality against a nul-terminated wchar_t *.
@param otherval The value to check against. If NULL, will be treated as "".
@ret TRUE if the string matches exactly, FALSE otherwise.
@see iscaseequal()
@see islessthan()
*/
int isequal(const wchar_t *otherval) const; // basically !strcmp
/**
Checks string value equality against a nul-terminated wchar_t *, case insensitively. I.e. "Blah" is case equal to "bLaH".
@param otherval The value to check against. If NULL, will be treated as "".
@ret TRUE if the string matches case-insensitively, FALSE otherwise.
@see isequal()
@see islessthan()
*/
int iscaseequal(const wchar_t *otherval) const; // basically !strcasecmp
//int islessthan(const wchar_t *otherval) const; // basically strcmp < 0
/**
Changes all instances of a character to another character throughout the
string. Not multibyte UTF-8 aware yet. Note you can use a 'to' of NULL,
but this practice is not encouraged: try to use trunc() or truncateOnChar() instead.
@param from The character value to modify.
@param to The character value to replace with.
@see trunc()
@see truncateOnChar()
*/
void changeChar(wchar_t from, wchar_t to);
/**
Truncates the string value at the first given character value found. If fromright==TRUE, searches from the right, otherwise goes left-to-right. Not UTF-8 multibyte aware yet.
Ex:
StringW x("abcd");
x.truncateOnChar('c');
x now contains "ab"
@see changeChar()
*/
//void truncateOnChar(int which, int fromright = FALSE);
/**
Gets the last character value (rightmost).
@see getChar()
@ret The rightmost character value, or -1 if string is empty.
*/
int lastChar(); // -1 if empty
/**
Executes a standard printf type call and sets the string's value to it.
@ret The new value of the string.
@param format The formatting string to use.
*/
const wchar_t *printf(const wchar_t *format, ...);
/**
Concatenates the given value onto the end of the string. NULL will be
treated as "".
@param value The value to concatenate.
@ret The new value of the string.
@see catn()
@see prepend()
*/
const wchar_t *cat(const wchar_t *value);
/**
Concatenates a certain number of characters from the given value onto the end of the string. NULL will be treated as "".
@param value The value to concatenate.
@param len How many characters of value to use.
@ret The new value of the string.
@see cat()
@see prepend()
*/
const wchar_t *catn(const wchar_t *value, size_t len);
/**
Useful for making directory paths and stuff
adds a string plus a separator character.
i.e.
StringW x = "/usr/";
x.catPostSeparator("bin", '/');
creates "/usr/bin/"
*/
const wchar_t *catPostSeparator(const wchar_t *value, const wchar_t separator);
/**
similiar to above, but puts the separator first
i.e.
StringW x = "/usr";
x.catPostSeparator('/' "bin");
creates "/usr/bin"
*/
//const wchar_t *catPreSeparator(const wchar_t separator, const wchar_t *value);
/**
Inserts the given string value at the beginning of the string. NULL will be
treated as "".
@param value The value to insert.
@ret The new value of the string.
@see cat()
@see catn()
*/
const wchar_t *prepend(const wchar_t *value);
// replaces string with n chars of val or length of val, whichever is less.
const wchar_t *ncpy(const wchar_t *newstr, size_t numchars);
/**
Copies up to maxlen chars from the string into the destination. Differs from
STRNCPY in that it makes sure the destination is always nul-terminated, so
note that maxlen includes the terminating nul.
@param dest The destination to copy to.
@param maxlen How many bytes, at most, to copy.
*/
//void strncpyTo(wchar_t *dest, int maxlen);
// -----------------------------------------
// Character based find-n-splice methods --
// "l" and "r" prefixes specify to begin at
// front or back of string:
// Returns index of first found, -1 if not found.
size_t lFindChar(wchar_t findval);
size_t lFindChar(const wchar_t *findval); // a list of chars to search for
//int rFindChar(wchar_t findval);
size_t rFindChar(const wchar_t *findval); // a list of chars to search for
// Splits string at findval. Characters passed by search, including the
// found character, are MOVED to the returned string. If there is no wchar_t
// to be found, the entire string is returned and the called instance is
// left empty. (Makes looped splits very easy).
StringW lSplit(size_t idxval);
//StringW lSplitChar(wchar_t findval);
StringW lSplitChar(const wchar_t *findval);
StringW rSplit(size_t idxval);
//StringW rSplitChar(wchar_t findval);
StringW rSplitChar(const wchar_t *findval);
// Same as split, except the find wchar_t is cut completely.
//StringW lSpliceChar(wchar_t findval);
StringW lSpliceChar(const wchar_t *findval);
//StringW rSpliceChar(wchar_t findval);
StringW rSpliceChar(const wchar_t *findval);
/**
Replaces all occurences of the value specified by 'find' with the value
specified by 'replace'.
@param find The value to find.
@param replace The value to replace with.
@ret The number of replacements that were executed.
*/
int replace(const wchar_t *find, const wchar_t *replace);
/**
Replaces fields of same character with 0-padded text representation of an int.
Example: blah$$$$.png becomes blah0000.png
*/
int replaceNumericField(int value, wchar_t fieldchar = '\x24');
// UTF8-Aware "Character Based" Methods
/**
Returns how many characters are in the string value. Same as len(), but multibyte UTF-8 aware.
@see len()
@ret Number of logical UTF-8 character in the string.
*/
//int numCharacters();
/**
Truncates the length of the string to newlen. If newlen is negative, trims
-newlen characters from the end. Multibyte UTF-8 aware.
@param newlen The new length of the string. If the string is shorter than this, nothing happens. If this value is negative, then the absolute value of newlen is how many characters to trim from the right. I.e. -1 means trim off one character from the end.
@see truncateOnChar()
*/
void trunc(int newlen);
// void trim(const wchar_t *whitespace = " \t\r\n", int left = TRUE, int right = TRUE);
/**
Does a vsprintf. Used the same way as printf(), but with a va_list instead of "...".
@param format The format string to use.
@param args The argument list in va_list format.
@ret The number of characters in the final string.
*/
size_t va_sprintf(const wchar_t *format, va_list args);
/**
Ensures that the string drops any memory it might have allocated.
*/
void purge();
void swap(StringW *); // swaps buffers with another string
void swap(StringW &); // swaps buffers with another string
void own(wchar_t *); // take ownership of a buffer
void AppendPath(const wchar_t *path);
void AppendFolder(const wchar_t *path);
void AddBackslash();
void RemovePath();
void FixSlashes();
protected:
wchar_t * val;
enum { wastage_allowed = 128 };
};
class StringPathCombine : public StringW
{
public:
StringPathCombine(const wchar_t *path, const wchar_t *filename);
};
/**
StringW class with a printf-style constructor. Otherwise identical to StringW.
Also takes some standard types, like int, double, and GUID.
@see GUID
@see StringW
*/
class StringPrintfW : public StringW
{
public:
StringPrintfW(const wchar_t *format = NULL, ...);
StringPrintfW(int value);
StringPrintfW(double value);
StringPrintfW(GUID g);
};
#if defined(NDEBUG) && defined(WASABI_NO_RELEASEMODE_DEBUGSTRINGS)
#define DebugStringW __noop
#else
#define DebugStringW _DebugStringW
#endif
class _DebugStringW : public StringW
{
public:
_DebugStringW(const wchar_t *format = NULL, ...);
_DebugStringW(const StringW &s);
_DebugStringW(const StringW *s);
void debugPrint();
};
#if 0
class StringToLower : public StringW
{
public:
StringToLower(const char *val = NULL) : StringW(val)
{
tolower();
}
};
class StringToUpper : public StringW
{
public:
StringToUpper(const char *val = NULL) : StringW(val)
{
toupper();
}
};
//
// Global operator overrides to allow string to take over for
// the use of standard operators with const char pointers as
// left hand operands.
inline int operator ==(const char *v1, const StringW &v2)
{
return v2.isequal(v1);
}
inline int operator !=(const char *v1, const StringW &v2)
{
return !v2.isequal(v1);
}
inline int operator <(const char *v1, const StringW &v2)
{
return !v2.islessthan(v1);
}
inline int operator >(const char *v1, const StringW &v2)
{
return v2.islessthan(v1);
}
#endif
/**
Compares two strings. Generally used with PtrListSorted<>
@see PtrListSorted
*/
class StringWComparator
{
public:
// comparator for sorting
static int compareItem(StringW *p1, StringW* p2);
// comparator for searching
static int compareAttrib(const wchar_t *attrib, StringW *item);
};
#endif
#endif // __cplusplus