P3X GitList

6ae0d525

/*******************************************************************************

57456599

* BString.h BString Handling

6ae0d525

* T.Barnaby, BEAM Ltd, 29/10/91

57456599

6ae0d525

******************************************************************************* */ #ifndef BSTRING_H #define BSTRING_H 1

57456599

#include <BTypes.h>

6ae0d525

#include <BRefData.h> #include <BList.h>

57456599

#include <BArray.h>

6ae0d525

#include <iostream>

57456599

class BError;

6ae0d525

class BString { public: BString(); BString(const BString& string); BString(const char* str);

57456599

BString(const char* str, unsigned int len);

6ae0d525

BString(char ch);

57456599

BString(BInt v); BString(BUInt v); BString(BUInt64 v);

6ae0d525

BString(double v);

57456599

~BString();

6ae0d525

static BString convert(char ch); ///< Converts char to string

57456599

static BString convert(BInt value); ///< Converts int to string static BString convert(BUInt value); ///< Converts uint to string static BString convert(double value, int eFormat = 0); ///< Converts double to string static BString convert(BUInt64 value); ///< Converts long long to string static BString convertHex(BInt value); ///< Converts int to string as hex value static BString convertHex(BUInt value); ///< Converts uint to string as hex value BString copy() const; ///< Return an independant copy

6ae0d525

int len() const; ///< Length of string const char* retStr() const; ///< Ptr to char* representation char* retStrDup() const; ///< Ptr to newly malloc'd char* int retInt() const; ///< Return string as a int

57456599

unsigned int retUInt() const; ///< Return string as a int

6ae0d525

double retDouble() const; ///< Return string as a double

57456599

6ae0d525

int compare(const BString& string) const; ///< Compare strings int compareWild(const BString& string) const; ///< Compare string to string with wildcards int compareWildExpression(const BString& string) const; ///< Compare string to space deliminated patterns

57456599

int compareRegex(const BString& pattern, int ignoreCase = 0) const; ///< Compare strings

6ae0d525

BString& truncate(int len); ///< Truncate to length len BString& pad(int len); ///< Pad to length len

57456599

void clear(); ///< Clear the string

6ae0d525

BString& toUpper(); ///< Convert to uppercase BString& toLower(); ///< Convert to lowercase

57456599

BString lowerFirst(); ///< Return string with lowercase first character

6ae0d525

void removeNL(); ///< Remove if present NL from last char

57456599

BString justify(int leftMargin, int width); ///< Justify the string to the given width BString fixedLen(int length, int rightJustify = 0); ///< return string formated to fixed length BString firstLine(); ///< Return first line BString translateChar(char ch, BString replace = " "); ///< Translate character converting them to the given string BString reverse() const; ///< Reverse character order

6ae0d525

BString subString(int start, int len) const; ///< Returns substring int del(int start, int len); ///< Delete substring int insert(int start, BString str); ///< Insert substring

57456599

int append(const BString& str); ///< Append a string BString add(const BString& str) const; ///< Add strings returning result BString& printf(const char* fmt, ...) ; ///< Formated print into the string

6ae0d525

int find(char ch) const; ///< Find ch in string searching forwards

57456599

int find(BString str) const; ///< Find string in string searching forwards

6ae0d525

int findReverse(char ch) const; ///< Find ch in string searching backwards

57456599

BString csvEncode() const; ///< Encode a string for CSV BString& csvDecode(const BString str); ///< Decode a string from CSV BString base64Encode() const; ///< Encode a string to base64 BError base64Decode(BString& str) const; ///< Decode a string from base64

6ae0d525

BList<BString> getTokenList(BString separators); ///< Break string into tokens

57456599

BList<BString> getTokenList(char separator); ///< Break string into tokens

6ae0d525

BString removeSeparators(BString separators); ///< Remove any char from sepatators from string BString pullToken(BString terminators); ///< Pull token from start of string BString pullSeparators(BString separators); ///< Pull separators from start of string BString pullWord(); ///< Pull a word out of the head of the string BString pullLine(); ///< Pull a line out of the head of the string

57456599

BList<BString> split(char splitChar); ///< Split string into an array based on the character separator

6ae0d525

57456599

// Filename operations BString dirname(); BString basename(); BString extension(); // Misc functions BUInt32 hash() const; char& get(int pos); const char& get(int pos) const;

6ae0d525

/* Operator functions */ BString& operator=(const BString& string); char& operator[](int pos); int operator==(const BString& s) const{ return (compare(s) == 0); } int operator==(const char* s) const{ return (compare(s) == 0); } int operator>(const BString& s) const{ return (compare(s) > 0); } int operator>(const char* s) const{ return (compare(s) > 0); } int operator<(const BString& s) const{ return (compare(s) < 0); } int operator<(const char* s) const{ return (compare(s) < 0); } int operator>=(const BString& s) const{ return (compare(s) >= 0); } int operator<=(const BString& s) const{ return (compare(s) <= 0); } int operator!=(const BString& s) const{ return (compare(s) != 0); } int operator!=(const char* s) const{ return (compare(s) != 0); } BString operator+(const BString& s) const { return add(s); } BString operator+(const char* s) const { return add(s); } BString operator+=(const BString& s){ *this = add(s); return *this; } BString operator+=(const char* s){ *this = add(s); return *this; } /* Special operators */ BString operator+(char ch) const { return add(convert(ch)); }

57456599

BString operator+(BInt i) const {

6ae0d525

return add(convert(i)); }

57456599

BString operator+(BUInt i) const {

6ae0d525

return add(convert(i)); }

57456599

BString operator+(BUInt64 i) const {

6ae0d525

return add(convert(i)); } operator const char* () const { return retStr(); }

57456599

#ifdef QSTRING_H // QT support BString(const QString& str){ #if QT_VERSION >= 0x040000 init(str.toAscii()); #else init(str); #endif } #ifndef ZAP operator QString (){ // QString support return QString(retStr()); } #endif #endif // For compatibility BString field(int field) const; char** fields();

6ae0d525

protected: BRefData* ostr; private:

57456599

void init(const char* str);

6ae0d525

int inString(int pos) const; int isSpace(char ch) const; }; /* OStream Functions */ std::ostream& operator<<(std::ostream& o, BString& s); std::istream& operator>>(std::istream& i, BString& s); #ifdef BLIST_H typedef BList<BString> BStringList;

57456599

typedef BArray<BString> BStringArray; int bstringListinList(BStringList& l, BString s); BString blistToString(const BStringList& list); ///< Convert a string list to a comma separated string BStringList bstringToList(BString str, int stripSpaces = 0); ///< Convert a comma separated string to a string list BStringList charToList(const char** str); BString barrayToString(const BStringArray& list); ///< Convert a string array to a comma separated string BStringArray bstringToArray(BString str, int stripSpaces = 0); ///< Convert a comma separated string to a string array BStringArray charToArray(const char** str);

6ae0d525

#endif

57456599

// String conversion functions void toBString(BString& v, BString& s); void toBString(BStringList& v, BString& s); void toBString(BInt32& v, BString& s); void toBString(BUInt32& v, BString& s); void toBString(BUInt64& v, BString& s); void toBString(BFloat64& v, BString& s); void fromBString(BString& s, BString& v); void fromBString(BString& s, BStringList& v); void fromBString(BString& s, BInt32& v); void fromBString(BString& s, BUInt32& v); void fromBString(BString& s, BUInt64& v); void fromBString(BString& s, BFloat64& v);

6ae0d525

#endif