Arp Namespace Reference

Root namespace for the PLCnext API More...

Namespaces
	Device
	Namespace for device abstraction components
	Hardware
	Namespace for hardware abstraction components
	Io
	Namespace for I/O subsystems
	Plc
	Namespace for classes related to the PLC functionality
	Services
	Namespace for service components
	System
	Namespace of system functions of PLCnext

Classes
class	AppDomain
	This class represents a single application domain for each process and is implemented as singleton. More...
class	AppDomainSingleton
	This class implements the singleton pattern for singletons with process wide scope. More...
class	ArpVersion
	This class provides the actual Arp version. More...
class	BasicString
class	BasicFormatter
	This class encapsulates formatting operations which are based on the open source library libfmt formerly known as cppformat. More...
class	BasicVersion
	This class represents the version of a special SDK or Arp build. More...
class	ByteConverter
	This pure static class provides operation sfor byte converting from little to big endian and vice versa. More...
class	CommonTypeName
	This (meta programming) class provides the typename according the CLS (common language specification) of the as template argument passed type. More...
class	CommonTypeName< void >
	This (meta programming) pure static class provides some factory operations to create CommonTypeName generically from variables or pointers. More...
class	DateTime
	The class contains date and time informations. More...
class	RuntimeTypeInfo
	The class implements some RTTI utility operations. More...
class	delegate< R(A...)>
	This class represents a delegate, that is a compound of an object reference and a member function pointer. The generic type of a delegate just depends on the signature of the (member) function pointer but not on the type of the object on which the member function pointer is invoked. More...
class	Enum
	Adapter class for enums to make them loggable and parsable from e.g. XML files. More...
class	Enumerator
	This class defines a base class for all enumerator implementations and some predefined enumerators as nested classes. More...
class	event
	Use this class to register and invoke several delegates (function pointer in OOP design). More...
class	event< void >
	Use this class to register and invoke several delegates (function pointer in OOP design). More...
class	Exception
	This is the base class of all Arp exception classes. More...
class	IEnumerator
	Declares the interface of the enumerator pattern, which is leaned on .NET enumerator idiom. More...
class	PimplPtr
	Small wrapper class to ensure const correctness using PImpl pattern. More...
class	PimplPtr< T, true >
class	Singleton
	This class implements the singleton pattern. More...
class	slim_delegate
class	slim_delegate< R(A...)>
struct	underlying_enum_type
	Determines the underlying type of an enum class. More...
struct	underlying_enum_type< T, true >
	Determines the underlying type of an enum class. More...
struct	remove_shared_ptr
	Gets the value type of a shared_ptr. More...
struct	remove_shared_ptr< std::shared_ptr< T > >
	Gets the value type of a shared_ptr. More...
class	TypeName
	This (meta programming) class provides the C++ typename of the as template argument passed type. More...
class	TypeName< void >
	This (meta programming) pure static class provides some operations to retrieve typenames generically from variables or pointers. More...

Typedefs
typedef bool	boolean
	The Arp boolean type. More...
typedef unsigned char	byte
	The Arp character type. More...
typedef signed char	sbyte
	The Arp signed byte type. More...
typedef std::uint8_t	uint8
	The Arp unsigned integer type of 1 byte size. More...
typedef std::int8_t	int8
	The Arp integer type of 1 byte size. More...
typedef std::uint16_t	uint16
	The Arp unsigned integer type of 2 byte size. More...
typedef std::int16_t	int16
	The Arp integer type of 2 byte size. More...
typedef std::uint32_t	uint32
	The Arp unsigned integer type of 4 byte size. More...
typedef std::int32_t	int32
	The Arp integer type of 4 byte size. More...
typedef std::uint64_t	uint64
	The Arp unsigned integer type of 8 byte size. More...
typedef std::int64_t	int64
	The Arp integer type of 8 byte size. More...
typedef float	float32
	The Arp floating point numbers type of 4 byte size. More...
typedef double	float64
	The Arp floating point numbers type of 8 byte size. More...
typedef char	char8
	The Arp character type of 1 byte size. More...
typedef char16_t	char16
	The Arp character type of 2 byte size. More...
typedef Arp::BasicString< char8 >	String
	The Arp String class. More...
typedef Arp::BasicVersion	Version
	The Arp Version class. More...
typedef std::chrono::nanoseconds	Nanoseconds
	The Arp Nanoseconds unit class. More...
typedef std::chrono::microseconds	Microseconds
	The Arp Microseconds unit class. More...
typedef std::chrono::milliseconds	Milliseconds
	The Arp Milliseconds unit class. More...
typedef std::chrono::seconds	Seconds
	The Arp Seconds unit class. More...
typedef std::chrono::minutes	Minutes
	The Arp Minutes unit class. More...
typedef std::chrono::hours	Hours
	The Arp Hours unit class. More...
typedef uint32	uintx
	The Arp unsigned integer type matching CPU width. More...
typedef int32	intx
	The Arp integer type matching CPU width. More...
typedef uint32	intptr
	The Arp integer type matching pointer size. More...

Enumerations
enum class	DateTimeKind { Unspecified = 0 , Utc = 1 }
	Specifies whether a DateTime object represents a local time, a Coordinated Universal Time (UTC), or is not specified. More...
enum class	Endianness { None = 0 , BigEndian = 1 , LittleEndian = 2 , Current = LittleEndian }
	This enum defines the endinannes of the target architecture. More...

Functions
template<class CharType , class Alloc >
void	swap (BasicString< CharType, Alloc > &left, BasicString< CharType, Alloc > &right) noexcept
	Swaps the content of the left string with the content of the right string. More...
template<class CharType , class Alloc >
std::ostream &	operator<< (std::ostream &os, const BasicString< CharType, Alloc > &right)
	Streams the right string to the outstream os . More...
template<class CharType , class Alloc >
std::istream &	operator>> (std::istream &is, BasicString< CharType, Alloc > &right)
	Streams the instream is into the right string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const CharType *left, const BasicString< CharType, Alloc > &right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const CharType left, const BasicString< CharType, Alloc > &right)
	Concatenates the right string to the left character. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const BasicString< CharType, Alloc > &left, const CharType *right)
	Concatenates the right C-string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const BasicString< CharType, Alloc > &left, const CharType right)
	Concatenates the right character to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const BasicString< CharType, Alloc > &left, BasicString< CharType, Alloc > &&right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (BasicString< CharType, Alloc > &&left, const BasicString< CharType, Alloc > &right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (BasicString< CharType, Alloc > &&left, BasicString< CharType, Alloc > &&right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const CharType *left, BasicString< CharType, Alloc > &&right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (const CharType left, BasicString< CharType, Alloc > &&right)
	Concatenates the right string to the left character. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (BasicString< CharType, Alloc > &&left, const CharType *right)
	Concatenates the right string to the left string. More...
template<class CharType , class Alloc >
BasicString< CharType, Alloc >	operator+ (BasicString< CharType, Alloc > &&left, const CharType right)
	Concatenates the right character to the left string. More...
template<class CharType , class Alloc >
bool	operator== (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string on equality. More...
template<class CharType , class Alloc >
bool	operator== (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string on equality. More...
template<class CharType , class Alloc >
bool	operator== (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string on equality. More...
template<class CharType , class Alloc >
bool	operator!= (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string on inequality. More...
template<class CharType , class Alloc >
bool	operator!= (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string on inequality. More...
template<class CharType , class Alloc >
bool	operator!= (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string on inequality. More...
template<class CharType , class Alloc >
bool	operator< (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator< (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator< (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator> (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator> (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator> (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator<= (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator<= (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator<= (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator>= (const BasicString< CharType, Alloc > &left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator>= (const CharType *left, const BasicString< CharType, Alloc > &right)
	Compares the left string to the right string. More...
template<class CharType , class Alloc >
bool	operator>= (const BasicString< CharType, Alloc > &left, const CharType *right)
	Compares the left string to the right string. More...
std::ostream &	operator<< (std::ostream &os, const DateTime &dateTime)
	The ostream operator is used for logging and string formatting and formats the DateTime value in ISO-8601 format. More...
std::istream &	operator>> (std::istream &is, DateTime &dateTime)
	The istream operator is used for string parsing and expects the ISO-8601 format. More...
template<class R , class ... A>
delegate< R(A...)>	make_delegate (R(*const function_ptr)(A...)) noexcept
	Creates a delegate from a static function. More...
template<class C , class R , class ... A>
delegate< R(A...)>	make_delegate (C *const pObject, R(C::*const pMethod)(A...)) noexcept
	Creates a delegate from a member function and object pointer. More...
template<class C , class R , class ... A>
delegate< R(A...)>	make_delegate (C const *const pObject, R(C::*const pMethod)(A...) const) noexcept
	Creates a delegate from a member function and object pointer. More...
template<class C , class R , class ... A>
delegate< R(A...)>	make_delegate (C &object, R(C::*const pMethod)(A...)) noexcept
	Creates a delegate from a const member function and const object reference. More...
template<class C , class R , class ... A>
delegate< R(A...)>	make_delegate (const C &object, R(C::*const pMethod)(A...) const) noexcept
	Creates a delegate from a const member function and const object reference. More...
template<class R , class ... A>
delegate< R(A...)>	make_delegate (std::function< R(A...)> &&f) noexcept
	Creates a delegate from a lambda expression or std::function. More...
template<class R , class ... A>
delegate< R(A...)>	make_delegate (const std::function< R(A...)> &f) noexcept
	Creates a delegate from a lambda expression or std::function. More...
ARP_CXX_SYMBOL_EXPORT std::ostream &	operator<< (std::ostream &os, Endianness value)
ARP_CXX_SYMBOL_EXPORT std::istream &	operator>> (std::istream &is, Endianness &value)
template<class T >
Enum< T >	make_enum (T value)
	Global make function to adapt any enum class by class Enum. More...
template<class T >
std::ostream &	operator<< (std::ostream &os, Enum< T > value)
	Makes the Enum class loggable and streamable. More...
template<class T >
std::istream &	operator>> (std::istream &is, Enum< T > &value)
	Makes the Enum class parsable. More...
template<class T >
Enum< T >	operator| (Enum< T > lhs, Enum< T > rhs)
	Bitwise Or operator for class Enum. More...
template<class T >
Enum< T >	operator& (Enum< T > lhs, Enum< T > rhs)
	Bitwise And operator for class Enum. More...
template<class T >
bool	operator== (Enum< T > lhs, Enum< T > rhs)
	Equality operator of class Enum. More...
template<class T >
bool	operator< (Enum< T > lhs, Enum< T > rhs)
	Less operator for class Enum. More...
template<class T >
bool	operator> (Enum< T > lhs, Enum< T > rhs)
	Greater operator for class Enum. More...
template<class T >
bool	operator<= (Enum< T > lhs, Enum< T > rhs)
	Less or equal operator for class Enum. More...
template<class T >
bool	operator>= (Enum< T > lhs, Enum< T > rhs)
	Greater or equal operator for class Enum. More...
template<class T >
bool	operator== (Enum< T > lhs, T rhs)
	Equality operator of class Enum. More...
template<class T >
bool	operator< (Enum< T > lhs, T rhs)
	Less operator for class Enum. More...
template<class T >
bool	operator> (Enum< T > lhs, T rhs)
	Greater operator for class Enum. More...
template<class T >
bool	operator<= (Enum< T > lhs, T rhs)
	Less or equal operator for class Enum. More...
template<class T >
bool	operator>= (Enum< T > lhs, T rhs)
	Greater or equal operator for class Enum. More...
template<class T >
bool	operator== (T lhs, Enum< T > rhs)
	Equality operator of class Enum. More...
template<class T >
bool	operator< (T lhs, Enum< T > rhs)
	Less operator for class Enum. More...
template<class T >
bool	operator> (T lhs, Enum< T > rhs)
	Greater operator for class Enum. More...
template<class T >
bool	operator<= (T lhs, Enum< T > rhs)
	Less or equal operator for class Enum. More...
template<class T >
bool	operator>= (T lhs, Enum< T > rhs)
	Greater or equal operator for class Enum. More...
template<class T >
ARP_CXX_SYMBOL_EXPORT const char *	GetEnumString (T value)
	This helper function returns the string of the specified enum entry. More...
template<class T >
ARP_CXX_SYMBOL_EXPORT bool	TryGetEnumValue (const char *name, T &value)
	This helper function tries to return the enum entry of the specified string. More...
std::ostream &	operator<< (std::ostream &os, const Exception &e)
	Makes the Exception class loggable and streamable. More...
bool	SecureStrIsNullOrEmpty (const char *str, size_t maxSize)
	Determines if a const char* is nullptr or the string is empty More...
size_t	SecureStrnlen (const char *str, size_t maxSize)
	Warpper for strnlen_s More...
void	SecureStrcpy (char *dest, size_t destMaxSize, const char *src)
	Wrapper for strcpy_s More...
void	SecureStrncpy (char *dest, size_t destMaxSize, const char *src, size_t count)
	Wrapper for strncpy_s More...
template<class T , class TInstance >
bool	IsInstanceOfType (const TInstance &instance)
	Tests if the type of the as argument passed instance is T or derived by T . More...
template<class T , class TInstance >
bool	IsInstanceOfType (const TInstance *pInstance)
	Tests if the type of the as argument passed instance is T or derived by T . More...
template<class T , class TInstance >
bool	IsInstanceOfType (TInstance &instance)
	Tests if the type of the as argument passed instance is T or derived by T . More...
template<class T , class TInstance >
bool	IsInstanceOfType (TInstance *pInstance)
	Tests if the type of the as argument passed instance is T or derived by T . More...
template<class T >
std::ostream &	operator<< (std::ostream &os, const TypeName< T > &typeName)
	Makes the TypeName class loggable and streamable. More...

Detailed Description

Root namespace for the PLCnext API

Enumeration Type Documentation

Endianness

enum Arp::Endianness

strong

This enum defines the endinannes of the target architecture.

Enumerator
None	Not specified.
BigEndian	Determines big endian.
LittleEndian	Determines little endian.
Current	Determines the current endianness.

Function Documentation

GetEnumString()

template<class T >

ARP_CXX_SYMBOL_EXPORT const char* Arp::GetEnumString

(

T

value

)

This helper function returns the string of the specified enum entry.

Template Parameters

T	The type of the enum.

Parameters

value

The enum entry of enum T to get the associated string from.

Returns

The string literal of the as argument passed enum entry.

operator<<() [1/2]

std::ostream& Arp::operator<< ( std::ostream &  os, const Exception &  e  )

inline

Makes the Exception class loggable and streamable.

Parameters

os	The stream to write the exception to.
e	The exception to write.

Returns

The as argument passed stream.

operator<<() [2/2]

template<class T >

std::ostream& Arp::operator<< ( std::ostream &  os, const TypeName< T > &  typeName  )

inline

Makes the TypeName class loggable and streamable.

Parameters

os	The stream to write the typename to.
typeName	The typeName to write.

Returns

The as argument passed stream.

SecureStrcpy()

void Arp::SecureStrcpy	(	char *	dest,
		size_t	destMaxSize,
		const char *	src
	)

Wrapper for strcpy_s

Parameters

dest	pointer to the destination array
destMaxSize	size of the destination array
src	pointer to the source string

On error an Arp::Exception is thrown.

SecureStrIsNullOrEmpty()

bool Arp::SecureStrIsNullOrEmpty	(	const char *	str,
		size_t	maxSize
	)

Determines if a const char* is nullptr or the string is empty

Parameters

str	pointer to the string
maxSize	maximum size of the string

Returns

true if the string is empty or a nullptr

On error an Arp::Exception is thrown.

SecureStrncpy()

void Arp::SecureStrncpy	(	char *	dest,
		size_t	destMaxSize,
		const char *	src,
		size_t	count
	)

Wrapper for strncpy_s

Parameters

dest	pointer to the destination array
destMaxSize	size of the destination array
src	pointer to the source string
count	number of characters to copy

On error an Arp::Exception is thrown.

SecureStrnlen()

size_t Arp::SecureStrnlen	(	const char *	str,
		size_t	maxSize
	)

Warpper for strnlen_s

Parameters

str	pointer to the string
maxSize	maximum size of the string

Returns

length of the string

On error an Arp::Exception is thrown.

TryGetEnumValue()

template<class T >

ARP_CXX_SYMBOL_EXPORT bool Arp::TryGetEnumValue	(	const char *	name,
		T &	value
	)

This helper function tries to return the enum entry of the specified string.

Template Parameters

T	The type of the enum.

Parameters

name	The string to get the associated enum entry of enum T from.
value	The enum entry of enum T associated to the argument passed name .

Returns

true on success, otherwise false.