Represents a name component. More...

#include <ndn-cxx/name-component.hpp>

Inheritance diagram for ndn::name::Component:

Collaboration diagram for ndn::name::Component:

Classes
class	Error

Public Types
using	const_iterator = Buffer::const_iterator

using	element_const_iterator = element_container::const_iterator

using	element_container = std::vector< Block >

using	element_iterator = element_container::iterator

using	value_type = Buffer::value_type

Public Member Functions
	Component (const Block &block)
	Construct a NameComponent from `block`. More...

	Component (ConstBufferPtr buffer)
	Construct a GenericNameComponent, using TLV-VALUE from `buffer`. More...

template<class Iterator >
	Component (Iterator first, Iterator last)
	Construct a GenericNameComponent, copying the TLV-VALUE from a range. More...

	Component (span< const uint8_t > value)
	Construct a GenericNameComponent, copying the TLV-VALUE from `value`. More...

	Component (std::string_view str)
	Construct a GenericNameComponent, copying the TLV-VALUE from a string. More...

	Component (uint32_t type, ConstBufferPtr buffer)
	Construct a NameComponent of TLV-TYPE `type`, using TLV-VALUE from `buffer`. More...

template<class Iterator >
	Component (uint32_t type, Iterator first, Iterator last)
	Construct a NameComponent of TLV-TYPE `type`, copying the TLV-VALUE from a range. More...

	Component (uint32_t type, span< const uint8_t > value)
	Construct a NameComponent of TLV-TYPE `type`, copying the TLV-VALUE from `value`. More...

	Component (uint32_t type=tlv::GenericNameComponent)
	Construct a NameComponent of TLV-TYPE `type` and with empty TLV-VALUE. More...

const_iterator	begin () const
	Returns an iterator to the beginning of the encoded wire. More...

Block	blockFromValue () const
	Return a new Block constructed from the TLV-VALUE of this Block. More...

int	compare (const Component &other) const
	Compare this component to `other` using NDN canonical ordering. More...

const uint8_t *	data () const
	Returns a raw pointer to the beginning of the encoded wire, i.e., the whole TLV. More...

const element_container &	elements () const noexcept
	Get container of sub-elements. More...

element_const_iterator	elements_begin () const noexcept
	Equivalent to `elements().begin()`. More...

element_const_iterator	elements_end () const noexcept
	Equivalent to `elements().end()`. More...

size_t	elements_size () const noexcept
	Equivalent to `elements().size()`. More...

bool	empty () const noexcept

void	encode ()
	Encode sub-elements into TLV-VALUE. More...

const_iterator	end () const
	Returns an iterator past-the-end of the encoded wire. More...

element_iterator	erase (element_const_iterator first, element_const_iterator last)
	Erase a range of sub-elements. More...

element_iterator	erase (element_const_iterator position)
	Erase a sub-element. More...

element_const_iterator	find (uint32_t type) const
	Find the first sub-element of the specified TLV-TYPE. More...

const Block &	get (uint32_t type) const
	Return the first sub-element of the specified TLV-TYPE. More...

ConstBufferPtr	getBuffer () const
	Returns the underlying buffer. More...

Component	getSuccessor () const
	Get the successor of this name component. More...

bool	hasValue () const noexcept
	Check if the Block has a non-empty TLV-VALUE. More...

bool	hasWire () const noexcept
	Check if the Block contains a fully encoded wire representation. More...

element_iterator	insert (element_const_iterator pos, const Block &element)
	Insert a sub-element. More...

bool	isByteOffset () const noexcept
	Check if the component is a byte offset per NDN naming conventions. More...

bool	isGeneric () const noexcept
	Check if the component is a GenericNameComponent. More...

bool	isImplicitSha256Digest () const noexcept
	Check if the component is an ImplicitSha256DigestComponent. More...

bool	isKeyword () const noexcept
	Check if the component is a KeywordNameComponent. More...

bool	isNumber () const noexcept
	Check if the component is a NonNegativeInteger. More...

bool	isNumberWithMarker (uint8_t marker) const noexcept
	Check if the component is a NameComponentWithMarker per NDN naming conventions rev1. More...

bool	isParametersSha256Digest () const noexcept
	Check if the component is a ParametersSha256DigestComponent. More...

bool	isSegment () const noexcept
	Check if the component is a segment number per NDN naming conventions. More...

bool	isSequenceNumber () const noexcept
	Check if the component is a sequence number per NDN naming conventions. More...

bool	isTimestamp () const noexcept
	Check if the component is a timestamp per NDN naming conventions. More...

bool	isValid () const noexcept
	Check if the Block is valid. More...

bool	isVersion () const noexcept
	Check if the component is a version per NDN naming conventions. More...

	operator boost::asio::const_buffer () const
	Implicit conversion to `boost::asio::const_buffer`. More...

void	parse () const
	Parse TLV-VALUE into sub-elements. More...

void	push_back (Block &&element)
	Append a sub-element. More...

void	push_back (const Block &element)
	Append a sub-element. More...

void	remove (uint32_t type)
	Remove all sub-elements of the specified TLV-TYPE. More...

void	reset () noexcept
	Reset the Block to a default-constructed state. More...

void	resetWire () noexcept
	Reset wire buffer but keep TLV-TYPE and sub-elements (if any). More...

size_t	size () const
	Returns the size of the encoded wire, i.e., of the whole TLV. More...

uint64_t	toByteOffset () const
	Interpret as byte offset component using NDN naming conventions. More...

uint64_t	toNumber () const
	Interpret this name component as a NonNegativeInteger. More...

uint64_t	toNumberWithMarker (uint8_t marker) const
	Interpret this name component as a NameComponentWithMarker. More...

uint64_t	toSegment () const
	Interpret as segment number component using NDN naming conventions. More...

uint64_t	toSequenceNumber () const
	Interpret as sequence number component using NDN naming conventions. More...

time::system_clock::time_point	toTimestamp () const
	Interpret as timestamp component using NDN naming conventions. More...

void	toUri (std::ostream &os, UriFormat format=UriFormat::DEFAULT) const
	Write `*this` to the output stream, escaping characters according to the NDN URI format. More...

std::string	toUri (UriFormat format=UriFormat::DEFAULT) const
	Convert `*this` to a string by escaping characters according to the NDN URI format. More...

uint64_t	toVersion () const
	Interpret as version component using NDN naming conventions. More...

uint32_t	type () const noexcept
	Return the TLV-TYPE of the Block. More...

const uint8_t *	value () const noexcept
	Return a raw pointer to the beginning of TLV-VALUE. More...

const_iterator	value_begin () const noexcept
	Get begin iterator of TLV-VALUE. More...

span< const uint8_t >	value_bytes () const noexcept
	Return a read-only view of TLV-VALUE as a contiguous range of bytes. More...

const_iterator	value_end () const noexcept
	Get end iterator of TLV-VALUE. More...

size_t	value_size () const noexcept
	Return the size of TLV-VALUE, i.e., the TLV-LENGTH. More...

void	wireDecode (const Block &wire)
	Decode from TLV wire format. More...

const Block &	wireEncode () const
	Encode to TLV wire format. More...

template<encoding::Tag TAG>
size_t	wireEncode (EncodingImpl< TAG > &encoder) const
	Prepend wire encoding to `encoder`. More...

Static Public Member Functions
static std::tuple< bool, Block >	fromBuffer (ConstBufferPtr buffer, size_t offset=0)
	Try to parse Block from a wire buffer. More...

static std::tuple< bool, Block >	fromBuffer (span< const uint8_t > buffer)
	Try to parse Block from a byte range. More...

static Component	fromByteOffset (uint64_t offset)
	Create a byte offset component using NDN naming conventions. More...

static Component	fromEscapedString (std::string_view input)

static Component	fromNumber (uint64_t number, uint32_t type=tlv::GenericNameComponent)
	Create a component encoded as NonNegativeInteger. More...

static Component	fromNumberWithMarker (uint8_t marker, uint64_t number)
	Create a component encoded as NameComponentWithMarker. More...

static Component	fromSegment (uint64_t segmentNo)
	Create a segment number component using NDN naming conventions. More...

static Component	fromSequenceNumber (uint64_t seqNo)
	Create a sequence number component using NDN naming conventions. More...

static Block	fromStream (std::istream &is)
	Parse Block from an input stream. More...

static Component	fromTimestamp (const time::system_clock::time_point &timePoint)
	Create a timestamp component using NDN naming conventions. More...

static Component	fromUri (std::string_view input)
	Construct a NameComponent from its string representation in NDN URI format. More...

static Component	fromVersion (uint64_t version)
	Create a version component using NDN naming conventions. More...

Protected Attributes
Buffer::const_iterator	m_begin

shared_ptr< const Buffer >	m_buffer
	Underlying buffer storing TLV-VALUE and possibly TLV-TYPE and TLV-LENGTH fields. More...

element_container	m_elements
	Contains the sub-elements. More...

Buffer::const_iterator	m_end

size_t	m_size = 0
	Total size including Type-Length-Value. More...

uint32_t	m_type = tlv::Invalid
	TLV-TYPE. More...

Buffer::const_iterator	m_valueBegin

Buffer::const_iterator	m_valueEnd

Friends
bool	operator< (const Component &lhs, const Component &rhs)

std::ostream &	operator<< (std::ostream &os, const Component &component)

Detailed Description

Represents a name component.

The Component class provides a read-only view of a Block interpreted as a name component. Although it inherits mutation methods from the Block base class, they must not be used, because the enclosing Name would not be updated correctly.

A name component is considered invalid if its TLV-TYPE is outside the range [1, 65535], or, if it is an ImplicitSha256DigestComponent or a ParametersSha256DigestComponent, its TLV-LENGTH is not 32.

Definition at line 112 of file name-component.hpp.

Member Typedef Documentation

◆ const_iterator

using ndn::Block::const_iterator = Buffer::const_iterator

inherited

Definition at line 48 of file block.hpp.

◆ element_const_iterator

using ndn::Block::element_const_iterator = element_container::const_iterator

inherited

Definition at line 51 of file block.hpp.

◆ element_container

using ndn::Block::element_container = std::vector<Block>

inherited

Definition at line 49 of file block.hpp.

◆ element_iterator

using ndn::Block::element_iterator = element_container::iterator

inherited

Definition at line 50 of file block.hpp.

◆ value_type

using ndn::Block::value_type = Buffer::value_type

inherited

Definition at line 47 of file block.hpp.

Constructor & Destructor Documentation

◆ Component() [1/9]

ndn::name::Component::Component ( uint32_t type = tlv::GenericNameComponent )

explicit

Construct a NameComponent of TLV-TYPE type and with empty TLV-VALUE.

Exceptions

Error the NameComponent is invalid.

Definition at line 85 of file name-component.cpp.

◆ Component() [2/9]

ndn::name::Component::Component ( const Block & block )

explicit

Construct a NameComponent from block.

Exceptions

Error the NameComponent is invalid.

Definition at line 91 of file name-component.cpp.

◆ Component() [3/9]

ndn::name::Component::Component	(	uint32_t	type,
		ConstBufferPtr	buffer
	)

Construct a NameComponent of TLV-TYPE type, using TLV-VALUE from buffer.

This constructor does not copy the underlying buffer, but retains a pointer to it. Therefore, the caller must not change the underlying buffer.

Exceptions

Error the NameComponent is invalid.

Definition at line 97 of file name-component.cpp.

◆ Component() [4/9]

ndn::name::Component::Component ( ConstBufferPtr buffer )

inlineexplicit

Construct a GenericNameComponent, using TLV-VALUE from buffer.

This constructor does not copy the underlying buffer, but retains a pointer to it. Therefore, the caller must not change the underlying buffer.

Exceptions

Error the NameComponent is invalid.

Definition at line 155 of file name-component.hpp.

◆ Component() [5/9]

ndn::name::Component::Component	(	uint32_t	type,
		span< const uint8_t >	value
	)

Construct a NameComponent of TLV-TYPE type, copying the TLV-VALUE from value.

Definition at line 103 of file name-component.cpp.

◆ Component() [6/9]

ndn::name::Component::Component ( span< const uint8_t > value )

inlineexplicit

Construct a GenericNameComponent, copying the TLV-VALUE from value.

Definition at line 169 of file name-component.hpp.

◆ Component() [7/9]

template<class Iterator >

ndn::name::Component::Component	(	uint32_t	type,
		Iterator	first,
		Iterator	last
	)

inline

Construct a NameComponent of TLV-TYPE type, copying the TLV-VALUE from a range.

Template Parameters

Iterator an InputIterator dereferencing to a one-octet value type. More efficient implementation is available when it is a RandomAccessIterator.

Parameters

type	the TLV-TYPE.
first	beginning of the range.
last	past-end of the range.

Definition at line 183 of file name-component.hpp.

◆ Component() [8/9]

template<class Iterator >

ndn::name::Component::Component	(	Iterator	first,
		Iterator	last
	)

inline

Construct a GenericNameComponent, copying the TLV-VALUE from a range.

Definition at line 192 of file name-component.hpp.

◆ Component() [9/9]

ndn::name::Component::Component ( std::string_view str )

explicit

Construct a GenericNameComponent, copying the TLV-VALUE from a string.

Bytes from the string are copied as is, and not interpreted as URI component.

Definition at line 109 of file name-component.cpp.

Member Function Documentation

◆ begin()

Block::const_iterator ndn::Block::begin ( ) const

inherited

Returns an iterator to the beginning of the encoded wire.

Precondition: hasWire() == true

Definition at line 275 of file block.cpp.

◆ blockFromValue()

Block ndn::Block::blockFromValue ( ) const

inherited

Return a new Block constructed from the TLV-VALUE of this Block.

Precondition: value_size() > 0

Definition at line 314 of file block.cpp.

◆ compare()

int ndn::name::Component::compare ( const Component & other ) const

Compare this component to other using NDN canonical ordering.

Parameters

other The name component to compare with.

Return values

negative	This component comes before `other` in canonical ordering
zero	This component equals `other`
positive	This component comes after `other` in canonical ordering

See also: https://docs.named-data.net/NDN-packet-spec/0.3/name.html#canonical-order

Definition at line 429 of file name-component.cpp.

◆ data()

const uint8_t * ndn::Block::data ( ) const

inherited

Returns a raw pointer to the beginning of the encoded wire, i.e., the whole TLV.

Precondition: hasWire() == true

See also: value()

Definition at line 256 of file block.cpp.

◆ elements()

const element_container& ndn::Block::elements ( ) const

inlinenoexceptinherited

Get container of sub-elements.

Precondition: parse() has been called.

Definition at line 424 of file block.hpp.

◆ elements_begin()

element_const_iterator ndn::Block::elements_begin ( ) const

inlinenoexceptinherited

Equivalent to elements().begin().

Definition at line 433 of file block.hpp.

◆ elements_end()

element_const_iterator ndn::Block::elements_end ( ) const

inlinenoexceptinherited

Equivalent to elements().end().

Definition at line 442 of file block.hpp.

◆ elements_size()

size_t ndn::Block::elements_size ( ) const

inlinenoexceptinherited

Equivalent to elements().size().

Definition at line 451 of file block.hpp.

◆ empty()

bool ndn::name::Component::empty ( ) const

inlinenoexcept

Definition at line 472 of file name-component.hpp.

◆ encode()

void ndn::Block::encode ( )

inherited

Encode sub-elements into TLV-VALUE.

Postcondition: TLV-VALUE contains sub-elements from elements()

Definition at line 353 of file block.cpp.

◆ end()

Block::const_iterator ndn::Block::end ( ) const

inherited

Returns an iterator past-the-end of the encoded wire.

Precondition: hasWire() == true

Definition at line 284 of file block.cpp.

◆ erase() [1/2]

Block::element_iterator ndn::Block::erase	(	Block::element_const_iterator	first,
		Block::element_const_iterator	last
	)

inherited

Erase a range of sub-elements.

Definition at line 449 of file block.cpp.

◆ erase() [2/2]

Block::element_iterator ndn::Block::erase ( Block::element_const_iterator position )

inherited

Erase a sub-element.

Definition at line 442 of file block.cpp.

◆ find()

Block::element_const_iterator ndn::Block::find ( uint32_t type ) const

inherited

Find the first sub-element of the specified TLV-TYPE.

Precondition: parse() has been called

Returns: iterator in elements() to the found sub-element, or elements_end() if no such sub-element exists in elements()

Definition at line 425 of file block.cpp.

◆ fromBuffer() [1/2]

std::tuple< bool, Block > ndn::Block::fromBuffer	(	ConstBufferPtr	buffer,
		size_t	offset = `0`
	)

staticinherited

Try to parse Block from a wire buffer.

Parameters

buffer	a Buffer containing a TLV element at offset `offset`
offset	begin position of the TLV element within `buffer`

Returns: true and the parsed Block if parsing succeeds; otherwise false and an invalid Block

Note: This function does not throw upon decoding failure.

Definition at line 165 of file block.cpp.

◆ fromBuffer() [2/2]

std::tuple< bool, Block > ndn::Block::fromBuffer ( span< const uint8_t > buffer )

staticinherited

Try to parse Block from a byte range.

Parameters

buffer sequence of bytes containing a TLV element; the element must be found at the beginning of the buffer but does not need to span the entire buffer

Returns: true and the parsed Block if parsing succeeds; otherwise false and an invalid Block

Note: This overload copies the TLV element octets to an internal buffer.; This function does not throw upon decoding failure.

Definition at line 193 of file block.cpp.

◆ fromByteOffset()

Component ndn::name::Component::fromByteOffset ( uint64_t offset )

static

Create a byte offset component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 380 of file name-component.cpp.

◆ fromEscapedString()

static Component ndn::name::Component::fromEscapedString ( std::string_view input )

inlinestatic

Definition at line 235 of file name-component.hpp.

◆ fromNumber()

Component ndn::name::Component::fromNumber	(	uint64_t	number,
		uint32_t	type = `tlv::GenericNameComponent`
	)

static

Create a component encoded as NonNegativeInteger.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/tlv.html#non-negative-integer-encoding

Parameters

number	The non-negative number
type	TLV-TYPE

Definition at line 347 of file name-component.cpp.

◆ fromNumberWithMarker()

Component ndn::name::Component::fromNumberWithMarker	(	uint8_t	marker,
		uint64_t	number
	)

static

Create a component encoded as NameComponentWithMarker.

NameComponentWithMarker is defined as:

NameComponentWithMarker ::= NAME-COMPONENT-TYPE TLV-LENGTH
                              Marker
                              includedNonNegativeInteger
Marker ::= BYTE
includedNonNegativeInteger ::= BYTE{1,2,4,8}

See also: NDN Naming Conventions revision 1 (obsolete) https://named-data.net/wp-content/uploads/2014/08/ndn-tr-22-ndn-memo-naming-conventions.pdf

Parameters

marker	1-byte marker octet
number	The non-negative number

Definition at line 353 of file name-component.cpp.

◆ fromSegment()

Component ndn::name::Component::fromSegment ( uint64_t segmentNo )

static

Create a segment number component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 372 of file name-component.cpp.

◆ fromSequenceNumber()

Component ndn::name::Component::fromSequenceNumber ( uint64_t seqNo )

static

Create a sequence number component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 405 of file name-component.cpp.

◆ fromStream()

Block ndn::Block::fromStream ( std::istream & is )

staticinherited

Parse Block from an input stream.

Exceptions

tlv::Error TLV-LENGTH is zero or exceeds upper bound

Warning: If decoding fails, bytes are still consumed from the input stream.

Definition at line 222 of file block.cpp.

◆ fromTimestamp()

Component ndn::name::Component::fromTimestamp ( const time::system_clock::time_point & timePoint )

static

Create a timestamp component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 396 of file name-component.cpp.

◆ fromUri()

Component ndn::name::Component::fromUri ( std::string_view input )

static

Construct a NameComponent from its string representation in NDN URI format.

Exceptions

Error The input string does not represent a valid NameComponent in NDN URI format.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/name.html#ndn-uri-scheme

Definition at line 139 of file name-component.cpp.

◆ fromVersion()

Component ndn::name::Component::fromVersion ( uint64_t version )

static

Create a version component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 388 of file name-component.cpp.

◆ get()

const Block & ndn::Block::get ( uint32_t type ) const

inherited

Return the first sub-element of the specified TLV-TYPE.

Precondition: parse() has been called

Exceptions

tlv::Error a sub-element of the specified type does not exist

Definition at line 414 of file block.cpp.

◆ getBuffer()

ConstBufferPtr ndn::Block::getBuffer ( ) const

inlineinherited

Returns the underlying buffer.

Definition at line 244 of file block.hpp.

◆ getSuccessor()

Component ndn::name::Component::getSuccessor ( ) const

Get the successor of this name component.

The successor of a name component is defined as follows:

C represents the set of name components, and X,Y ∈ C.
Operator < is defined by canonical order on C.
Y is the successor of X, if (a) X < Y, and (b) ∄ Z ∈ C s.t. X < Z < Y.

In plain words, successor of a name component is the next possible name component.

Examples:

successor of sha256digest=0000000000000000000000000000000000000000000000000000000000000000 is sha256digest=0000000000000000000000000000000000000000000000000000000000000001.
successor of sha256digest=ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff is params-sha256=0000000000000000000000000000000000000000000000000000000000000000.
successor of params-sha256=0000000000000000000000000000000000000000000000000000000000000000 is params-sha256=0000000000000000000000000000000000000000000000000000000000000001.
successor of params-sha256=ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff is 3=....
successor of ... is %00.
successor of A is B.
successor of FF is %00%00.

Definition at line 454 of file name-component.cpp.

◆ hasValue()

bool ndn::Block::hasValue ( ) const

inlinenoexceptinherited

Check if the Block has a non-empty TLV-VALUE.

This property reflects whether the underlying buffer contains a TLV-VALUE. If this is false, TLV-VALUE has zero-length. If this is true, TLV-VALUE may be zero-length.

See also: value_size()

Definition at line 289 of file block.hpp.

◆ hasWire()

bool ndn::Block::hasWire ( ) const

inlinenoexceptinherited

Check if the Block contains a fully encoded wire representation.

A Block has a fully encoded wire if the underlying buffer exists and contains the full Type-Length-Value instead of just the TLV-VALUE field.

Definition at line 205 of file block.hpp.

◆ insert()

Block::element_iterator ndn::Block::insert	(	Block::element_const_iterator	pos,
		const Block &	element
	)

inherited

Insert a sub-element.

Parameters

pos	position of the new sub-element
element	new sub-element to insert

Returns: iterator in elements() to the new sub-element

Definition at line 470 of file block.cpp.

◆ isByteOffset()

bool ndn::name::Component::isByteOffset ( ) const

noexcept

Check if the component is a byte offset per NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 231 of file name-component.cpp.

◆ isGeneric()

bool ndn::name::Component::isGeneric ( ) const

inlinenoexcept

Check if the component is a GenericNameComponent.

See also: https://redmine.named-data.net/projects/ndn-tlv/wiki/NameComponentType

Definition at line 439 of file name-component.hpp.

◆ isImplicitSha256Digest()

bool ndn::name::Component::isImplicitSha256Digest ( ) const

noexcept

Check if the component is an ImplicitSha256DigestComponent.

See also: https://redmine.named-data.net/projects/ndn-tlv/wiki/NameComponentType; https://docs.named-data.net/NDN-packet-spec/0.3/name.html#implicit-digest-component

Definition at line 415 of file name-component.cpp.

◆ isKeyword()

bool ndn::name::Component::isKeyword ( ) const

inlinenoexcept

Check if the component is a KeywordNameComponent.

See also: https://redmine.named-data.net/projects/ndn-tlv/wiki/NameComponentType

Definition at line 465 of file name-component.hpp.

◆ isNumber()

bool ndn::name::Component::isNumber ( ) const

noexcept

Check if the component is a NonNegativeInteger.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/tlv.html#non-negative-integer-encoding

Definition at line 210 of file name-component.cpp.

◆ isNumberWithMarker()

bool ndn::name::Component::isNumberWithMarker ( uint8_t marker ) const

noexcept

Check if the component is a NameComponentWithMarker per NDN naming conventions rev1.

See also: NDN Naming Conventions revision 1 (obsolete) https://named-data.net/wp-content/uploads/2014/08/ndn-tr-22-ndn-memo-naming-conventions.pdf

Definition at line 217 of file name-component.cpp.

◆ isParametersSha256Digest()

bool ndn::name::Component::isParametersSha256Digest ( ) const

noexcept

Check if the component is a ParametersSha256DigestComponent.

See also: https://redmine.named-data.net/projects/ndn-tlv/wiki/NameComponentType; https://docs.named-data.net/NDN-packet-spec/0.3/name.html#parameters-digest-component

Definition at line 421 of file name-component.cpp.

◆ isSegment()

bool ndn::name::Component::isSegment ( ) const

noexcept

Check if the component is a segment number per NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 224 of file name-component.cpp.

◆ isSequenceNumber()

bool ndn::name::Component::isSequenceNumber ( ) const

noexcept

Check if the component is a sequence number per NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 252 of file name-component.cpp.

◆ isTimestamp()

bool ndn::name::Component::isTimestamp ( ) const

noexcept

Check if the component is a timestamp per NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 245 of file name-component.cpp.

◆ isValid()

bool ndn::Block::isValid ( ) const

inlinenoexceptinherited

Check if the Block is valid.

A Block is valid unless it has an invalid TLV-TYPE or is default-constructed. In particular, a Block with zero-length TLV-VALUE is valid.

Definition at line 193 of file block.hpp.

◆ isVersion()

bool ndn::name::Component::isVersion ( ) const

noexcept

Check if the component is a version per NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Definition at line 238 of file name-component.cpp.

◆ operator boost::asio::const_buffer()

ndn::Block::operator boost::asio::const_buffer ( ) const

inherited

Implicit conversion to boost::asio::const_buffer.

Definition at line 478 of file block.cpp.

◆ parse()

void ndn::Block::parse ( ) const

inherited

Parse TLV-VALUE into sub-elements.

Postcondition: elements() reflects sub-elements found in TLV-VALUE

Exceptions

tlv::Error TLV-VALUE is not a sequence of TLV elements

Note: This method does not perform recursive parsing.; This method has no effect if elements() is already populated.; This method is not really const, but it does not modify any data.

Definition at line 326 of file block.cpp.

◆ push_back() [1/2]

void ndn::Block::push_back ( Block && element )

inherited

Append a sub-element.

Definition at line 463 of file block.cpp.

◆ push_back() [2/2]

void ndn::Block::push_back ( const Block & element )

inherited

Append a sub-element.

Definition at line 456 of file block.cpp.

◆ remove()

void ndn::Block::remove ( uint32_t type )

inherited

Remove all sub-elements of the specified TLV-TYPE.

Precondition: parse() has been called

Postcondition: find(type) == elements_end()

Definition at line 432 of file block.cpp.

◆ reset()

void ndn::Block::reset ( )

noexceptinherited

Reset the Block to a default-constructed state.

Equivalent to *this = Block().

Postcondition: isValid() == false

See also: resetWire()

Definition at line 293 of file block.cpp.

◆ resetWire()

void ndn::Block::resetWire ( )

noexceptinherited

Reset wire buffer but keep TLV-TYPE and sub-elements (if any).

Postcondition: hasWire() == false; hasValue() == false

See also: reset()

Definition at line 299 of file block.cpp.

◆ size()

size_t ndn::Block::size ( ) const

inherited

Returns the size of the encoded wire, i.e., of the whole TLV.

Precondition: isValid() == true

See also: value_size()

Definition at line 265 of file block.cpp.

◆ toByteOffset()

uint64_t ndn::name::Component::toByteOffset ( ) const

Interpret as byte offset component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Exceptions

tlv::Error not a ByteOffset component interpreted by the chosen convention(s).

Definition at line 293 of file name-component.cpp.

◆ toNumber()

uint64_t ndn::name::Component::toNumber ( ) const

Interpret this name component as a NonNegativeInteger.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/tlv.html#non-negative-integer-encoding

Returns: The decoded non-negative integer.

Definition at line 261 of file name-component.cpp.

◆ toNumberWithMarker()

uint64_t ndn::name::Component::toNumberWithMarker ( uint8_t marker ) const

Interpret this name component as a NameComponentWithMarker.

See also: NDN Naming Conventions revision 1 (obsolete) https://named-data.net/wp-content/uploads/2014/08/ndn-tr-22-ndn-memo-naming-conventions.pdf

Parameters

marker 1-byte octet of the marker

Returns: The integer number.

Exceptions

Error	if name component does not have the specified marker.
tlv::Error	if format does not follow NameComponentWithMarker specification.

Definition at line 270 of file name-component.cpp.

◆ toSegment()

uint64_t ndn::name::Component::toSegment ( ) const

Interpret as segment number component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Exceptions

tlv::Error not a Segment component interpreted by the chosen convention(s).

Definition at line 281 of file name-component.cpp.

◆ toSequenceNumber()

uint64_t ndn::name::Component::toSequenceNumber ( ) const

Interpret as sequence number component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Exceptions

tlv::Error not a SequenceNumber component interpreted by the chosen convention(s).

Definition at line 333 of file name-component.cpp.

◆ toTimestamp()

time::system_clock::time_point ndn::name::Component::toTimestamp ( ) const

Interpret as timestamp component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Exceptions

tlv::Error not a Timestamp component interpreted by the chosen convention(s).

Definition at line 317 of file name-component.cpp.

◆ toUri() [1/2]

void ndn::name::Component::toUri	(	std::ostream &	os,
		UriFormat	format = `UriFormat::DEFAULT`
	)		const

Write *this to the output stream, escaping characters according to the NDN URI format.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/name.html#ndn-uri-scheme

Definition at line 189 of file name-component.cpp.

◆ toUri() [2/2]

std::string ndn::name::Component::toUri ( UriFormat format = UriFormat::DEFAULT ) const

Convert *this to a string by escaping characters according to the NDN URI format.

See also: https://docs.named-data.net/NDN-packet-spec/0.3/name.html#ndn-uri-scheme

Definition at line 200 of file name-component.cpp.

◆ toVersion()

uint64_t ndn::name::Component::toVersion ( ) const

Interpret as version component using NDN naming conventions.

See also: https://named-data.net/publications/techreports/ndn-tr-22-3-ndn-memo-naming-conventions/

Exceptions

tlv::Error not a Version component interpreted by the chosen convention(s).

Definition at line 305 of file name-component.cpp.

◆ type()

uint32_t ndn::Block::type ( ) const

inlinenoexceptinherited

Return the TLV-TYPE of the Block.

Note: This will return tlv::Invalid if isValid() is false.

Definition at line 275 of file block.hpp.

◆ value()

const uint8_t * ndn::Block::value ( ) const

noexceptinherited

Return a raw pointer to the beginning of TLV-VALUE.

See also: value_bytes(), data()

Definition at line 308 of file block.cpp.

◆ value_begin()

const_iterator ndn::Block::value_begin ( ) const

inlinenoexceptinherited

Get begin iterator of TLV-VALUE.

Precondition: hasValue() == true

Definition at line 328 of file block.hpp.

◆ value_bytes()

span<const uint8_t> ndn::Block::value_bytes ( ) const

inlinenoexceptinherited

Return a read-only view of TLV-VALUE as a contiguous range of bytes.

Definition at line 308 of file block.hpp.

◆ value_end()

const_iterator ndn::Block::value_end ( ) const

inlinenoexceptinherited

Get end iterator of TLV-VALUE.

Precondition: hasValue() == true

Definition at line 338 of file block.hpp.

◆ value_size()

size_t ndn::Block::value_size ( ) const

inlinenoexceptinherited

Return the size of TLV-VALUE, i.e., the TLV-LENGTH.

See also: size()

Definition at line 299 of file block.hpp.

◆ wireDecode()

void ndn::name::Component::wireDecode ( const Block & wire )

Decode from TLV wire format.

Definition at line 498 of file name-component.cpp.

◆ wireEncode() [1/2]

const Block & ndn::name::Component::wireEncode ( ) const

Encode to TLV wire format.

Definition at line 482 of file name-component.cpp.

◆ wireEncode() [2/2]

template<encoding::Tag TAG>

size_t ndn::name::Component::wireEncode ( EncodingImpl< TAG > & encoder ) const

Prepend wire encoding to encoder.

Definition at line 468 of file name-component.cpp.

Friends And Related Function Documentation

◆ operator<

bool operator<	(	const Component &	lhs,
		const Component &	rhs
	)

friend

Definition at line 531 of file name-component.hpp.

◆ operator<<

std::ostream& operator<<	(	std::ostream &	os,
		const Component &	component
	)

friend

Definition at line 537 of file name-component.hpp.

Member Data Documentation

◆ m_begin

Buffer::const_iterator ndn::Block::m_begin

protectedinherited

See also: m_buffer

Definition at line 533 of file block.hpp.

◆ m_buffer

shared_ptr<const Buffer> ndn::Block::m_buffer

protectedinherited

Underlying buffer storing TLV-VALUE and possibly TLV-TYPE and TLV-LENGTH fields.

If m_buffer is nullptr, this is an invalid or zero-length Block with TLV-TYPE given in m_type. Otherwise,

[m_valueBegin, m_valueEnd) point to the TLV-VALUE inside m_buffer.
If m_begin != m_end, [m_begin, m_end) point to Type-Length-Value of this Block in m_buffer. Otherwise, m_buffer does not contain TLV-TYPE and TLV-LENGTH fields.

Definition at line 532 of file block.hpp.

◆ m_elements

element_container ndn::Block::m_elements

mutableprotectedinherited

Contains the sub-elements.

This field is valid only if parse() has been called on the Block instance.

Definition at line 553 of file block.hpp.

◆ m_end

Buffer::const_iterator ndn::Block::m_end

protectedinherited

See also: m_buffer

Definition at line 534 of file block.hpp.

◆ m_size

size_t ndn::Block::m_size = 0

protectedinherited

Total size including Type-Length-Value.

This field is meaningful only if isValid() is true.

Definition at line 546 of file block.hpp.

◆ m_type

uint32_t ndn::Block::m_type = tlv::Invalid

protectedinherited

TLV-TYPE.

Definition at line 539 of file block.hpp.

◆ m_valueBegin

Buffer::const_iterator ndn::Block::m_valueBegin

protectedinherited

See also: m_buffer

Definition at line 536 of file block.hpp.

◆ m_valueEnd

Buffer::const_iterator ndn::Block::m_valueEnd

protectedinherited

See also: m_buffer

Definition at line 537 of file block.hpp.

ndn-cxx: NDN C++ library with eXperimental eXtensions 0.9.0 documentation

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ element_const_iterator

◆ element_container

◆ element_iterator

◆ value_type

Constructor & Destructor Documentation

◆ Component() [1/9]

◆ Component() [2/9]

◆ Component() [3/9]

◆ Component() [4/9]

◆ Component() [5/9]

◆ Component() [6/9]

◆ Component() [7/9]

◆ Component() [8/9]

◆ Component() [9/9]

Member Function Documentation

◆ begin()

◆ blockFromValue()

◆ compare()

◆ data()

◆ elements()

◆ elements_begin()

◆ elements_end()

◆ elements_size()

◆ empty()

◆ encode()

◆ end()

◆ erase() [1/2]

◆ erase() [2/2]

◆ find()

◆ fromBuffer() [1/2]

◆ fromBuffer() [2/2]

◆ fromByteOffset()

◆ fromEscapedString()

◆ fromNumber()

◆ fromNumberWithMarker()

◆ fromSegment()

◆ fromSequenceNumber()

◆ fromStream()

◆ fromTimestamp()

◆ fromUri()

◆ fromVersion()

◆ get()

◆ getBuffer()

◆ getSuccessor()

◆ hasValue()

◆ hasWire()

◆ insert()

◆ isByteOffset()

◆ isGeneric()

◆ isImplicitSha256Digest()

◆ isKeyword()

◆ isNumber()

◆ isNumberWithMarker()

◆ isParametersSha256Digest()

◆ isSegment()

◆ isSequenceNumber()

◆ isTimestamp()

◆ isValid()

◆ isVersion()

◆ operator boost::asio::const_buffer()

◆ parse()

◆ push_back() [1/2]

◆ push_back() [2/2]

◆ remove()

◆ reset()

◆ resetWire()

◆ size()

◆ toByteOffset()

◆ toNumber()

◆ toNumberWithMarker()