OGRE  1.7
Object-Oriented Graphics Rendering Engine
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Ogre::StringUtil Class Reference

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 bool match (const String &str, const String &pattern, bool caseSensitive=true)
 Simple pattern-matching routine allowing a wildcard pattern. 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 vector< String >::type split (const String &str, const String &delims="\t\n ", unsigned int maxSplits=0)
 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 vector< String >::type 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) delimeters in the tokenised string. More...
 
static void toLowerCase (String &str)
 Lower-cases all the characters in the string. 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
 Constant blank string, useful for returning by ref where local does not exist. More...
 

Detailed Description

Utility class for manipulating Strings.

Definition at line 74 of file OgreString.h.

Member Typedef Documentation

Definition at line 77 of file OgreString.h.

Member Function Documentation

static bool Ogre::StringUtil::endsWith ( const String str,
const String pattern,
bool  lowerCase = true 
)
static

Returns whether the string ends with the pattern passed in.

Parameters
patternThe pattern to compare with.
lowerCaseIf true, the end of the string will be lower cased before comparison, pattern should also be in lower case.
static bool Ogre::StringUtil::match ( const String str,
const String pattern,
bool  caseSensitive = true 
)
static

Simple pattern-matching routine allowing a wildcard pattern.

Parameters
strString to test
patternPattern to match against; can include simple '*' wildcards
caseSensitiveWhether the match is case sensitive or not
static const String Ogre::StringUtil::replaceAll ( const String source,
const String replaceWhat,
const String replaceWithWhat 
)
static

replace all instances of a sub-string with a another sub-string.

Parameters
sourceSource string
replaceWhatSub-string to find and replace
replaceWithWhatSub-string to replace with (the new sub-string)
Returns
An updated string with the sub-string replaced
static vector<String>::type Ogre::StringUtil::split ( const String str,
const String delims = "\t\n ",
unsigned int  maxSplits = 0 
)
static

Returns a StringVector that contains all the substrings delimited by the characters in the passed delims argument.

Parameters
delimsA list of delimiter characters to split by
maxSplitsThe 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.

Referenced by Ogre::DriverVersion::fromString().

static void Ogre::StringUtil::splitBaseFilename ( const Ogre::String fullName,
Ogre::String outBasename,
Ogre::String outExtention 
)
static

Method for splitting a filename into the base name and extension.

static void Ogre::StringUtil::splitFilename ( const String qualifiedName,
String outBasename,
String outPath 
)
static

Method for splitting a fully qualified filename into the base name and path.

Remarks
Path is standardised as in standardisePath
static void Ogre::StringUtil::splitFullFilename ( const Ogre::String qualifiedName,
Ogre::String outBasename,
Ogre::String outExtention,
Ogre::String outPath 
)
static

Method for splitting a fully qualified filename into the base name, extension and path.

Remarks
Path is standardised as in standardisePath
static String Ogre::StringUtil::standardisePath ( const String init)
static

Method for standardising paths - use forward slashes only, end with slash.

static bool Ogre::StringUtil::startsWith ( const String str,
const String pattern,
bool  lowerCase = true 
)
static

Returns whether the string begins with the pattern passed in.

Parameters
patternThe pattern to compare with.
lowerCaseIf true, the start of the string will be lower cased before comparison, pattern should also be in lower case.
static vector<String>::type Ogre::StringUtil::tokenise ( const String str,
const String delims = "\t\n ",
const String doubleDelims = "\"",
unsigned int  maxSplits = 0 
)
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) delimeters in the tokenised string.

For example, "strings like this".

Parameters
delimsA list of delimiter characters to split by
delimsA list of double delimeters characters to tokenise by
maxSplitsThe 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 void Ogre::StringUtil::toLowerCase ( String str)
static

Lower-cases all the characters in the string.

static void Ogre::StringUtil::toUpperCase ( String str)
static

Upper-cases all the characters in the string.

static void Ogre::StringUtil::trim ( String str,
bool  left = true,
bool  right = true 
)
static

Removes any whitespace characters, be it standard space or TABs and so on.

Remarks
The user may specify wether they want to trim only the beginning or the end of the String ( the default action is to trim both).

Member Data Documentation

const String Ogre::StringUtil::BLANK
static

Constant blank string, useful for returning by ref where local does not exist.

Definition at line 180 of file OgreString.h.

Referenced by Ogre::AnimableObject::getAnimableDictionaryName(), and Ogre::Log::Stream::operator<<().


The documentation for this class was generated from the following file: