mir/libreoffice
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New loplugin:dynexcspec: Add @throws documentation, sax

Browse Source 
Change-Id: If43818ca79bf134a5025ed184c201f4129630500
This commit is contained in:
Stephan Bergmann 2017-01-19 17:53:35 +01:00
parent f96428fc5f
commit b814e4d050
3 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
sax/inc/xml2utf.hxx
View File

@ -88,6 +88,10 @@ public:
// @param nMaxToRead The number of chars, that should be read. Note that this is no exact number. There
// may be returned less or more bytes than ordered.
/// @throws css::io::IOException
/// @throws css::io::NotConnectedException
/// @throws css::io::BufferSizeExceededException
/// @throws css::uno::RuntimeException
sal_Int32 readAndConvert( css::uno::Sequence<sal_Int8> &seq , sal_Int32 nMaxToRead )
throw ( css::io::IOException,
css::io::NotConnectedException ,

16
sax/source/expatwrap/saxwriter.cxx
View File

@ -92,19 +92,23 @@ private:
sal_uInt32 nCurrentPos;
bool m_bStartElementFinished;
/// @throws SAXException
inline sal_uInt32 writeSequence() throw( SAXException );
// use only if to insert the bytes more space in the sequence is needed and
// so the sequence has to write out and reset rPos to 0
// writes sequence only on overflow, sequence could be full on the end (rPos == SEQUENCESIZE)
/// @throws SAXException
inline void AddBytes(sal_Int8* pTarget, sal_uInt32& rPos,
const sal_Int8* pBytes, sal_uInt32 nBytesCount) throw( SAXException );
/// @throws SAXException
inline bool convertToXML(const sal_Unicode * pStr,
sal_Int32 nStrLen,
bool bDoNormalization,
bool bNormalizeWhitespace,
sal_Int8 *pTarget,
sal_uInt32& rPos) throw( SAXException );
/// @throws SAXException
inline void FinishStartElement() throw( SAXException );
public:
explicit SaxWriterHelper(Reference< XOutputStream > const & m_TempOut)
@ -124,11 +128,13 @@ public:
OSL_ENSURE(m_bStartElementFinished, "StartElement not completely written");
}
/// @throws SAXException
inline void insertIndentation(sal_uInt32 m_nLevel) throw( SAXException );
// returns whether it works correct or invalid characters were in the string
// If there are invalid characters in the string it returns sal_False.
// Than the calling method has to throw the needed Exception.
/// @throws SAXException
inline bool writeString(const OUString& rWriteOutString,
bool bDoNormalization,
bool bNormalizeWhitespace) throw( SAXException );
@ -136,32 +142,42 @@ public:
sal_uInt32 GetLastColumnCount() const throw()
{ return (sal_uInt32)(nCurrentPos - nLastLineFeedPos); }
/// @throws SAXException
inline void startDocument() throw( SAXException );
// returns whether it works correct or invalid characters were in the strings
// If there are invalid characters in one of the strings it returns sal_False.
// Than the calling method has to throw the needed Exception.
/// @throws SAXException
inline SaxInvalidCharacterError startElement(const OUString& rName, const Reference< XAttributeList >& xAttribs) throw( SAXException );
/// @throws SAXException
inline bool FinishEmptyElement() throw( SAXException );
// returns whether it works correct or invalid characters were in the string
// If there are invalid characters in the string it returns sal_False.
// Than the calling method has to throw the needed Exception.
/// @throws SAXException
inline bool endElement(const OUString& rName) throw( SAXException );
/// @throws SAXException
inline void endDocument() throw( SAXException );
// returns whether it works correct or invalid characters were in the strings
// If there are invalid characters in the string it returns sal_False.
// Than the calling method has to throw the needed Exception.
/// @throws SAXException
inline bool processingInstruction(const OUString& rTarget, const OUString& rData) throw( SAXException );
/// @throws SAXException
inline void startCDATA() throw( SAXException );
/// @throws SAXException
inline void endCDATA() throw( SAXException );
// returns whether it works correct or invalid characters were in the strings
// If there are invalid characters in the string it returns sal_False.
// Than the calling method has to throw the needed Exception.
/// @throws SAXException
inline bool comment(const OUString& rComment) throw( SAXException );
/// @throws SAXException
inline void clearBuffer() throw( SAXException );
};

16
sax/source/fastparser/fastparser.cxx
View File

@ -209,14 +209,27 @@ public:
~FastSaxParserImpl();
// XFastParser
/// @throws css::xml::sax::SAXException
/// @throws css::io::IOException
/// @throws css::uno::RuntimeException
void parseStream( const css::xml::sax::InputSource& aInputSource ) throw (css::xml::sax::SAXException, css::io::IOException, css::uno::RuntimeException, std::exception);
/// @throws css::uno::RuntimeException
void setFastDocumentHandler( const css::uno::Reference< css::xml::sax::XFastDocumentHandler >& Handler ) throw (css::uno::RuntimeException);
/// @throws css::uno::RuntimeException
void setTokenHandler( const css::uno::Reference< css::xml::sax::XFastTokenHandler >& Handler ) throw (css::uno::RuntimeException);
/// @throws css::lang::IllegalArgumentException
/// @throws css::uno::RuntimeException
void registerNamespace( const OUString& NamespaceURL, sal_Int32 NamespaceToken ) throw (css::lang::IllegalArgumentException, css::uno::RuntimeException);
/// @throws css::lang::IllegalArgumentException
/// @throws css::uno::RuntimeException
OUString getNamespaceURL( const OUString& rPrefix ) throw(css::lang::IllegalArgumentException, css::uno::RuntimeException);
/// @throws css::uno::RuntimeException
void setErrorHandler( const css::uno::Reference< css::xml::sax::XErrorHandler >& Handler ) throw (css::uno::RuntimeException);
/// @throws css::uno::RuntimeException
void setEntityResolver( const css::uno::Reference< css::xml::sax::XEntityResolver >& Resolver ) throw (css::uno::RuntimeException);
/// @throws css::uno::RuntimeException
void setNamespaceHandler( const css::uno::Reference< css::xml::sax::XFastNamespaceHandler >& Handler) throw (css::uno::RuntimeException);
/// @throws css::uno::RuntimeException
void setLocale( const css::lang::Locale& rLocale ) throw (css::uno::RuntimeException);
// called by the C callbacks of the expat parser
@ -245,7 +258,9 @@ private:
void sendPendingCharacters();
sal_Int32 GetToken( const xmlChar* pName, sal_Int32 nameLen );
/// @throws css::xml::sax::SAXException
sal_Int32 GetTokenWithPrefix( const xmlChar* pPrefix, int prefixLen, const xmlChar* pName, int nameLen ) throw (css::xml::sax::SAXException);
/// @throws css::xml::sax::SAXException
OUString GetNamespaceURL( const OString& rPrefix ) throw (css::xml::sax::SAXException);
sal_Int32 GetNamespaceToken( const OUString& rNamespaceURL );
sal_Int32 GetTokenWithContextNamespace( sal_Int32 nNamespaceToken, const xmlChar* pName, int nNameLen );
@ -338,6 +353,7 @@ public:
explicit FastLocatorImpl(FastSaxParserImpl *p) : mpParser(p) {}
void dispose() { mpParser = nullptr; }
/// @throws RuntimeException
void checkDispose() throw (RuntimeException) { if( !mpParser ) throw DisposedException(); }
//XLocator