Abstract base class for input devices. More...

#include <in_dev.h>

Public Types
using	type = in_dev_t
	Export type as identity meta-function. More...


using	data_type = data_t

using	pointer_type = data_t *

Public Member Functions
Public Get interface
size_t	get (data_t &data)
	Get interface. This function should read a single data_t object from device in blocking mode. More...

size_t	get (data_t *data, size_t n)
	Old stile get functionality using free standing data_t*. This function should return a stream of data from device. More...

Stream operator >> interface
template<typename _Dst_t >
in_dev_t &	operator>> (_Dst_t &dst)
	Template operator >> implementation for for all by value/ref parameters. More...

template<typename _Dst_t >
in_dev_t &	operator>> (_Dst_t *dst)=delete
	Specialization to disallow pointer types as destination. More...

in_dev_t &	operator>> (data_t &dst)
	Overload for single data_t object. More...


iterator	end () noexcept

const_iterator	end () const noexcept

const_iterator	cend () const noexcept

Protected Member Functions
Constructor / Destructor
	~in_dev ()=default
	Allow destructor from derived only. More...

	in_dev ()=default
	A default constructor from derived only. More...

	in_dev (const in_dev_t &)=delete
	No copies. More...

in_dev_t &	operator= (const in_dev_t &)=delete

Private Types
using	in_dev_t = in_dev< impl_t, data_t, streamsize >
	class type syntactic sugar More...

Private Member Functions
	_CRTP_IMPL (impl_t)

Common input device interface requirements
size_t	get_ (data_t &data)

size_t	get_ (data_t *data, size_t n)

STL-like Input iterator interface
using	iterator = indev_it< in_dev_t, data_t *, streamsize >
	Iterator. More...

using	const_iterator = indev_it< in_dev_t, const data_t *, streamsize >
	Const iterator. More...

iterator	begin () noexcept
	.begin implementation More...

const_iterator	begin () const noexcept

const_iterator	cbegin () const noexcept

Detailed Description

template<typename impl_t, typename data_t, size_t streamsize = 0>
class utl::in_dev< impl_t, data_t, streamsize >

Abstract base class for input devices.

Template base class for un-buffered input devices. using CRTP

This class force a common interface for input, non-buffered devices. By using this common interface the class implements

Stream-like extracting operator
Input iterator
Const input iterator to inherit to implementation.

Parameters

impl_t	The CRTP type (the derived/implementation class typename).
data_t	The devices base type of data
streamsize	The number of elements to indicate eos. None or 0 Stream only. No iterator as begin() now equals end().

Definition at line 54 of file in_dev.h.

Member Typedef Documentation

◆ const_iterator

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::const_iterator = indev_it <in_dev_t, const data_t*, streamsize>

Const iterator.

Definition at line 151 of file in_dev.h.

◆ data_type

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::data_type = data_t

Export types as input device concept demands

Definition at line 61 of file in_dev.h.

◆ in_dev_t

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::in_dev_t = in_dev <impl_t, data_t, streamsize>

private

class type syntactic sugar

Definition at line 56 of file in_dev.h.

◆ iterator

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::iterator = indev_it <in_dev_t, data_t*, streamsize>

Iterator.

Definition at line 150 of file in_dev.h.

◆ pointer_type

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::pointer_type = data_t*

Definition at line 62 of file in_dev.h.

◆ type

template<typename impl_t , typename data_t , size_t streamsize = 0>

using utl::in_dev< impl_t, data_t, streamsize >::type = in_dev_t

Export type as identity meta-function.

Definition at line 64 of file in_dev.h.

Constructor & Destructor Documentation

◆ ~in_dev()

template<typename impl_t , typename data_t , size_t streamsize = 0>

utl::in_dev< impl_t, data_t, streamsize >::~in_dev ( )

protecteddefault

Allow destructor from derived only.

◆ in_dev() [1/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

utl::in_dev< impl_t, data_t, streamsize >::in_dev ( )

protecteddefault

A default constructor from derived only.

◆ in_dev() [2/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

utl::in_dev< impl_t, data_t, streamsize >::in_dev ( const in_dev_t & )

protecteddelete

No copies.

Member Function Documentation

◆ _CRTP_IMPL()

template<typename impl_t , typename data_t , size_t streamsize = 0>

utl::in_dev< impl_t, data_t, streamsize >::_CRTP_IMPL ( impl_t )

private

◆ begin() [1/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

iterator utl::in_dev< impl_t, data_t, streamsize >::begin ( )

inlinenoexcept

.begin implementation

Definition at line 154 of file in_dev.h.

◆ begin() [2/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

const_iterator utl::in_dev< impl_t, data_t, streamsize >::begin ( ) const

inlinenoexcept

Definition at line 155 of file in_dev.h.

◆ cbegin()

template<typename impl_t , typename data_t , size_t streamsize = 0>

const_iterator utl::in_dev< impl_t, data_t, streamsize >::cbegin ( ) const

inlinenoexcept

Definition at line 156 of file in_dev.h.

◆ cend()

template<typename impl_t , typename data_t , size_t streamsize = 0>

const_iterator utl::in_dev< impl_t, data_t, streamsize >::cend ( ) const

inlinenoexcept

Definition at line 161 of file in_dev.h.

◆ end() [1/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

iterator utl::in_dev< impl_t, data_t, streamsize >::end ( )

inlinenoexcept

.end implementation

Definition at line 159 of file in_dev.h.

◆ end() [2/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

const_iterator utl::in_dev< impl_t, data_t, streamsize >::end ( ) const

inlinenoexcept

Definition at line 160 of file in_dev.h.

◆ get() [1/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

size_t utl::in_dev< impl_t, data_t, streamsize >::get ( data_t & data )

inline

Get interface. This function should read a single data_t object from device in blocking mode.

Parameters

data	Reference to data output from device.

Returns: Number of data read from device

Note: A successful call should return 1

Definition at line 97 of file in_dev.h.

◆ get() [2/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

size_t utl::in_dev< impl_t, data_t, streamsize >::get	(	data_t *	data,
		size_t	n
	)

inline

Old stile get functionality using free standing data_t*. This function should return a stream of data from device.

Parameters

data	Pointer to buffer to write the data from device.
n	The number of data of type data_t to read

Returns: The read data items.

Definition at line 109 of file in_dev.h.

◆ get_() [1/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

size_t utl::in_dev< impl_t, data_t, streamsize >::get_ ( data_t & data )

inlineprivate

Definition at line 79 of file in_dev.h.

◆ get_() [2/2]

template<typename impl_t , typename data_t , size_t streamsize = 0>

size_t utl::in_dev< impl_t, data_t, streamsize >::get_	(	data_t *	data,
		size_t	n
	)

inlineprivate

Definition at line 80 of file in_dev.h.

◆ operator=()

template<typename impl_t , typename data_t , size_t streamsize = 0>

in_dev_t& utl::in_dev< impl_t, data_t, streamsize >::operator= ( const in_dev_t & )

protecteddelete

No copy assignments

◆ operator>>() [1/3]

template<typename impl_t , typename data_t , size_t streamsize = 0>

template<typename _Dst_t >

in_dev_t& utl::in_dev< impl_t, data_t, streamsize >::operator>> ( _Dst_t & dst )

inline

Template operator >> implementation for for all by value/ref parameters.

Note: In the case _Dst_t size is not a integer multiple of device's data size this will fail by static assertion

Parameters

dst	Reference to destination

Returns: Reference to this device for chaining

Definition at line 129 of file in_dev.h.

◆ operator>>() [2/3]

template<typename impl_t , typename data_t , size_t streamsize = 0>

template<typename _Dst_t >

in_dev_t& utl::in_dev< impl_t, data_t, streamsize >::operator>> ( _Dst_t * dst )

delete

Specialization to disallow pointer types as destination.

◆ operator>>() [3/3]

template<typename impl_t , typename data_t , size_t streamsize = 0>

in_dev_t& utl::in_dev< impl_t, data_t, streamsize >::operator>> ( data_t & dst )

inline

Overload for single data_t object.

Definition at line 140 of file in_dev.h.

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

include/utl/dev/in_dev.h

Public Types

Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

STL-like Input iterator interface

Detailed Description

template<typename impl_t, typename data_t, size_t streamsize = 0> class utl::in_dev< impl_t, data_t, streamsize >

Member Typedef Documentation

◆ const_iterator

◆ data_type

◆ in_dev_t

◆ iterator

◆ pointer_type

◆ type

Constructor & Destructor Documentation

◆ ~in_dev()

◆ in_dev() [1/2]

◆ in_dev() [2/2]

Member Function Documentation

◆ _CRTP_IMPL()

◆ begin() [1/2]

◆ begin() [2/2]

◆ cbegin()

◆ cend()

◆ end() [1/2]

◆ end() [2/2]

◆ get() [1/2]

◆ get() [2/2]

◆ get_() [1/2]

◆ get_() [2/2]

◆ operator=()

◆ operator>>() [1/3]

◆ operator>>() [2/3]

◆ operator>>() [3/3]

template<typename impl_t, typename data_t, size_t streamsize = 0>
class utl::in_dev< impl_t, data_t, streamsize >