bdld::DatumArrayRef Class Reference

#include <bdld_datum.h>

Public Types
typedef const bdld::Datum	element_type
typedef bdld::Datum	value_type
typedef bsl::size_t	size_type
typedef bsl::ptrdiff_t	difference_type
typedef element_type *	pointer
typedef const element_type *	const_pointer
typedef element_type &	reference
typedef const element_type &	const_reference
typedef pointer	iterator
typedef const_pointer	const_iterator
typedef bsl::reverse_iterator< iterator >	reverse_iterator
typedef bsl::reverse_iterator< const_iterator >	const_reverse_iterator
typedef Datum::SizeType	SizeType

Public Member Functions
	BSLMF_NESTED_TRAIT_DECLARATION (DatumArrayRef, bsl::is_trivially_copyable)
	BSLMF_NESTED_TRAIT_DECLARATION (DatumArrayRef, bdlb::HasPrintMethod)
	DatumArrayRef ()
	Create a DatumArrayRef object representing an empty array.
	DatumArrayRef (const Datum *data, SizeType length)
	DatumArrayRef (const DatumArrayRef &other)=default
	~DatumArrayRef ()=default
DatumArrayRef &	operator= (const DatumArrayRef &rhs)=default
	Assign to this object the value of the specified rhs object.
const_reference	operator[] (size_type position) const
const_iterator	begin () const BSLS_KEYWORD_NOEXCEPT
const_iterator	cbegin () const BSLS_KEYWORD_NOEXCEPT
const_iterator	end () const BSLS_KEYWORD_NOEXCEPT
const_iterator	cend () const BSLS_KEYWORD_NOEXCEPT
const_reverse_iterator	rbegin () const BSLS_KEYWORD_NOEXCEPT
const_reverse_iterator	crbegin () const BSLS_KEYWORD_NOEXCEPT
const_reverse_iterator	rend () const BSLS_KEYWORD_NOEXCEPT
const_reverse_iterator	crend () const BSLS_KEYWORD_NOEXCEPT
bool	empty () const BSLS_KEYWORD_NOEXCEPT
	Return size() == 0.
size_type	size () const BSLS_KEYWORD_NOEXCEPT
const_reference	front () const
const_reference	back () const
pointer	data () const BSLS_KEYWORD_NOEXCEPT
size_type	length () const
	Return a const pointer to the length of the array.
bsl::ostream &	print (bsl::ostream &stream, int level=0, int spacesPerLevel=4) const

Detailed Description

This class provides a read-only view to an array of datums. It holds the array by a const pointer and an integral length value. It acts as return value for accessors inside the Datum class that return an array of datums. Note that zero-length arrays are valid.

See bdld_datum

Member Typedef Documentation

const_iterator

typedef const_pointer bdld::DatumArrayRef::const_iterator

const_pointer

typedef const element_type* bdld::DatumArrayRef::const_pointer

const_reference

typedef const element_type& bdld::DatumArrayRef::const_reference

const_reverse_iterator

typedef bsl::reverse_iterator<const_iterator> bdld::DatumArrayRef::const_reverse_iterator

difference_type

typedef bsl::ptrdiff_t bdld::DatumArrayRef::difference_type

element_type

typedef const bdld::Datum bdld::DatumArrayRef::element_type

iterator

typedef pointer bdld::DatumArrayRef::iterator

pointer

typedef element_type* bdld::DatumArrayRef::pointer

reference

typedef element_type& bdld::DatumArrayRef::reference

reverse_iterator

typedef bsl::reverse_iterator<iterator> bdld::DatumArrayRef::reverse_iterator

size_type

typedef bsl::size_t bdld::DatumArrayRef::size_type

SizeType

typedef Datum::SizeType bdld::DatumArrayRef::SizeType

SizeType is an alias for an unsigned integral value, representing the length of a datum array.

value_type

typedef bdld::Datum bdld::DatumArrayRef::value_type

Constructor & Destructor Documentation

DatumArrayRef() [1/3]

bdld::DatumArrayRef::DatumArrayRef ( )

inline

DatumArrayRef() [2/3]

bdld::DatumArrayRef::DatumArrayRef ( const Datum *  data, SizeType  length  )

inline

Create a DatumArrayRef object having the specified data and length. The behavior is undefined unless 0 != data or 0 == length. Note that the pointer to the array is just copied.

DatumArrayRef() [3/3]

bdld::DatumArrayRef::DatumArrayRef ( const DatumArrayRef &  other )

default

Create a DatumArrayRef object having the value of the specified original object.

~DatumArrayRef()

bdld::DatumArrayRef::~DatumArrayRef ( )

default

Member Function Documentation

back()

DatumArrayRef::const_reference bdld::DatumArrayRef::back ( ) const

inline

Return a reference providing non-modifiable access to the last element of the array this reference object represents. The behavior is undefined unless size() > 0.

begin()

DatumArrayRef::const_iterator bdld::DatumArrayRef::begin ( ) const

inline

BSLMF_NESTED_TRAIT_DECLARATION() [1/2]

bdld::DatumArrayRef::BSLMF_NESTED_TRAIT_DECLARATION	(	DatumArrayRef	,
		bdlb::HasPrintMethod
	)

BSLMF_NESTED_TRAIT_DECLARATION() [2/2]

bdld::DatumArrayRef::BSLMF_NESTED_TRAIT_DECLARATION	(	DatumArrayRef	,
		bsl::is_trivially_copyable
	)

cbegin()

DatumArrayRef::const_iterator bdld::DatumArrayRef::cbegin ( ) const

inline

Return an iterator providing non-modifiable access to the first element of the array this reference object represents; return a past-the-end iterator if size() == 0.

cend()

DatumArrayRef::const_iterator bdld::DatumArrayRef::cend ( ) const

inline

Return an iterator providing non-modifiable access pointing past-the-end of the array this reference object represents.

crbegin()

DatumArrayRef::const_reverse_iterator bdld::DatumArrayRef::crbegin ( ) const

inline

Return a reverse iterator providing non-modifiable access to the last element of the array this reference object represents, and the past-the-end reverse iterator if size() == 0.

crend()

DatumArrayRef::const_reverse_iterator bdld::DatumArrayRef::crend ( ) const

inline

Return a reverse iterator providing non-modifiable access pointing past-the-end of the array this reference object represents.

data()

DatumArrayRef::pointer bdld::DatumArrayRef::data ( ) const

inline

Return the address providing non-modifiable access to the first element of the array this reference object represents. Return a valid pointer which cannot be dereferenced if the size() == 0.

empty()

bool bdld::DatumArrayRef::empty ( ) const

inline

end()

DatumArrayRef::const_iterator bdld::DatumArrayRef::end ( ) const

inline

front()

DatumArrayRef::const_reference bdld::DatumArrayRef::front ( ) const

inline

Return a reference providing non-modifiable access to the first element of the array this reference object represents. The behavior is undefined unless size() > 0.

length()

DatumArrayRef::size_type bdld::DatumArrayRef::length ( ) const

inline

operator=()

DatumArrayRef & bdld::DatumArrayRef::operator= ( const DatumArrayRef &  rhs )

default

operator[]()

DatumArrayRef::const_reference bdld::DatumArrayRef::operator[] ( size_type  position ) const

inline

Return a reference providing non-modifiable access to the element at the specified position in the array this reference object represents. The behavior is undefined unless position < size().

print()

bsl::ostream & bdld::DatumArrayRef::print	(	bsl::ostream &	stream,
		int	level = 0,
		int	spacesPerLevel = 4
	)		const

Write the value of this object to the specified output stream in a human-readable format, and return a reference to the modifiable stream. Optionally specify an initial indentation level, whose absolute value is incremented recursively for nested objects. If level is specified, optionally specify spacesPerLevel, whose absolute value indicates the number of spaces per indentation level for this and all of its nested objects. If level is negative, suppress indentation of the first line. If spacesPerLevel is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by level). If stream is not valid on entry, this operation has no effect. Note that this human-readable format is not fully specified, and can change without notice.

rbegin()

DatumArrayRef::const_reverse_iterator bdld::DatumArrayRef::rbegin ( ) const

inline

rend()

DatumArrayRef::const_reverse_iterator bdld::DatumArrayRef::rend ( ) const

inline

size()

DatumArrayRef::size_type bdld::DatumArrayRef::size ( ) const

inline

Return a const-pointer to the number of elements of the array this reference object represents.

---

The documentation for this class was generated from the following file:

• bdld_datum.h