StringMgr Class Reference

#include <stringmgr.h>

Collaboration diagram for StringMgr:

[legend]

List of all members.

Public Member Functions
virtual char *	upperLatin1 (char *text, unsigned int max=0) const
virtual char *	upperUTF8 (char *text, unsigned int max=0) const
Static Public Member Functions
static StringMgr *	getSystemStringMgr ()
static bool	hasUTF8Support ()
static void	setSystemStringMgr (StringMgr *newStringMgr)
Protected Member Functions
	StringMgr (const StringMgr &)
	StringMgr ()
virtual bool	supportsUnicode () const
virtual	~StringMgr ()
Static Private Attributes
static StringMgr *	systemStringMgr = 0
Friends
class	__staticsystemStringMgr

---

Detailed Description

StringMgr is a way to provide UTf8 handling by the Sword frontend Each platform, if it's up-to-date, should provide functions to handle unicode and utf8. This class makes it possible to implement Unicode support on the user-side and not in Sword itself.

Definition at line 36 of file stringmgr.h.

---

Constructor & Destructor Documentation

StringMgr::StringMgr

(

)

[protected]

Default constructor. Protected to make instances on user side impossible, because this is a Singleton

Default constructor

Definition at line 134 of file stringmgr.cpp.

                     {
}

StringMgr::StringMgr

(

const StringMgr &

m

)

[protected]

Copy constructor

Definition at line 139 of file stringmgr.cpp.

                                       {
}

StringMgr::~StringMgr

(

)

[protected, virtual]

Destructor

Definition at line 144 of file stringmgr.cpp.

                      {
}

---

Member Function Documentation

StringMgr * StringMgr::getSystemStringMgr

(

)

[static]

Returns the global StringMgr handle

Returns:

The global string handle

Definition at line 165 of file stringmgr.cpp.

                                         {
    if (!systemStringMgr) {
#ifdef _ICU_
        systemStringMgr = new ICUStringMgr();
//      SWLog::getSystemLog()->logInformation("created default ICUStringMgr");
#else
        systemStringMgr = new StringMgr();
//          SWLog::getSystemLog()->logInformation("created default StringMgr");
#endif
    }
    
    return systemStringMgr;
}

static bool StringMgr::hasUTF8Support

(

)

[inline, static]

Checks whether Utf8 support is available. Override the function supportsUnicode() to tell whether your implementation has utf8 support.

Returns:

True if this implementation provides support for Utf8 handling or false if just latin1 handling is available

Definition at line 53 of file stringmgr.h.

                                        {
        return getSystemStringMgr()->supportsUnicode();
    };

void StringMgr::setSystemStringMgr

(

StringMgr *

newStringMgr

)

[static]

Sets the global StringMgr handle

Parameters:

newStringMgr

The new global StringMgr. This pointer will be deleted by this StringMgr

Definition at line 150 of file stringmgr.cpp.

                                                          {
    if (systemStringMgr) 
        delete systemStringMgr;
    
    systemStringMgr = newStringMgr;

   // TODO: this is magic. apparently we have to reset the system localemgr upon changing stringmgr.
   // setting system stringmgr should be set before localemgr and not possible to change.
   // rework this design.
    LocaleMgr::getSystemLocaleMgr()->setSystemLocaleMgr(new LocaleMgr());
}

bool StringMgr::supportsUnicode

(

)

const [protected, virtual]

Definition at line 235 of file stringmgr.cpp.

                                      {
    return false; //default impl has no UTF8 support
}

char * StringMgr::upperLatin1	(	char *	buf,
		unsigned int	maxlen = 0
	)			const [virtual]

Converts the param to an uppercase latin1 string

Parameters:

	text	The text encoded in latin1 which should be turned into an upper case string
	max	Max buffer size

Returns:

text buffer (only for convenience)

Converts the param to an uppercase latin1 string

Parameters:

The

text encoded in latin1 which should be turned into an upper case string

Definition at line 220 of file stringmgr.cpp.

                                                                 {
    if (!buf)
        return 0;
        
    char *ret = buf;
    bool checkMax = maxlen;

    while (*buf && (!checkMax || maxlen--)) {
        *buf = SW_toupper(*buf);
        buf++;
    }

    return ret;
}

char * StringMgr::upperUTF8	(	char *	t,
		unsigned int	maxlen = 0
	)			const [virtual]

Converts the param to an upper case Utf8 string

Parameters:

	text	The text encoded in utf8 which should be turned into an upper case string
	max	Max buffer size

Returns:

text buffer (only for convenience)

This is a fallback method. It should never be called. If UTF8 support is desired, then a UTF8 StringMgr needs to be used.

Here we just do our best.

Converts the param to an upper case UTF8 string

Parameters:

t

- The text encoded in utf8 which should be turned into an upper case string

Definition at line 191 of file stringmgr.cpp.

                                                             {
    // try to decide if it's worth trying to toupper.  Do we have more
    // characters which are probably lower latin than not?
    // we still don't use isValidUTF8 optimally. what if we have 1 unicode
    // character in the string?  should we not try to upper any of the string?
    // dunno.  Best solution is to upper all other characters. Don't have
    // time to write that before release.
    long performOp = 0;
    if (!isValidUTF8((unsigned char *)t)) {
        performOp = 1;
    }
    else {
        for (const char *ch = t; *ch; ch++) {
            performOp += (*ch > 0) ? 1 : -1;
        }
    }

    if (performOp > 0) {
        return upperLatin1(t);
    }

    return t;
}

---

Friends And Related Function Documentation

friend class __staticsystemStringMgr [friend]

Definition at line 73 of file stringmgr.h.

---

Member Data Documentation

SWORD_NAMESPACE_START StringMgr * StringMgr::systemStringMgr = 0 [static, private]

Definition at line 90 of file stringmgr.h.

---

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

• include/stringmgr.h
• src/mgr/stringmgr.cpp