:: com :: sun :: star :: util ::
|
interface XAtomServer |
|
- Description
- an interface to map between strings and ids
a note on atoms:
Atoms are abbreviations for strings.
When a string gets registered, it is assigned a numeric id
so that said string can always be referred to by this id.
This way strings have to be transported only once over remote connections.
Valid ids are (in this implementation) non zero, signed 32 bit values.
An atom of 0 means that the string in question is not registered
Additionally there is the abstraction of atom class:
Atoms are grouped into classes, so that an id can be assigned
to multiple strings, depending on the class context. The main
advantage of this is that atoms in one class may be kept
to small numbers, so that bandwidth can be reduced by sending
the atoms only as 16 bit values. Note that it is up to the user in this
case to handle overflows.
|
Methods' Summary |
getClass |
returns a whole atom class
|
getClasses |
returns multiple atom classes
|
getAtomDescriptions |
returns the strings for an arbitrary amount of atoms of multiple classes
|
getRecentAtoms |
returns the atoms that have been registered to a class after an
already known atom
|
getAtom |
registers or searches for a string
|
Methods' Details |
getClass
- Description
- returns a whole atom class
- Parameter atomClass
- which class to return
- Returns
- the descriptions for all atoms of class
atomClass
|
|
getClasses
sequence< sequence< AtomDescription > > |
getClasses( |
[in] sequence< long > |
atomClasses ); |
- Description
- returns multiple atom classes
- Parameter atomClasses
- which classes to return
- Returns
- the descriptions for all atoms of the requested classes
|
|
getAtomDescriptions
sequence< string > |
getAtomDescriptions( |
[in] sequence< AtomClassRequest > |
atoms ); |
- Description
- returns the strings for an arbitrary amount of atoms of multiple classes
- Parameter atoms
- describes which strings to return
- Returns
- the strings for the requested atoms
|
|
getRecentAtoms
sequence< AtomDescription > |
getRecentAtoms( |
[in] long |
atomClass, |
| [in] long |
atom ); |
- Description
- returns the atoms that have been registered to a class after an
already known atom
Hint to implementor: using ascending atoms is the easiest way
to decide, which atoms are recent.
- Parameter atomClass
- the class in question
- Parameter atom
- the last known atom
- Returns
- all atom description that have been added to class
atomClass after atom
|
|
getAtom
long |
getAtom( |
[in] long |
atomClass, |
| [in] string |
description, |
| [in] boolean |
create ); |
- Description
- registers or searches for a string
- Parameter atomClass
- the class of atoms in question
- Parameter description
- the string in question
- Parameter create
- if true a new atom will be created for an unknown string
else the invalid atom (0) will be returned for an unknown string
- Returns
- the atom for the string
description
|
|
Top of Page
Copyright © 2000, 2013 LibreOffice contributors and/or their affiliates. All rights reserved.
LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.
The Document Foundation acknowledges all community members, please find more info at our website.
Privacy Policy | Impressum (Legal Info) | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (LGPLv3). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.