class Sequence

Overview

Namespace

Class

Index

Help

PUBLIC MEMBERS:

:: com :: sun :: star :: uno ::

template< typename E >

class Sequence

Base Classes: None.

Known Derived Classes: None.

virtual	abstract	interface	template
NO	NO	NO	YES

Description

Template C++ class representing an IDL sequence. Template argument is the sequence element type. C++ Sequences are reference counted and shared, so the sequence keeps a handle to its data. To keep value semantics, copies are only generated if the sequence is to be modified (new handle).

Template Parameters

E	element type of sequence

File: Sequence.h

Public Members

Typedefs
ElementType	typedefs the element type of the sequence

Methods
Sequence( ) throw( );	Default constructor: Creates an empty sequence.
Sequence( const Sequence< E > & rSeq ) throw( );	Copy constructor: Creates a copy of given sequence.
Sequence( uno_Sequence * pSequence, __sal_NoAcquire ) throw( );	Constructor: Takes over ownership of given sequence.
Sequence( const E * pElements, sal_Int32 len ) throw( );	Constructor: Creates a copy of given elements.
Sequence( sal_Int32 len ) throw( );	Constructor: Creates a default constructed sequence of given length.
~Sequence( ) throw( );	Destructor: Releases sequence handle. Last handle will destruct elements and free memory.
Sequence< E > & operator=( const Sequence< E > & rSeq ) throw( );	Assignment operator: Acquires given sequence handle and releases previously set handle.
sal_Int32 getLength( ) const throw( );	Gets length of the sequence.
sal_Bool hasElements( ) const throw( );	Tests whether the sequence has elements, i.e. elements count is greater than zero.
const E * getConstArray( ) const throw( );	Gets a pointer to elements array for reading. If the sequence has a length of 0, then the returned pointer is undefined.
E * getArray( ) throw( );
E & operator[]( sal_Int32 nIndex ) throw( );
const E & operator[]( sal_Int32 nIndex ) const throw( );	Const index operator: Obtains a reference to element indexed at given position. The implementation does not check for array bounds!
sal_Bool operator==( const Sequence< E > & rSeq ) const throw( );	Equality operator: Compares two sequences.
sal_Bool operator!=( const Sequence< E > & rSeq ) const throw( );	Unequality operator: Compares two sequences.
void realloc( sal_Int32 nSize ) throw( );
uno_Sequence * get( ) const throw( );	Provides UNacquired sequence handle.

Top of Page

class Sequence

Public Members

Typedefs

Methods