OSISOSIS Class Reference

#include <osisosis.h>

Inheritance diagram for OSISOSIS:

Collaboration diagram for OSISOSIS:

Classes
class	MyUserData

Public Member Functions
virtual const char *	getHeader () const
	OSISOSIS ()

Protected Member Functions
void	addAllowedEscapeString (const char *findString)
void	addEscapeStringSubstitute (const char *findString, const char *replaceString)
void	addTokenSubstitute (const char *findString, const char *replaceString)
void	appendEscapeString (SWBuf &buf, const char *escString)
virtual BasicFilterUserData *	createUserData (const SWModule *module, const SWKey *key)
virtual bool	handleEscapeString (SWBuf &buf, const char *escString, BasicFilterUserData *userData)
virtual bool	handleNumericEscapeString (SWBuf &buf, const char *escString)
virtual bool	handleToken (SWBuf &buf, const char *token, BasicFilterUserData *userData)
bool	passAllowedEscapeString (SWBuf &buf, const char *escString)
virtual bool	processStage (char, SWBuf &, char *&, BasicFilterUserData *)
virtual char	processText (SWBuf &text, const SWKey *key, const SWModule *module)
void	removeAllowedEscapeString (const char *findString)
void	removeEscapeStringSubstitute (const char *findString)
void	removeTokenSubstitute (const char *findString)
void	setEscapeEnd (const char *escEnd)
void	setEscapeStart (const char *escStart)
void	setEscapeStringCaseSensitive (bool val)
void	setPassThruNumericEscapeString (bool val)
void	setPassThruUnknownEscapeString (bool val)
void	setPassThruUnknownToken (bool val)
virtual void	setStageProcessing (char stages)
void	setTokenCaseSensitive (bool val)
void	setTokenEnd (const char *tokenEnd)
void	setTokenStart (const char *tokenStart)
bool	substituteEscapeString (SWBuf &buf, const char *escString)
bool	substituteToken (SWBuf &buf, const char *token)

Static Protected Attributes
static const char	FINALIZE = 8
static const char	INITIALIZE = 1
static const char	POSTCHAR = 4
static const char	PRECHAR = 2

Detailed Description

this filter converts internal OSIS text to public OSIS text

Definition at line 34 of file osisosis.h.

Constructor & Destructor Documentation

OSISOSIS::OSISOSIS

(

)

Definition at line 37 of file osisosis.cpp.

                   {
    setTokenStart("<");
    setTokenEnd(">");

    setEscapeStart("&");
    setEscapeEnd(";");

    setEscapeStringCaseSensitive(true);
    setPassThruNumericEscapeString(true);

    addAllowedEscapeString("quot");
    addAllowedEscapeString("apos");
    addAllowedEscapeString("amp");
    addAllowedEscapeString("lt");
    addAllowedEscapeString("gt");

    setTokenCaseSensitive(true);
}

Member Function Documentation

void SWBasicFilter::addAllowedEscapeString ( const char *  findString )

protectedinherited

Registers an esc control sequence that can pass unchanged

Definition at line 156 of file swbasicfilter.cpp.

                                                                 {
    char *buf = 0;

    if (!escStringCaseSensitive) {
        stdstr(&buf, findString);
        toupperstr(buf);
        p->escPassSet.insert(StringSet::value_type(buf));
        delete [] buf;
    }
    else p->escPassSet.insert(StringSet::value_type(findString));
}

void SWBasicFilter::addEscapeStringSubstitute ( const char *  findString, const char *  replaceString  )

protectedinherited

Registers an esc control sequence

Definition at line 176 of file swbasicfilter.cpp.

                                                                                               {
    char *buf = 0;

    if (!escStringCaseSensitive) {
        stdstr(&buf, findString);
        toupperstr(buf);
        p->escSubMap.insert(DualStringMap::value_type(buf, replaceString));
        delete [] buf;
    }
    else p->escSubMap.insert(DualStringMap::value_type(findString, replaceString));
}

void SWBasicFilter::addTokenSubstitute ( const char *  findString, const char *  replaceString  )

protectedinherited

Registers a simple token substitutions. Usually called from the c-tor of a subclass

Definition at line 136 of file swbasicfilter.cpp.

                                                                                        {
    char *buf = 0;

    if (!tokenCaseSensitive) {
        stdstr(&buf, findString);
        toupperstr(buf);
        p->tokenSubMap[buf] = replaceString;
        delete [] buf;
    }
    else p->tokenSubMap[findString] = replaceString;
}

void SWBasicFilter::appendEscapeString ( SWBuf &  buf, const char *  escString  )

protectedinherited

This appends escString to buf as an entity

Definition at line 216 of file swbasicfilter.cpp.

                                                                        {
    buf += escStart;
    buf += escString;
    buf += escEnd;
}

virtual BasicFilterUserData* OSISOSIS::createUserData ( const SWModule *  module, const SWKey *  key  )

inlineprotectedvirtual

Reimplemented from SWBasicFilter.

Definition at line 47 of file osisosis.h.

                                                                                          {
        return new MyUserData(module, key);
    }

virtual const char* SWFilter::getHeader ( ) const

inlinevirtualinherited

This method can supply a header associated with the processing done with this filter. A typical example is a suggested CSS style block for classed containers.

Reimplemented in OSISLaTeX, OSISXHTML, ThMLLaTeX, ThMLXHTML, TEIXHTML, GBFLaTeX, and GBFXHTML.

Definition at line 62 of file swfilter.h.

{ return ""; }

bool SWBasicFilter::handleEscapeString ( SWBuf &  buf, const char *  escString, BasicFilterUserData *  userData  )

protectedvirtualinherited

This function is called for every escape sequence encountered in the input text.

Parameters

buf	the output buffer
escString	the escape sequence (e.g. "amp" for &)
userData	user storage space for data transient to 1 full buffer parse

Returns

false if was not handled and should be handled in

subclasses should return true if they handled the esc seq, or false if they did not.

Definition at line 286 of file swbasicfilter.cpp.

                                                                                                       {
    return substituteEscapeString(buf, escString);
}

bool SWBasicFilter::handleNumericEscapeString ( SWBuf &  buf, const char *  escString  )

protectedvirtualinherited

This function is called for all numeric escape sequences. If passThrough

Parameters

buf	the output buffer
escString	the escape sequence (e.g. "#235" for &235;)

Returns

subclasses should return true if they handled the esc seq, or false if they did not.

Definition at line 244 of file swbasicfilter.cpp.

                                                                               {
    if (passThruNumericEsc) {
        appendEscapeString(buf, escString);
        return true;
    }
    return false;
}

bool OSISOSIS::handleToken ( SWBuf &  buf, const char *  token, BasicFilterUserData *  userData  )

protectedvirtual

This function is called for every token encountered in the input text.

Parameters

buf	the output buffer
token	the token (e.g. "p align='left'"
userData	user storage space for data transient to 1 full buffer parse

Returns

subclasses should return true if they handled the token, or false if they did not.

Reimplemented from SWBasicFilter.

Definition at line 95 of file osisosis.cpp.

                                                                                       {
  // manually process if it wasn't a simple substitution
    if (!substituteToken(buf, token)) {
        MyUserData *u = (MyUserData *)userData;
        XMLTag tag(token);

        if (!tag.isEmpty() && (!tag.isEndTag()))
            u->startTag = tag;

        // <w> tag
        if (!strcmp(tag.getName(), "w")) {

            // start <w> tag
            if ((!tag.isEmpty()) && (!tag.isEndTag())) {
                SWBuf attr = tag.getAttribute("lemma");
                if (attr.length()) {
                    if (!strncmp(attr.c_str(), "x-Strongs:", 10)) {
                        memcpy(attr.getRawData()+3, "strong", 6);
                        attr << 3;
                        tag.setAttribute("lemma", attr);
                    }
                }
                attr = tag.getAttribute("morph");
                if (attr.length()) {
                    if (!strncmp(attr.c_str(), "x-StrongsMorph:", 15)) {
                        memcpy(attr.getRawData()+3, "strong", 6);
                        attr << 3;
                        tag.setAttribute("lemma", attr);
                    }
                    if (!strncmp(attr.c_str(), "x-Robinson:", 11)) {
                        attr[2] = 'r';
                        attr << 2;
                        tag.setAttribute("lemma", attr);
                    }
                }
                tag.setAttribute("wn", 0);
                tag.setAttribute("savlm", 0);
                tag.setAttribute("splitID", 0);
            }
            buf += tag;
        }

        // <note> tag
        else if (!strcmp(tag.getName(), "note")) {
            if (!tag.isEndTag()) {
                SWBuf type = tag.getAttribute("type");
                                                                                                                
                bool strongsMarkup = (type == "x-strongsMarkup" || type == "strongsMarkup");    // the latter is deprecated
                if (strongsMarkup) {
                    tag.setEmpty(false);    // handle bug in KJV2003 module where some note open tags were <note ... />
                }
                
                if (!tag.isEmpty()) {
                    tag.setAttribute("swordFootnote", 0);

                    if (!strongsMarkup) {
                        buf += tag;
                    }
                    else u->suspendTextPassThru = true;
                }
                
                if (u->module) {
                                        XMLTag tag = token; 
                                        SWBuf swordFootnote = tag.getAttribute("swordFootnote");
                                        SWBuf footnoteBody = u->module->getEntryAttributes()["Footnote"][swordFootnote]["body"];
                                        buf.append(u->module->renderText(footnoteBody));
                                }
            }
            if (tag.isEndTag()) {
                if (u->suspendTextPassThru == false)
                    buf+=tag;
                else u->suspendTextPassThru = false;
            }
        }

        else {
             return false;  // we still didn't handle token
        }
    }
    return true;
}

bool SWBasicFilter::passAllowedEscapeString ( SWBuf &  buf, const char *  escString  )

protectedinherited

This passes allowed escapeStrings

Definition at line 223 of file swbasicfilter.cpp.

                                                                             {
    StringSet::iterator it;

    if (!escStringCaseSensitive) {
            char *tmp = 0;
        stdstr(&tmp, escString);
        toupperstr(tmp);
        it = p->escPassSet.find(tmp);
        delete [] tmp;
    } else 
        it = p->escPassSet.find(escString);

    if (it != p->escPassSet.end()) {
        appendEscapeString(buf, escString);
        return true;
    }

    return false;
}

virtual bool SWBasicFilter::processStage ( char  , SWBuf &  , char *&  , BasicFilterUserData *    )

inlineprotectedvirtualinherited

Reimplemented in OSISPlain.

Definition at line 185 of file swbasicfilter.h.

{ return false; }

char OSISOSIS::processText ( SWBuf &  text, const SWKey *  key, const SWModule *  module  )

protectedvirtual

This method processes and appropriately modifies the text given it for a particular filter task

Parameters

text	The text to be filtered/converted
key	Current key That was used.
module	Current module.

Returns

0

Reimplemented from SWBasicFilter.

Definition at line 57 of file osisosis.cpp.

                                                                                { 
    char status = SWBasicFilter::processText(text, key, module);
    const VerseKey *vkey = SWDYNAMIC_CAST(const VerseKey, key);
    if (vkey) {
        if (vkey->getVerse()) {
            VerseKey *tmp = (VerseKey *)vkey->clone();
            *tmp = *vkey;
            tmp->setAutoNormalize(false);
            tmp->setIntros(true);

            *tmp = MAXVERSE;
            if (*vkey == *tmp) {
                tmp->setVerse(0);
//              sprintf(ref, "\t</div>");
//              pushString(&to, ref);
                *tmp = MAXCHAPTER;
                *tmp = MAXVERSE;
                if (*vkey == *tmp) {
                    tmp->setChapter(0);
                    tmp->setVerse(0);
//                  sprintf(ref, "\t</div>");
//                  pushString(&to, ref);
                }
            }
                        delete tmp;
        }

//
//          else if (vkey->Chapter()) {
//              sprintf(ref, "\t<div type=\"chapter\" osisID=\"%s\">", vkey->getOSISRef());
//          }
//          else sprintf(ref, "\t<div type=\"book\" osisID=\"%s\">", vkey->getOSISRef());
//
        
    }
    return status;
}

void SWBasicFilter::removeAllowedEscapeString ( const char *  findString )

protectedinherited

Unregisters an esc control sequence that can pass unchanged

Definition at line 169 of file swbasicfilter.cpp.

                                                                    {
    if (p->escPassSet.find(findString) != p->escPassSet.end()) {
        p->escPassSet.erase( p->escPassSet.find(findString) );
    }
}

void SWBasicFilter::removeEscapeStringSubstitute ( const char *  findString )

protectedinherited

Unregisters an esc control sequence

Definition at line 189 of file swbasicfilter.cpp.

                                                                       {
    if (p->escSubMap.find(findString) != p->escSubMap.end()) {
        p->escSubMap.erase( p->escSubMap.find(findString) );
    }
}

void SWBasicFilter::removeTokenSubstitute ( const char *  findString )

protectedinherited

Unregisters a simple token substitute

Definition at line 149 of file swbasicfilter.cpp.

                                                                {
    if (p->tokenSubMap.find(findString) != p->tokenSubMap.end()) {
        p->tokenSubMap.erase( p->tokenSubMap.find(findString) );
    }
}

void SWBasicFilter::setEscapeEnd ( const char *  escEnd )

protectedinherited

Sets the end of escape sequence (by default ";").

Definition at line 297 of file swbasicfilter.cpp.

                                                   {
    stdstr(&(this->escEnd), escEnd);
    escEndLen   = strlen(escEnd);
}

void SWBasicFilter::setEscapeStart ( const char *  escStart )

protectedinherited

Sets the beginning of escape sequence (by default "&").

Definition at line 291 of file swbasicfilter.cpp.

                                                       {
    stdstr(&(this->escStart), escStart);
    escStartLen = strlen(escStart);
}

void SWBasicFilter::setEscapeStringCaseSensitive ( bool  val )

protectedinherited

Are escapeStrings case sensitive or not? Call this function before addEscapeStingSubstitute()

Definition at line 131 of file swbasicfilter.cpp.

                                                         {
    escStringCaseSensitive = val;
}

void SWBasicFilter::setPassThruNumericEscapeString ( bool  val )

protectedinherited

Sets whether to pass thru a numeric escape sequence unchanged or allow it to be handled otherwise. Default is false.

Definition at line 121 of file swbasicfilter.cpp.

                                                           {
    passThruUnknownEsc = val;
}

void SWBasicFilter::setPassThruUnknownEscapeString ( bool  val )

protectedinherited

Sets whether to pass thru an unknown escape sequence unchanged or just remove it. Default is false.

Definition at line 116 of file swbasicfilter.cpp.

                                                           {
    passThruUnknownEsc = val;
}

void SWBasicFilter::setPassThruUnknownToken ( bool  val )

protectedinherited

Sets whether to pass thru an unknown token unchanged or just remove it. Default is false.

Definition at line 111 of file swbasicfilter.cpp.

                                                    {
    passThruUnknownToken = val;
}

virtual void SWBasicFilter::setStageProcessing ( char  stages )

inlineprotectedvirtualinherited

Definition at line 186 of file swbasicfilter.h.

{ processStages = stages; } // see STATICs up above

void SWBasicFilter::setTokenCaseSensitive ( bool  val )

protectedinherited

Are tokens case sensitive (like in GBF) or not? Call this function before addTokenSubstitute()

Definition at line 126 of file swbasicfilter.cpp.

                                                  {
    tokenCaseSensitive = val;
}

void SWBasicFilter::setTokenEnd ( const char *  tokenEnd )

protectedinherited

Sets the end of token start sequence (by default ">").

Definition at line 309 of file swbasicfilter.cpp.

                                                    {
    stdstr(&(this->tokenEnd), tokenEnd);
    tokenEndLen   = strlen(tokenEnd);
}

void SWBasicFilter::setTokenStart ( const char *  tokenStart )

protectedinherited

Sets the beginning of token start sequence (by default "<").

Definition at line 303 of file swbasicfilter.cpp.

                                                        {
    stdstr(&(this->tokenStart), tokenStart);
    tokenStartLen = strlen(tokenStart);
}

bool SWBasicFilter::substituteEscapeString ( SWBuf &  buf, const char *  escString  )

protectedinherited

This function performs the substitution of escapeStrings

Definition at line 253 of file swbasicfilter.cpp.

                                                                            {
    DualStringMap::iterator it;

    if (*escString == '#') {
        return handleNumericEscapeString(buf, escString);
    }

    if (passAllowedEscapeString(buf, escString)) {
        return true;
    }

    if (!escStringCaseSensitive) {
            char *tmp = 0;
        stdstr(&tmp, escString);
        toupperstr(tmp);
        it = p->escSubMap.find(tmp);
        delete [] tmp;
    } else 
    it = p->escSubMap.find(escString);

    if (it != p->escSubMap.end()) {
        buf += it->second.c_str();
        return true;
    }
    return false;
}

bool SWBasicFilter::substituteToken ( SWBuf &  buf, const char *  token  )

protectedinherited

This function performs the substitution of tokens

Definition at line 196 of file swbasicfilter.cpp.

                                                                 {
    DualStringMap::iterator it;

    if (!tokenCaseSensitive) {
            char *tmp = 0;
        stdstr(&tmp, token);
        toupperstr(tmp);
        it = p->tokenSubMap.find(tmp);
        delete [] tmp;
    } else
    it = p->tokenSubMap.find(token);

    if (it != p->tokenSubMap.end()) {
        buf += it->second.c_str();
        return true;
    }
    return false;
}

Member Data Documentation

const char SWBasicFilter::FINALIZE = 8

staticprotectedinherited

Definition at line 99 of file swbasicfilter.h.

const char SWBasicFilter::INITIALIZE = 1

staticprotectedinherited

Definition at line 96 of file swbasicfilter.h.

const char SWBasicFilter::POSTCHAR = 4

staticprotectedinherited

Definition at line 98 of file swbasicfilter.h.

const char SWBasicFilter::PRECHAR = 2

staticprotectedinherited

Definition at line 97 of file swbasicfilter.h.

---

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

• include/osisosis.h
• src/modules/filters/osisosis.cpp