ndn::KeyLocator Class Reference

#include <ndn-cxx/key-locator.hpp>

Classes
class	Error

Public Member Functions
	KeyLocator ()
	Construct an empty KeyLocator. More...
	KeyLocator (const Block &wire)
	Construct from wire encoding. More...
	KeyLocator (const Name &name)
	Construct from Name. More...
KeyLocator &	clear ()
	Reset KeyLocator to its default-constructed state. More...
bool	empty () const
const Block &	getKeyDigest () const
	Get nested KeyDigest element. More...
const Name &	getName () const
	Get nested Name element. More...
uint32_t	getType () const
KeyLocator &	setKeyDigest (const Block &keyDigest)
	Set nested KeyDigest element (whole TLV). More...
KeyLocator &	setKeyDigest (const ConstBufferPtr &keyDigest)
	Set nested KeyDigest element value. More...
KeyLocator &	setName (const Name &name)
	Set nested Name element. More...
void	wireDecode (const Block &wire)
	Decode from wire encoding. More...
const Block &	wireEncode () const
template<encoding::Tag TAG>
size_t	wireEncode (EncodingImpl< TAG > &encoder) const
	Prepend wire encoding to encoder. More...

Friends
bool	operator!= (const KeyLocator &lhs, const KeyLocator &rhs)
std::ostream &	operator<< (std::ostream &, const KeyLocator &)
bool	operator== (const KeyLocator &lhs, const KeyLocator &rhs)

Detailed Description

Definition at line 30 of file key-locator.hpp.

Constructor & Destructor Documentation

KeyLocator() [1/3]

ndn::KeyLocator::KeyLocator ( )

default

Construct an empty KeyLocator.

Postcondition

empty() == true

KeyLocator() [2/3]

ndn::KeyLocator::KeyLocator

(

const Name &

name

)

Construct from Name.

Note

Implicit conversion is permitted.

Postcondition

getType() == tlv::Name

Definition at line 46 of file key-locator.cpp.

KeyLocator() [3/3]

ndn::KeyLocator::KeyLocator ( const Block &  wire )

explicit

Construct from wire encoding.

Definition at line 41 of file key-locator.cpp.

Member Function Documentation

clear()

KeyLocator & ndn::KeyLocator::clear

(

)

Reset KeyLocator to its default-constructed state.

Postcondition

empty() == true

getType() == tlv::Invalid

Returns

self

Definition at line 136 of file key-locator.cpp.

empty()

bool ndn::KeyLocator::empty ( ) const

inline

Definition at line 75 of file key-locator.hpp.

getKeyDigest()

const Block & ndn::KeyLocator::getKeyDigest

(

)

const

Get nested KeyDigest element.

Exceptions

Error

if type is not tlv::KeyDigest

Definition at line 163 of file key-locator.cpp.

getName()

const Name & ndn::KeyLocator::getName

(

)

const

Get nested Name element.

Exceptions

Error

if type is not tlv::Name

Definition at line 144 of file key-locator.cpp.

getType()

uint32_t ndn::KeyLocator::getType

(

)

const

Definition at line 119 of file key-locator.cpp.

setKeyDigest() [1/2]

KeyLocator & ndn::KeyLocator::setKeyDigest

(

const Block &

keyDigest

)

Set nested KeyDigest element (whole TLV).

Postcondition

getType() == tlv::KeyDigest

Exceptions

std::invalid_argument

Block type is not tlv::KeyDigest

Returns

self

Definition at line 174 of file key-locator.cpp.

setKeyDigest() [2/2]

KeyLocator & ndn::KeyLocator::setKeyDigest

(

const ConstBufferPtr &

keyDigest

)

Set nested KeyDigest element value.

Parameters

keyDigest

buffer to use as TLV-VALUE of the nested KeyDigest element.

Postcondition

getType() == tlv::KeyDigest

Returns

self

Definition at line 185 of file key-locator.cpp.

setName()

KeyLocator & ndn::KeyLocator::setName

(

const Name &

name

)

Set nested Name element.

Postcondition

getType() == tlv::Name

Returns

self

Definition at line 155 of file key-locator.cpp.

wireDecode()

void ndn::KeyLocator::wireDecode

(

const Block &

wire

)

Decode from wire encoding.

Exceptions

Error

outer TLV type is not KeyLocator

Note

No error is raised for an unrecognized nested TLV, but attempting to reencode will throw.

Definition at line 91 of file key-locator.cpp.

wireEncode() [1/2]

const Block & ndn::KeyLocator::wireEncode

(

)

const

Definition at line 75 of file key-locator.cpp.

wireEncode() [2/2]

template<encoding::Tag TAG>

size_t ndn::KeyLocator::wireEncode

(

EncodingImpl< TAG > &

encoder

)

const

Prepend wire encoding to encoder.

Definition at line 53 of file key-locator.cpp.

Friends And Related Function Documentation

operator!=

bool operator!= ( const KeyLocator &  lhs, const KeyLocator &  rhs  )

friend

Definition at line 137 of file key-locator.hpp.

operator<<

std::ostream& operator<< ( std::ostream &  , const KeyLocator &    )

friend

Definition at line 193 of file key-locator.cpp.

operator==

bool operator== ( const KeyLocator &  lhs, const KeyLocator &  rhs  )

friend

Definition at line 131 of file key-locator.hpp.