PASNObject Class Reference

#include <pasn.h>

Inheritance diagram for PASNObject:

List of all members.

Public Types
enum	ASNType {   Integer, String, ObjectID, Sequence,   Choice, IPAddress, Counter, Gauge,   TimeTicks, Opaque, NsapAddress, Counter64,   UInteger32, Null, Unknown, ASNTypeMax }
Public Member Functions
virtual ASNType	GetType () const
int	GetChoice () const
virtual PString	GetTypeAsString () const
virtual PASNInt	GetInteger () const
virtual PASNUnsigned	GetUnsigned () const
virtual PString	GetString () const
virtual const PASNSequence &	GetSequence () const
virtual PIPSocket::Address	GetIPAddress () const
virtual void	PrintOn (ostream &strm) const
virtual void	Encode (PBYTEArray &buffer)
virtual WORD	GetEncodedLength ()
virtual PObject *	Clone () const
Static Public Member Functions
static void	EncodeASNLength (PBYTEArray &buffer, WORD length)
static WORD	GetASNLengthLength (WORD length)
static BOOL	DecodeASNLength (const PBYTEArray &buffer, PINDEX &ptr, WORD &len)
static void	EncodeASNSequenceStart (PBYTEArray &buffer, BYTE type, WORD length)
static WORD	GetASNSequenceStartLength (WORD length)
static void	EncodeASNHeader (PBYTEArray &buffer, PASNObject::ASNType type, WORD length)
static WORD	GetASNHeaderLength (WORD length)
static void	EncodeASNInteger (PBYTEArray &buffer, PASNInt data, PASNObject::ASNType type)
static void	EncodeASNUnsigned (PBYTEArray &buffer, PASNUnsigned data, PASNObject::ASNType type)
static WORD	GetASNIntegerLength (PASNInt data)
static WORD	GetASNUnsignedLength (PASNUnsigned data)
static BOOL	DecodeASNInteger (const PBYTEArray &buffer, PINDEX &ptr, PASNInt &value, ASNType type=Integer)
static BOOL	DecodeASNUnsigned (const PBYTEArray &buffer, PINDEX &ptr, PASNUnsigned &value, ASNType type=TimeTicks)
Protected Member Functions
	PASNObject ()
Static Protected Attributes
static BYTE	ASNTypeToType [ASNTypeMax]

---

Detailed Description

This class defines the common behviour of all ASN objects. It also contains several functions which are used for encoding common ASN primitives.

This class will never be instantiated directly. See the PASNInteger, PASNSequence, PASNString and PASNObjectID classes for examples of ASN objects that can be created.

Only descendants of this class can be put into the ASNSequence class.

---

Member Enumeration Documentation

enum PASNObject::ASNType

Value returned by the GetType() function to indicate the type of an ASN object

Enumerator:

Integer	ASN Integer object.
String	ASN Octet String object.
ObjectID	ASN Object ID object.
Sequence	ASN Sequence object.
Choice	ASN Sequence with discriminator.
IPAddress	ASN IPAddress object.
Counter	ASN Counter object.
Gauge	ASN Gauge object.
TimeTicks	ASN TimeTicks object.
Opaque	ASN Opaque object.
NsapAddress	ASN NsapAddress.
Counter64	ASN Counter64.
UInteger32	ASN Unsigned integer 32.
Null	ASN Null.
Unknown	unknown ASN object type
ASNTypeMax	maximum of number of ASN object types

---

Constructor & Destructor Documentation

PASNObject::PASNObject

(

)

[protected]

Create an empty ASN object. Used only by descendant constructors

---

Member Function Documentation

virtual ASNType PASNObject::GetType

(

)

const [virtual]

Return a value of type enum ASNType which indicates the type of the object

Reimplemented in PASNInteger, PASNString, PASNIPAddress, PASNTimeTicks, PASNCounter, PASNGauge, PASNObjectID, PASNNull, and PASNSequence.

int PASNObject::GetChoice

(

)

const

Return the descriminator for Choice sequences

Reimplemented in PASNSequence.

virtual PString PASNObject::GetTypeAsString

(

)

const [virtual]

Return a string giving the type of the object

Reimplemented in PASNInteger, PASNString, PASNIPAddress, PASNTimeTicks, PASNCounter, PASNGauge, PASNObjectID, PASNNull, and PASNSequence.

virtual PASNInt PASNObject::GetInteger

(

)

const [virtual]

Return the value of the ASN object as a PASNInt.

This function will assert if the object is not a descendant of PASNInteger.

Reimplemented in PASNInteger.

virtual PASNUnsigned PASNObject::GetUnsigned

(

)

const [virtual]

Return the value of the object as a PASNUnsigned

This function will assert if the object is not a descendant of PASNTimeTicks or

PASNCounter.

Reimplemented in PASNUnsignedInteger.

virtual PString PASNObject::GetString

(

)

const [virtual]

Return the value of the object as a PString. This function can be use for all ASN object types

Reimplemented in PASNInteger, PASNString, PASNIPAddress, PASNUnsignedInteger, PASNObjectID, and PASNNull.

virtual const PASNSequence& PASNObject::GetSequence

(

)

const [virtual]

Return the value of the object as a PString

This function will assert if the object is not a descendant of PASNSequence.

Reimplemented in PASNSequence.

virtual PIPSocket::Address PASNObject::GetIPAddress

(

)

const [virtual]

Return the value of the object as an IPAddress

This function will assert if the object is not a descendant of PASNIPAddress.

Reimplemented in PASNIPAddress.

virtual void PASNObject::PrintOn

(

ostream &

strm

)

const [virtual]

Virtual functions used by the PObject::operator<< function to print the value of the object.

Parameters:

strm	stream to print on

Reimplemented from PObject.

Reimplemented in PASNInteger, PASNString, PASNUnsignedInteger, PASNObjectID, PASNNull, and PASNSequence.

virtual void PASNObject::Encode

(

PBYTEArray &

buffer

)

[virtual]

Virtual function used to encode the object into ASN format

Parameters:

buffer

buffer to encode into

Reimplemented in PASNInteger, PASNString, PASNIPAddress, PASNTimeTicks, PASNCounter, PASNGauge, PASNObjectID, PASNNull, and PASNSequence.

virtual WORD PASNObject::GetEncodedLength

(

)

[virtual]

Virtual function used to get the length of object when encoded into ASN format

Reimplemented in PASNInteger, PASNString, PASNUnsignedInteger, PASNObjectID, PASNNull, and PASNSequence.

virtual PObject* PASNObject::Clone

(

)

const [virtual]

Virtual function used to duplicate objects

Reimplemented from PObject.

Reimplemented in PASNInteger, PASNString, PASNIPAddress, PASNTimeTicks, PASNCounter, PASNGauge, PASNObjectID, and PASNNull.

static void PASNObject::EncodeASNLength	(	PBYTEArray &	buffer,
		WORD	length
	)			[static]

Encode an ASN length value

Parameters:

buffer	buffer to encode into
length	ASN length to encode

static WORD PASNObject::GetASNLengthLength

(

WORD

length

)

[static]

Return the length of an encoded ASN length value

Parameters:

length

length to find length of

static BOOL PASNObject::DecodeASNLength	(	const PBYTEArray &	buffer,
		PINDEX &	ptr,
		WORD &	len
	)			[static]

Decode an ASN length in the buffer at the given ptr. The ptr is moved to the byte after the end of the encoded length.

Parameters:

buffer	buffer to decode data from
ptr	ptr to decode from
len	returned length

static void PASNObject::EncodeASNSequenceStart	(	PBYTEArray &	buffer,
		BYTE	type,
		WORD	length
	)			[static]

Encode a sequence header into the buffer at the specified offset.

Parameters:

buffer	buffer to encode data into
type	sequence type
length	length of sequence data

static WORD PASNObject::GetASNSequenceStartLength

(

WORD

length

)

[static]

Return the encoded length of a sequence if it has the specified length

Parameters:

length

length of sequence data

static void PASNObject::EncodeASNHeader	(	PBYTEArray &	buffer,
		PASNObject::ASNType	type,
		WORD	length
	)			[static]

Encode an ASN object header into the buffer

Parameters:

buffer	buffer to encode into
type	ASN type of the object
length	length of the object

static WORD PASNObject::GetASNHeaderLength

(

WORD

length

)

[static]

Return the length of an ASN object header if the object is the specified length

Parameters:

length

length of object

static void PASNObject::EncodeASNInteger	(	PBYTEArray &	buffer,
		PASNInt	data,
		PASNObject::ASNType	type
	)			[static]

Parameters:

buffer	buffer to encode into
data	value to encode
type	actual integer type

static void PASNObject::EncodeASNUnsigned	(	PBYTEArray &	buffer,
		PASNUnsigned	data,
		PASNObject::ASNType	type
	)			[static]

Parameters:

buffer	buffer to encode into
data	value to encode
type	actual integer type

static WORD PASNObject::GetASNIntegerLength

(

PASNInt

data

)

[static]

Parameters:

data	value to get length of

static WORD PASNObject::GetASNUnsignedLength

(

PASNUnsigned

data

)

[static]

Parameters:

data	value to get length of

static BOOL PASNObject::DecodeASNInteger	(	const PBYTEArray &	buffer,
		PINDEX &	ptr,
		PASNInt &	value,
		ASNType	type = Integer
	)			[static]

Parameters:

buffer	buffer to decode from
ptr	ptr to data in buffer
value	returned value
type	actual integer type

static BOOL PASNObject::DecodeASNUnsigned	(	const PBYTEArray &	buffer,
		PINDEX &	ptr,
		PASNUnsigned &	value,
		ASNType	type = TimeTicks
	)			[static]

Parameters:

buffer	buffer to decode from
ptr	ptr to data in buffer
value	returned value
type	actual integer type

---

Member Data Documentation

BYTE PASNObject::ASNTypeToType[ASNTypeMax] [static, protected]

Table to map enum ASNType values to ASN identifiers

---

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

• pasn.h

---