/* -*- 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 .
*/
module com { module sun { module star { module xml { module sax {
/** a container for the attributes of an XML element.
<br>Attributes are separated into known attributes and unknown attributes.
<p>Known attributes have a local name that is known to the XFastTokenHandler
registered at the XFastParser which created the sax event containing
this attributes. If an attribute also has a namespace, that must be registered
at the XFastParser, else this attribute is also unknown even if
the local name is known.
*/
interface XFastAttributeList: com::sun::star::uno::XInterface
{
/** checks if an attribute is available.<br>
@param Token
contains the integer token from the XFastTokenHandler
registered at the XFastParser.<br>
If the attribute name has a namespace that was registered with the
XFastParser, Token contains the integer token of the
attributes local name from the XFastTokenHandler and
the integer token of the namespace combined with an arithmetic
<b>or</b> operation.
@returns
`TRUE`, if the attribute is available
*/
boolean hasAttribute( [in] long Token );
/** retrieves the token of an attribute value.<br>
@param Token
contains the integer token from the XFastTokenHandler
registered at the XFastParser.<br>
If the attribute name has a namespace that was registered with the
XFastParser, Token contains the integer token of the
attributes local name from the XFastTokenHandler and
the integer token of the namespace combined with an arithmetic
<b>or</b> operation.
@returns
The integer token of the value from the attribute or FastToken::Invalid
@throws SAXEXception
if the attribute is not available
*/
long getValueToken( [in] long Token )
raises( SAXException );
/**retrieves the token of an attribute value.<br>
@param Token
contains the integer token from the XFastTokenHandler
registered at the XFastParser.<br>
If the attribute name has a namespace that was registered with the
XFastParser, Token contains the integer token of the
attributes local name from the XFastTokenHandler and
the integer token of the namespace combined with an arithmetic
<b>or</b> operation.
@param Default
This value will be returned if the attribute is not available
@returns
If the attribute is available it returns the integer token of the value
from the attribute or FastToken::Invalid.
If not the value of <code>Default</code> is returned.
*/
long getOptionalValueToken( [in] long Token, [in] long Default );
/** retrieves the value of an attribute.<br>
@param Token
contains the integer token from the XFastTokenHandler
registered at the XFastParser.<br>
If the attribute name has a namespace that was registered with the
XFastParser, Token contains the integer token of the
attributes local name from the XFastTokenHandler and
the integer token of the namespace combined with an arithmetic
<b>or</b> operation.
@returns
The string value from the attribute.
@throws SAXEXception
if the attribute is not available
*/
string getValue( [in] long Token )
raises( SAXException );
/** retrieves the value of an attribute.<br>
@param Token
contains the integer token from the XFastTokenHandler
registered at the XFastParser.<br>
If the attribute name has a namespace that was registered with the
XFastParser, Token contains the integer token of the
attributes local name from the XFastTokenHandler and
the integer token of the namespace combined with an arithmetic
<b>or</b> operation.
@returns
The string value from the attribute or an empty string if the
attribute is not available.
*/
string getOptionalValue( [in] long Token );
/** returns a sequence of attributes which names and or namespaces URLS
can not be translated to tokens.
*/
sequence< ::com::sun::star::xml::Attribute > getUnknownAttributes();
/** returns a sequence of attributes which names and or namespaces URLS
are translated to tokens.
*/
sequence< ::com::sun::star::xml::FastAttribute > getFastAttributes();
};
}; }; }; }; };
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
