Method Encode

src/core/displayencoder.cpp:613–650

//////////////////////////////////////////////////////////////////////////////

void cEncoder::Encode(TSTRING& strIn) const
{
    // TODO:BAM -- reserve space for strOut as an optimization?
    TSTRING strOut; // encoded string we will build up

    TSTRING::const_iterator       cur   = strIn.begin(); // pointer to working position in strIn
    const TSTRING::const_iterator end   = strIn.end();   // end of strIn
    TSTRING::const_iterator       first = end;           // identifies beginning of current character
    TSTRING::const_iterator       last  = end;           // identifies end of current character

    // while get next char (updates cur)
    while (cCharUtil::PopNextChar(cur, end, first, last))
    {
        bool                      fCharEncoded = false; // answers: did char need encoding?
        sack_type::const_iterator atE;

        // for all encoders
        for (atE = m_encodings.begin(); atE != m_encodings.end(); atE++)
        {
            // does char need encoding?
            if ((*atE)->NeedsEncoding(first, last))
            {
                strOut += Encode(first, last, atE);
                fCharEncoded = true;
                break; // each char should only fail at most one
                       // encoding test, so it should be cool to quit
            }
        }

        if (!fCharEncoded)
        {
            strOut.append(first, last); // simply add current char to output since it needed no encoding
        }
    }

    // pass back encoded string
    strIn = strOut;
}

TSTRING
cEncoder::Encode(TSTRING::const_iterator first, TSTRING::const_iterator last, sack_type::const_iterator encoding) const