XMLTag Class Reference

#include <utilxml.h>

Collaboration diagram for XMLTag:

Public Member Functions
const char *	getAttribute (const char *attribName, int partNum=-1, char partSplit= '|') const
const StringList	getAttributeNames () const
int	getAttributePartCount (const char *attribName, char partSplit= '|') const
const char *	getName () const
bool	isEmpty () const
bool	isEndTag (const char *eID=0) const
	operator const char * () const
XMLTag &	operator= (const char *tagString)
XMLTag &	operator= (const XMLTag &other)
const char *	setAttribute (const char *attribName, const char *attribValue, int partNum=-1, char partSplit= '|')
void	setEmpty (bool value)
void	setEndTag (bool value)
void	setText (const char *tagString)
const char *	toString () const
	XMLTag (const char *tagString=0)
	XMLTag (const XMLTag &tag)
	~XMLTag ()

Private Member Functions
const char *	getPart (const char *buf, int partNum=0, char partSplit= '|') const
void	parse () const

Private Attributes
StringPairMap	attributes
char *	buf
bool	empty
bool	endTag
SWBuf	junkBuf
char *	name
bool	parsed

Detailed Description

Simple XML helper class.

Definition at line 38 of file utilxml.h.

Constructor & Destructor Documentation

XMLTag::XMLTag

(

const char *

tagString = 0

)

Definition at line 118 of file utilxml.cpp.

                                    {

    name   = 0;
    buf    = 0;
    setText(tagString);
}

XMLTag::XMLTag

(

const XMLTag &

tag

)

Definition at line 126 of file utilxml.cpp.

                              : attributes(t.attributes)  {
    parsed = t.parsed;
    empty = t.empty;
    endTag = t.endTag;
    if (t.buf) {
        int len = (int)strlen(t.buf);
        buf = new char[len + 1];
        memcpy(buf, t.buf, len + 1);
    }
    if (t.name) {
        int len = (int)strlen(t.name);
        name = new char[len + 1];
        memcpy(name, t.name, len + 1);
    }
}

XMLTag::~XMLTag

(

)

Definition at line 180 of file utilxml.cpp.

                {
    if (buf)
        delete [] buf;
    if (name)
        delete [] name;
}

Member Function Documentation

const char * XMLTag::getAttribute	(	const char *	attribName,
		int	partNum = -1,
		char	partSplit = '|'
	)		const

Definition at line 230 of file utilxml.cpp.

                                                                                          {

    if (!parsed)
        parse();

    StringPairMap::const_iterator it = attributes.find(attribName);

    const char *retVal = 0;
    if (it != attributes.end()) 
        retVal = it->second.c_str();        
        
    if ((retVal) && (partNum > -1))
        retVal = getPart(retVal, partNum, partSplit);

    return retVal;
}

const StringList XMLTag::getAttributeNames

(

)

const

Definition at line 188 of file utilxml.cpp.

                                                 {
    StringList retVal;

    if (!parsed)
        parse();

    for (StringPairMap::const_iterator it = attributes.begin(); it != attributes.end(); it++)
        retVal.push_back(it->first.c_str());

    return retVal;
}

int XMLTag::getAttributePartCount	(	const char *	attribName,
		char	partSplit = '|'
	)		const

Definition at line 218 of file utilxml.cpp.

                                                                              {
    int count;
    const char *buf = getAttribute(attribName);
    for (count = 0; buf; count++) {
        buf = strchr(buf, partSplit);
        if (buf)
            buf++;
    }
    return count;
}

const char* XMLTag::getName ( ) const

inline

Definition at line 58 of file utilxml.h.

{ return (name) ? name : SWBuf::nullStr; }

const char * XMLTag::getPart ( const char *  buf, int  partNum = 0, char  partSplit = '|'  ) const

private

Definition at line 201 of file utilxml.cpp.

                                                                              {
    for (; (buf && partNum); partNum--) {
        buf = strchr(buf, partSplit);
        if (buf)
            buf++;
    }
    if (buf) {
        const char *end = strchr(buf, partSplit);
        junkBuf = buf;
        if (end)
            junkBuf.setSize(end - buf);
        return junkBuf.c_str();
    }
    return 0;
}

bool XMLTag::isEmpty ( ) const

inline

Definition at line 60 of file utilxml.h.

                                {
        if (!parsed)
            parse();

        return empty;
    }

bool XMLTag::isEndTag

(

const char *

eID = 0

)

const

Definition at line 323 of file utilxml.cpp.

                                           {
    if (eID) {
        return (SWBuf(eID) == getAttribute("eID"));
    }
    return endTag;
}

XMLTag::operator const char * ( ) const

inline

Definition at line 94 of file utilxml.h.

{ return toString(); }

XMLTag& XMLTag::operator= ( const char *  tagString )

inline

Definition at line 95 of file utilxml.h.

{ setText(tagString); return *this; }

XMLTag& XMLTag::operator= ( const XMLTag &  other )

inline

Definition at line 96 of file utilxml.h.

{ setText(other.toString()); return *this; }

SWORD_NAMESPACE_START void XMLTag::parse ( ) const

private

Definition at line 32 of file utilxml.cpp.

                         {
    int i;
    int start;
    char *name = 0;
    char *value = 0;
    attributes.clear();
    
    if (!buf)
        return;
    for (i = 0; ((buf[i]) && (!isalpha(buf[i]))); i++);
    for (; buf[i]; i++) {
        if (strchr("\t\r\n ", buf[i])) {
                        // Convert newlines, carriage returns and tabs to spaces
            buf[i] = ' ';

            for (; ((buf[i]) && (!isalpha(buf[i]))); i++);
            if (buf[i]) {       // we have an attribute name
                start = i;
                // Deprecated: check for following whitespacee
                // Should be: for (; (buf[i] && buf[i] != '='; i++);
                for (; ((buf[i]) && (!strchr(" =", buf[i]))); i++);

                if (i-start) {
                    if (name)
                        delete [] name;
                    name = new char [ (i-start) + 1 ];
                    strncpy(name, buf+start, i-start);
                    name[i-start] = 0;
                }

                // The following does not allow for empty attributes
                //for (; ((buf[i]) && (strchr(" =\"\'", buf[i]))); i++);

                // skip space preceding the = sign
                // Deprecated: this is not part of the xml spec
                for (; buf[i] == ' '; i++) ;

                // skip the = sign
                if (buf[i])
                    i++;

                // skip space following the = sign
                // Deprecated: this is not part of the xml spec
                for (; buf[i] == ' '; i++) ;

                // remember and skip the quote sign
                char quoteChar = buf[i];
                if (quoteChar)
                    i++;

                if (buf[i]) {   // we have attribute value
                    start = i;
                    // Skip until matching quote character
                    for (; ((buf[i]) && (buf[i] != quoteChar)); i++);

                    // Allow for empty quotes
                    if (value)
                        delete [] value;
                    value = new char [ (i-start) + 1 ];
                    if (i-start) {
                        strncpy(value, buf+start, i-start);
                    }
                    value[i-start] = 0;
                    attributes[name] = value;
                }
            }
        }

        // if there are no more characters left then quit
        if (!buf[i])
            break;

    }
    for (;i;i--) {
        if (buf[i] == '/')
            empty = true;
        if (!strchr(" \t\r\n>\t", buf[i]))
            break;
    }
        
    parsed = true;
    if (name) delete [] name;
    if (value) delete [] value;
}

const char * XMLTag::setAttribute	(	const char *	attribName,
		const char *	attribValue,
		int	partNum = -1,
		char	partSplit = '|'
	)

Definition at line 248 of file utilxml.cpp.

                                                                                                             {
    if (!parsed)
        parse();

    SWBuf newVal = "";
    // set part of an attribute
    if (partNum > -1) {
        const char *wholeAttr = getAttribute(attribName);
        int attrCount = getAttributePartCount(attribName, partSplit);
        for (int i = 0; i < attrCount; i++) {
            if (i == partNum) {
                if (attribValue) {
                    newVal += attribValue;
                    newVal += partSplit;
                }
                else {
                    // discard this part per null attribValue
                }
            }
            else {
                newVal += getPart(wholeAttr, i, partSplit);
                newVal += partSplit;
            }
        }
        if (newVal.length()) newVal--;  // discard the last partSplit
        attribValue = (!attribValue && !newVal.length()) ? 0 : newVal.c_str();
    }

    // perform the actual set
    if (attribValue)
        attributes[attribName] = attribValue;
    else    attributes.erase(attribName);

    return attribValue;
}

void XMLTag::setEmpty ( bool  value )

inline

Definition at line 66 of file utilxml.h.

                                     {
        if (!parsed)
            parse();
        empty = value;
        if (value)
            endTag = false;
    }

void XMLTag::setEndTag ( bool  value )

inline

Definition at line 79 of file utilxml.h.

                                      {
        if (!parsed)
            parse();
        endTag = value;
        if (value)
            empty = false;
    }

void XMLTag::setText

(

const char *

tagString

)

Definition at line 143 of file utilxml.cpp.

                                          {
    parsed = false;
    empty  = false;
    endTag = false;

    if (buf) {
        delete [] buf;
        buf = 0;
    }

    if (!tagString)     // assert tagString before proceeding
        return;

    stdstr(&buf, tagString);

    int start = 0;
    int i;

    // skip beginning silliness
    for (i = 0; ((tagString[i]) && (!isalpha(tagString[i]))); i++) {
        if (tagString[i] == '/')
            endTag = true;
    }
    start = i;
    for (; ((tagString[i]) && (!strchr("\t\r\n />", tagString[i]))); i++);
    if (i-start) {
        if (name)
            delete [] name;
        name = new char [ (i-start) + 1 ];
        strncpy(name, tagString+start, i-start);
        name[i-start] = 0;
        if (tagString[i] == '/')
            empty = true;
    }
}

const char * XMLTag::toString

(

)

const

Definition at line 285 of file utilxml.cpp.

                                   {
    SWBuf tag = "<";
    if (!parsed)
        parse();

    if (isEndTag())
        tag.append('/');

    tag.append(getName());

    if (!isEndTag()) {
        for (StringPairMap::iterator it = attributes.begin(); it != attributes.end(); it++) {
            //tag.appendFormatted(" %s=\"%s\"", it->first.c_str(), it->second.c_str());
            tag.append(' ');
            tag.append(it->first.c_str());
            tag.append((strchr(it->second.c_str(), '\"')) ? "=\'" : "=\"");
            tag.append(it->second.c_str());
            tag.append((strchr(it->second.c_str(), '\"'))? '\'' : '\"');
        }
    }

    if (isEmpty())
        tag.append('/');

    tag.append('>');


    if (buf)
        delete [] buf;
    buf = new char [ tag.length() + 1 ];
    strcpy(buf, tag.c_str());

    return buf;
}

Member Data Documentation

StringPairMap XMLTag::attributes

mutableprivate

Definition at line 46 of file utilxml.h.

char* XMLTag::buf

mutableprivate

Definition at line 41 of file utilxml.h.

bool XMLTag::empty

mutableprivate

Definition at line 44 of file utilxml.h.

bool XMLTag::endTag

mutableprivate

Definition at line 45 of file utilxml.h.

SWBuf XMLTag::junkBuf

mutableprivate

Definition at line 47 of file utilxml.h.

char* XMLTag::name

private

Definition at line 42 of file utilxml.h.

bool XMLTag::parsed

mutableprivate

Definition at line 43 of file utilxml.h.

---

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

• include/utilxml.h
• src/utilfuns/utilxml.cpp