osg::IDString Class Reference
[Base]

#include <OSGIDString.h>

Inheritance diagram for osg::IDString:

List of all members.

Public Types
enum	MemType { COPY, LINK }
typedef std::vector< IDString >	StringVec
typedef std::vector< IDString * >	StringPVec
Public Member Functions
Constructors
	IDString (UInt32 size=0)
	IDString (const Char8 *str, MemType memType=COPY)
	IDString (const IDString &obj, MemType memType=COPY)
Destructors
virtual	~IDString (void)
Access
const Char8 *	str (void) const
bool	isEmpty (void) const
void	set (const Char8 *str, MemType memType=COPY)
void	toUpper (void)
void	toLower (void)
UInt32	getLength (void) const
void	setLength (UInt32 length)
void	tokenize (StringVec &v)
void	tokenize (StringPVec &v)
Assignment
const IDString &	operator= (const IDString &obj)
Comparison
bool	operator== (const IDString &obj) const
bool	operator!= (const IDString &obj) const
bool	operator< (const IDString &obj) const
bool	operator> (const IDString &obj) const
bool	operator>= (const IDString &obj) const
bool	operator<= (const IDString &obj) const
Protected Attributes
Char8 *	_str
MemType	_memType
Friends
std::ostream &	operator<< (std::ostream &os, const IDString &obj)

---

Detailed Description

Definition at line 62 of file OSGIDString.h.

---

Member Typedef Documentation

typedef std::vector<IDString > osg::IDString::StringVec

Definition at line 74 of file OSGIDString.h.

typedef std::vector<IDString *> osg::IDString::StringPVec

Definition at line 75 of file OSGIDString.h.

---

Member Enumeration Documentation

enum osg::IDString::MemType

Enumerator:

COPY
LINK

Definition at line 68 of file OSGIDString.h.

    {
        COPY,
        LINK
    };

---

Constructor & Destructor Documentation

IDString::IDString

(

UInt32

size = 0

)

[explicit]

Definition at line 55 of file OSGIDString.cpp.

References setLength().

Referenced by tokenize().

                              : 
    _str    (NULL), 
    _memType(COPY)
{
    setLength(size);
}

IDString::IDString	(	const Char8 *	str,
		MemType	memType = COPY
	)			[explicit]

Definition at line 62 of file OSGIDString.cpp.

                                                    : 
    _str    (NULL   ), 
    _memType(memType)
{
    set(str, memType);
}

IDString::IDString	(	const IDString &	obj,
		MemType	memType = COPY
	)

Definition at line 69 of file OSGIDString.cpp.

References _str.

                                                       :
    _str    (NULL   ), 
    _memType(memType)
{
    set(obj._str, memType);
}

IDString::~IDString

(

void

)

[virtual]

Definition at line 79 of file OSGIDString.cpp.

References _memType, _str, and COPY.

{
    if(_memType == COPY)
        delete [] _str;
}

---

Member Function Documentation

const Char8 * osg::IDString::str

(

void

)

const [inline]

Definition at line 42 of file OSGIDString.inl.

References _str.

Referenced by osg::FieldContainerType::addDescription(), osg::SharePtrGraphOp::compareFCs(), osg::deepClone(), osg::SimpleStatisticsForeground::draw(), osg::StatElemDescBase::findDescByName(), osg::TypeBase::getCName(), osg::FieldDescription::getCName(), osg::TypeBase::getCParentName(), osg::FieldDescription::getDefaultValue(), osg::FieldDescription::getField(), osg::ImageFileType::getMimeType(), osg::FieldContainerType::initFields(), osg::FieldContainerType::initialize(), osg::FieldContainerType::initParentFields(), osg::operator<<(), osg::IDStringLink::operator=(), osg::StatElemDescBase::print(), osg::RemoteAspect::receiveSync(), and osg::FieldContainerType::registerType().

{
    return _str; 
}

bool osg::IDString::isEmpty

(

void

)

const [inline]

Definition at line 48 of file OSGIDString.inl.

References _str.

Referenced by osg::TypeFactory::registerType().

{
    return (_str != NULL && *_str != '\0') ? false : true; 
}

void IDString::set	(	const Char8 *	str,
		MemType	memType = COPY
	)

Definition at line 88 of file OSGIDString.cpp.

References _memType, _str, and COPY.

Referenced by osg::SceneFileHandler::addSceneFileType(), osg::SceneFileHandler::getFileType(), osg::ImageFileType::ImageFileType(), and osg::SceneFileHandler::subSceneFileType().

{
    if(str == _str)
    {
        // !!! can you change _memType here? I think not. IMHO
        return;
    }

    if(_memType == COPY)
        delete [] _str;

    if(memType == COPY)
    {
        if(str != NULL)
        {
            _str = new Char8[strlen(str) + 1];

            strcpy(_str, str);
        }
        else
        {
            _str = NULL;
        }
    }
    else
    {
        _str = const_cast<Char8 *>(str);
    }

    _memType = memType;
}

void IDString::toUpper

(

void

)

Definition at line 124 of file OSGIDString.cpp.

References _str, and getLength().

{
    UInt32 l = getLength();

    for(UInt32 i = 0; i < l; ++i)
    {
        _str[i] = ::toupper(_str[i]);
    }

}

void IDString::toLower

(

void

)

Definition at line 135 of file OSGIDString.cpp.

References _str, and getLength().

Referenced by osg::SceneFileHandler::addSceneFileType(), osg::SceneFileHandler::getFileType(), and osg::SceneFileHandler::subSceneFileType().

{
    UInt32 l = getLength();

    for(UInt32 i = 0; i < l; ++i)
    {
        _str[i] = ::tolower(_str[i]);
    }

}

UInt32 IDString::getLength

(

void

)

const

Definition at line 150 of file OSGIDString.cpp.

References _str.

Referenced by osg::FieldDescription::isValid(), tokenize(), toLower(), and toUpper().

{
    return (_str != NULL) ? ::strlen(_str) : 0;
}

void IDString::setLength

(

UInt32

length

)

Definition at line 155 of file OSGIDString.cpp.

References _memType, _str, and COPY.

Referenced by IDString().

{
    if(_memType == COPY)
        delete [] _str;

    if(length != 0)
    {
         _str = new Char8[length];
        *_str = 0;
    }
    else
    {
        _str = 0;
    }

    _memType = COPY;
}

void IDString::tokenize

(

StringVec &

v

)

Definition at line 173 of file OSGIDString.cpp.

References _str, getLength(), and IDString().

{
    UInt32 l        = getLength();
    UInt32 oldpos   = 0;
    UInt32 pos      = 0;
    bool   inQuotes = false;
    bool   inToken  = false;

    if(l > 0)
    {
        Char8 *buf = new Char8[l + 1];

        for(pos = 0; pos <= l; ++pos)
        {
            if(!inQuotes)
            {
                if(!inToken)
                {
                    if(_str[pos] == '"')
                    {
                        inQuotes = true;
                        oldpos   = pos + 1;
                    }
                    else if(_str[pos] != ' ')
                    {
                        inToken = true;
                        oldpos  = pos;
                    }
                }
                else if(inToken)
                {
                    if(_str[pos] == '"')
                    {
                        inToken = false;

                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        v.push_back(IDString(buf));

                        inQuotes = true;
                        oldpos   = pos;
                    }
                    else if(_str[pos] == ' ')
                    {
                        inToken = false;

                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        v.push_back(IDString(buf));
                    }
                    else if(pos == l)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        v.push_back(IDString(buf));
                    }
                }
            }
            else if(inQuotes)
            {
                if(_str[pos] == '"')
                {
                    inQuotes = false;

                    if(pos > oldpos)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        v.push_back(IDString(buf));
                    }
                }
                else if(pos == l)
                {
                    if(pos > oldpos)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        v.push_back(IDString(buf));
                    }
                }
            }
        }

        delete [] buf;
    }
}

void IDString::tokenize

(

StringPVec &

v

)

Definition at line 270 of file OSGIDString.cpp.

References _str, getLength(), and IDString().

{
    UInt32 l        = getLength();
    UInt32 oldpos   = 0;
    UInt32 pos      = 0;
    bool   inQuotes = false;
    bool   inToken  = false;

    IDString *pString = NULL;

    if(l > 0)
    {
        Char8 *buf = new Char8[l + 1];

        for(pos = 0; pos <= l; ++pos)
        {
            if(!inQuotes)
            {
                if(!inToken)
                {
                    if(_str[pos] == '"')
                    {
                        inQuotes = true;
                        oldpos   = pos + 1;
                    }
                    else if(_str[pos] != ' ')
                    {
                        inToken = true;
                        oldpos  = pos;
                    }
                }
                else if(inToken)
                {
                    if(_str[pos] == '"')
                    {
                        inToken = false;

                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        pString =  new IDString(buf);

                        v.push_back(pString);

                        inQuotes = true;
                        oldpos   = pos;

                    }
                    else if(_str[pos] == ' ')
                    {
                        inToken = false;

                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        pString =  new IDString(buf);

                        v.push_back(pString);
                    }
                    else if(pos == l)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        pString =  new IDString(buf);

                        v.push_back(pString);
                    }
                }
            }
            else if(inQuotes)
            {
                if(_str[pos] == '"')
                {
                    inQuotes = false;

                    if(pos > oldpos)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        pString =  new IDString(buf);

                        v.push_back(pString);
                    }
                }
                else if(pos == l)
                {
                    if(pos > oldpos)
                    {
                        strncpy(buf, _str + oldpos, pos - oldpos);

                        buf[pos - oldpos] = '\0';

                        pString =  new IDString(buf);

                        v.push_back(pString);
                    }
                }
            }
        }

        delete [] buf;
    }
}

const IDString & osg::IDString::operator=

(

const IDString &

obj

)

[inline]

Definition at line 54 of file OSGIDString.inl.

References _str.

{
    set(obj._str);
    
    return *this;
}

bool osg::IDString::operator==

(

const IDString &

obj

)

const [inline]

Definition at line 62 of file OSGIDString.inl.

References _str.

{
    return ((_str == obj._str) ? 
            1 : 
            (_str != NULL && obj._str != NULL && !::strcmp(_str, obj._str)));
}

bool osg::IDString::operator!=

(

const IDString &

obj

)

const [inline]

Definition at line 70 of file OSGIDString.inl.

{
    return ! (*this == obj);
}

bool osg::IDString::operator<

(

const IDString &

obj

)

const [inline]

Definition at line 76 of file OSGIDString.inl.

References _str.

{
    return (    _str != NULL && 
            obj._str != NULL && 
            (::strcmp(_str, obj._str) < 0));
}

bool osg::IDString::operator>

(

const IDString &

obj

)

const [inline]

Definition at line 84 of file OSGIDString.inl.

{
        return ! (*this < obj) && ! (*this == obj);
}

bool osg::IDString::operator>=

(

const IDString &

obj

)

const [inline]

Definition at line 90 of file OSGIDString.inl.

{
    return ! (*this < obj);
}

bool osg::IDString::operator<=

(

const IDString &

obj

)

const [inline]

Definition at line 96 of file OSGIDString.inl.

{
    return (*this < obj) || (*this == obj);
}

---

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	os,
		const IDString &	obj
	)			[friend]

Definition at line 383 of file OSGIDString.cpp.

{
    return os << (obj.str() ? obj.str() : "0 IDString");
}

---

Member Data Documentation

Char8* osg::IDString::_str [protected]

Definition at line 145 of file OSGIDString.h.

Referenced by getLength(), IDString(), isEmpty(), operator<(), operator=(), operator==(), set(), setLength(), str(), tokenize(), toLower(), toUpper(), and ~IDString().

MemType osg::IDString::_memType [protected]

Definition at line 146 of file OSGIDString.h.

Referenced by set(), setLength(), and ~IDString().

---

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

• OSGIDString.h
• OSGIDString.cpp
• OSGIDString.inl