Files
libreoffice/include/svtools/svparser.hxx
Michael Weghorn 4595dc37e6 fdo#39468 translate German comments
Change-Id: I90deb0877940167c9d5e3ba630528e575af6dd66
Reviewed-on: https://gerrit.libreoffice.org/13459
Reviewed-by: Noel Grandin <noelgrandin@gmail.com>
Tested-by: Noel Grandin <noelgrandin@gmail.com>
2014-12-14 12:05:06 +00:00

272 lines
8.5 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef INCLUDED_SVTOOLS_SVPARSER_HXX
#define INCLUDED_SVTOOLS_SVPARSER_HXX
#include <svtools/svtdllapi.h>
#include <tools/link.hxx>
#include <tools/ref.hxx>
#include <rtl/textenc.h>
#include <rtl/ustring.hxx>
#include <boost/noncopyable.hpp>
#include <vector>
struct SvParser_Impl;
class SvStream;
enum SvParserState
{
SVPAR_ACCEPTED = 0,
SVPAR_NOTSTARTED,
SVPAR_WORKING,
SVPAR_PENDING,
SVPAR_WAITFORDATA,
SVPAR_ERROR
};
class SVT_DLLPUBLIC SvParser : public SvRefBase
{
DECL_STATIC_LINK( SvParser, NewDataRead, void* );
protected:
SvStream& rInput;
OUString aToken; // scanned token
sal_uLong nlLineNr; // current line number
sal_uLong nlLinePos; // current column number
SvParser_Impl *pImplData; // internal data
long nTokenValue; // additional vavlue (RTF)
bool bTokenHasValue; // indicates whether nTokenValue is valid
SvParserState eState; // status also in derived classes
rtl_TextEncoding eSrcEnc; // Source encoding
sal_uLong nNextChPos;
sal_Unicode nNextCh; // current character for the "lex"
bool bDownloadingFile : 1; // true: An external file is
// currently being loaded, i.e.
// all DataAvailable Links must
// be ignored.
// If none of the following
// flags is set, the stream
// is read as ANSI, but returned
// as CharSet DONTKNOW.
bool bUCS2BSrcEnc : 1; // or as big-endian UCS2
bool bSwitchToUCS2 : 1; // switching is allowed
bool bRTF_InTextRead : 1; // only for RTF-Parser!!!
struct TokenStackType
{
OUString sToken;
long nTokenValue;
bool bTokenHasValue;
int nTokenId;
TokenStackType()
: nTokenValue(0)
, bTokenHasValue(false)
, nTokenId(0)
{
}
~TokenStackType() { }
};
// methods for Token stack
int SkipToken( short nCnt = -1 ); // "skip" n Tokens back
TokenStackType* GetStackPtr( short nCnt );
inline sal_uInt8 GetStackPos() const;
// scan the next token:
// work off Token stack and call _GetNextToken() if necessary.
// That one is responsible for the recognition of new Tokens.
int GetNextToken();
virtual int _GetNextToken() = 0;
// is called for each Token that is recognized in CallParser
virtual void NextToken( int nToken );
// at times of SvRefBase derivation, not everybody may delete
virtual ~SvParser();
void ClearTxtConvContext();
private:
TokenStackType* pTokenStack;
TokenStackType *pTokenStackPos;
sal_uInt8 nTokenStackSize, nTokenStackPos;
public:
SvParser( SvStream& rIn, sal_uInt8 nStackSize = 3 );
virtual SvParserState CallParser() = 0; // calling of the parser
inline SvParserState GetStatus() const { return eState; } // StatusInfo
inline sal_uLong GetLineNr() const { return nlLineNr; }
inline sal_uLong GetLinePos() const { return nlLinePos; }
inline sal_uLong IncLineNr() { return ++nlLineNr; }
inline sal_uLong IncLinePos() { return ++nlLinePos; }
inline sal_uLong SetLineNr( sal_uLong nlNum ); // inline bottom
inline sal_uLong SetLinePos( sal_uLong nlPos ); // inline bottom
sal_Unicode GetNextChar();
void RereadLookahead();
inline bool IsParserWorking() const { return SVPAR_WORKING == eState; }
Link GetAsynchCallLink() const
{ return STATIC_LINK( const_cast<SvParser*>(this), SvParser, NewDataRead ); }
long CallAsyncCallLink() { return NewDataRead( this, 0 ); }
// for asynchronous reading from the SvStream
void SaveState( int nToken );
void RestoreState();
virtual void Continue( int nToken );
inline void SetDownloadingFile( bool bSet ) { bDownloadingFile = bSet; }
inline bool IsDownloadingFile() const { return bDownloadingFile; }
// Set/get source encoding. The UCS2BEncoding flag is valid if source
// encoding is UCS2. It specifies a big endian encoding.
void SetSrcEncoding( rtl_TextEncoding eSrcEnc );
rtl_TextEncoding GetSrcEncoding() const { return eSrcEnc; }
void SetSrcUCS2BEncoding( bool bSet ) { bUCS2BSrcEnc = bSet; }
bool IsSrcUCS2BEncoding() const { return bUCS2BSrcEnc; }
// May the character set be switched to UCS/2, if a BOM
// is in the first two characters of the stream?
void SetSwitchToUCS2( bool bSet ) { bSwitchToUCS2 = bSet; }
bool IsSwitchToUCS2() const { return bSwitchToUCS2; }
// how many bytes a character consists of
inline sal_uInt16 GetCharSize() const;
int GetSaveToken() const;
// build a Which-Map 'rWhichMap' from an array of WhichIds
// 'pWhichIds'. It has the length 'nWhichIds'.
// The WhichMap is not deleted.
static void BuildWhichTbl( std::vector<sal_uInt16> &rWhichMap,
sal_uInt16 *pWhichIds,
sal_uInt16 nWhichIds );
};
#ifndef GOODIES_DECL_SVPARSER_DEFINED
#define GOODIES_DECL_SVPARSER_DEFINED
typedef tools::SvRef<SvParser> SvParserRef;
#endif
inline sal_uLong SvParser::SetLineNr( sal_uLong nlNum )
{ sal_uLong nlOld = nlLineNr; nlLineNr = nlNum; return nlOld; }
inline sal_uLong SvParser::SetLinePos( sal_uLong nlPos )
{ sal_uLong nlOld = nlLinePos; nlLinePos = nlPos; return nlOld; }
inline sal_uInt8 SvParser::GetStackPos() const
{ return nTokenStackPos; }
inline sal_uInt16 SvParser::GetCharSize() const
{
return (RTL_TEXTENCODING_UCS2 == eSrcEnc) ? 2 : 1;
}
/*========================================================================
*
* SvKeyValue.
*
*======================================================================*/
class SvKeyValue
{
/** Representation.
*/
OUString m_aKey;
OUString m_aValue;
public:
/** Construction.
*/
SvKeyValue (void)
{}
SvKeyValue (const OUString &rKey, const OUString &rValue)
: m_aKey (rKey), m_aValue (rValue)
{}
SvKeyValue (const SvKeyValue &rOther)
: m_aKey (rOther.m_aKey), m_aValue (rOther.m_aValue)
{}
/** Assignment.
*/
SvKeyValue& operator= (SvKeyValue &rOther)
{
m_aKey = rOther.m_aKey;
m_aValue = rOther.m_aValue;
return *this;
}
/** Operation.
*/
const OUString& GetKey (void) const { return m_aKey; }
const OUString& GetValue (void) const { return m_aValue; }
void SetKey (const OUString &rKey ) { m_aKey = rKey; }
void SetValue (const OUString &rValue) { m_aValue = rValue; }
};
/*========================================================================
*
* SvKeyValueIterator.
*
*======================================================================*/
class SVT_DLLPUBLIC SvKeyValueIterator : public SvRefBase,
private boost::noncopyable
{
struct Impl;
Impl* mpImpl;
public:
/** Construction/Destruction.
*/
SvKeyValueIterator();
virtual ~SvKeyValueIterator();
/** Operation.
*/
virtual bool GetFirst (SvKeyValue &rKeyVal);
virtual bool GetNext (SvKeyValue &rKeyVal);
virtual void Append (const SvKeyValue &rKeyVal);
};
typedef tools::SvRef<SvKeyValueIterator> SvKeyValueIteratorRef;
#endif // INCLUDED_SVTOOLS_SVPARSER_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */