OGRE
14.3
Object-Oriented Graphics Rendering Engine
|
Utility class for manipulating Strings. More...
#include <OgreString.h>
Public Types | |
typedef StringStream | StrStreamType |
Static Public Member Functions | |
static bool | endsWith (const String &str, const String &pattern, bool lowerCase=true) |
Returns whether the string ends with the pattern passed in. More... | |
static String | format (const char *fmt,...) |
create a string from a printf expression More... | |
static bool | match (const String &str, const String &pattern, bool caseSensitive=true) |
Simple pattern-matching routine allowing a wildcard pattern. More... | |
static String | normalizeFilePath (const String &init, bool makeLowerCase=false) |
Returns a normalized version of a file path This method can be used to make file path strings which point to the same directory but have different texts to be normalized to the same text. More... | |
static const String | replaceAll (const String &source, const String &replaceWhat, const String &replaceWithWhat) |
Replace all instances of a sub-string with a another sub-string. More... | |
static std::vector< String > | split (const String &str, const String &delims="\t\n ", unsigned int maxSplits=0, bool preserveDelims=false) |
Returns a StringVector that contains all the substrings delimited by the characters in the passed delims argument. More... | |
static void | splitBaseFilename (const Ogre::String &fullName, Ogre::String &outBasename, Ogre::String &outExtention) |
Method for splitting a filename into the base name and extension. More... | |
static void | splitFilename (const String &qualifiedName, String &outBasename, String &outPath) |
Method for splitting a fully qualified filename into the base name and path. More... | |
static void | splitFullFilename (const Ogre::String &qualifiedName, Ogre::String &outBasename, Ogre::String &outExtention, Ogre::String &outPath) |
Method for splitting a fully qualified filename into the base name, extension and path. More... | |
static String | standardisePath (const String &init) |
Method for standardising paths - use forward slashes only, end with slash. More... | |
static bool | startsWith (const String &str, const String &pattern, bool lowerCase=true) |
Returns whether the string begins with the pattern passed in. More... | |
static std::vector< String > | tokenise (const String &str, const String &delims="\t\n ", const String &doubleDelims="\"", unsigned int maxSplits=0) |
Returns a StringVector that contains all the substrings delimited by the characters in the passed delims argument, or in the doubleDelims argument, which is used to include (normal) delimiters in the tokenised string. More... | |
static void | toLowerCase (String &str) |
Lower-cases all the characters in the string. More... | |
static void | toTitleCase (String &str) |
Upper-cases the first letter of each word. More... | |
static void | toUpperCase (String &str) |
Upper-cases all the characters in the string. More... | |
static void | trim (String &str, bool left=true, bool right=true) |
Removes any whitespace characters, be it standard space or TABs and so on. More... | |
Static Public Attributes | |
static const String & | BLANK |
Utility class for manipulating Strings.
|
static |
Removes any whitespace characters, be it standard space or TABs and so on.
The user may specify whether they want to trim only the beginning or the end of the String ( the default action is to trim both).
|
static |
Returns a StringVector that contains all the substrings delimited by the characters in the passed delims
argument.
str | |
delims | A list of delimiter characters to split by |
maxSplits | The maximum number of splits to perform (0 for unlimited splits). If this parameters is > 0, the splitting process will stop after this many splits, left to right. |
preserveDelims | Flag to determine if delimiters should be saved as substrings |
Referenced by Ogre::StringConverter::parseStringVector().
|
static |
Returns a StringVector that contains all the substrings delimited by the characters in the passed delims
argument, or in the doubleDelims
argument, which is used to include (normal) delimiters in the tokenised string.
For example, "strings like this".
str | |
delims | A list of delimiter characters to split by |
doubleDelims | A list of double delimiters characters to tokenise by |
maxSplits | The maximum number of splits to perform (0 for unlimited splits). If this parameters is > 0, the splitting process will stop after this many splits, left to right. |
|
static |
Lower-cases all the characters in the string.
|
static |
Upper-cases all the characters in the string.
|
static |
Upper-cases the first letter of each word.
|
static |
Returns whether the string begins with the pattern passed in.
str | |
pattern | The pattern to compare with. |
lowerCase | If true, the start of the string will be lower cased before comparison, pattern should also be in lower case. |
|
static |
Returns whether the string ends with the pattern passed in.
str | |
pattern | The pattern to compare with. |
lowerCase | If true, the end of the string will be lower cased before comparison, pattern should also be in lower case. |
Method for standardising paths - use forward slashes only, end with slash.
|
static |
Returns a normalized version of a file path This method can be used to make file path strings which point to the same directory but have different texts to be normalized to the same text.
The function:
init | The file path to normalize. |
makeLowerCase | If true, transforms all characters in the string to lowercase. |
|
static |
Method for splitting a fully qualified filename into the base name and path.
Path is standardised as in standardisePath
|
static |
Method for splitting a fully qualified filename into the base name, extension and path.
Path is standardised as in standardisePath
|
static |
Method for splitting a filename into the base name and extension.
|
static |
Simple pattern-matching routine allowing a wildcard pattern.
str | String to test |
pattern | Pattern to match against; can include simple '*' wildcards |
caseSensitive | Whether the match is case sensitive or not |
|
static |
Replace all instances of a sub-string with a another sub-string.
source | Source string |
replaceWhat | Sub-string to find and replace |
replaceWithWhat | Sub-string to replace with (the new sub-string) |
|
static |
create a string from a printf expression
Referenced by Ogre::Font::getGlyphInfo().
|
static |