:: com :: sun :: star :: ucb ::

interface XContentIdentifierMapping
Description
A mapping from a (source) set of ::com::sun::star::ucb::XContentIdentifier s to another (target) set of XContentIdentifiers.

For convenience and performance, mapping between the string representations of source/target XContentIdentifiers, as well as mapping between ::com::sun::star::ucb::XContent s identified by source/target XContentIdentifiers is also supported.

This interface can be useful in cases where the identifieres (and associated contents) returned by the various methods of an ::com::sun::star::ucb::XContentAccess need to be mapped to some other space of identifiers (and associated contents).

See also
::com::sun::star::ucb::XContent, ::com::sun::star::ucb::XContentAccess, ::com::sun::star::ucb::XContentIdentifier

Methods' Summary
mapContentIdentifierString Map the string representation of an ::com::sun::star::ucb::XContentIdentifier .  
mapContentIdentifier Map an ::com::sun::star::ucb::XContentIdentifier .  
mapContent Map the ::com::sun::star::ucb::XContent identified by an ::com::sun::star::ucb::XContentIdentifier .  
mapRow Map the content identifiers (or related data) contained in the columns of a ::com::sun::star::sdbc::XRow .  
Methods' Details
mapContentIdentifierString
string
mapContentIdentifierString( [in] string  Source );

Description
Map the string representation of an ::com::sun::star::ucb::XContentIdentifier .
Parameter Source
The string representation of an XContentIdentifier from the source set.
Returns
The string representation of the target set's XContentIdentifier corresponding to the source identifier. The returned string may be empty if either Source was empty already, or if there's no applicable target to map to.
mapContentIdentifier
::com::sun::star::ucb::XContentIdentifier
mapContentIdentifier( [in] ::com::sun::star::ucb::XContentIdentifier  Source );

Description
Map an ::com::sun::star::ucb::XContentIdentifier .
Parameter Source
An XContentIdentifier from the source set.
Returns
The target set's XContentIdentifier corresponding to the source identifier. The returned XContentIdentifier may be null if either Source was null already, or if there's no applicable target to map to.
mapContent
::com::sun::star::ucb::XContent
mapContent( [in] ::com::sun::star::ucb::XContent  Source );

Description
Map the ::com::sun::star::ucb::XContent identified by an ::com::sun::star::ucb::XContentIdentifier .
Parameter Source
The XContent identified by an XContentIdentifier from the source set.
Returns
The XContent identified by the target set's XContentIdentifier corresponding to the source identifier. The returned XContent may be null if either Source was null already, or if there's no applicable target to map to.
mapRow
boolean
mapRow( [inout] sequence< any >  Value );

Description
Map the content identifiers (or related data) contained in the columns of a ::com::sun::star::sdbc::XRow .
Parameter Value
On input, a sequence of anys corresponding to the columns of the XRow (the first column goes into the zeroth position of the sequence, and so on). On output, the same sequence, but with the entries mapped as necessary. This is an inout parameter rather than a comination of in parameter and return value for performance reasons (assuming that in most cases most elements in the input sequence will be returned unmodified).
Returns
true if any of the columns contain data that (potentially) needs mapping (though maybe no mapping occured for the concrete input data of this call). This information can be useful to decide whether, for another row, a call to this function is at all necessary.
Top of Page