#include <PdfDictionary.h>

Inheritance diagram for PoDoFo::PdfDictionary:

Public Member Functions
	PdfDictionary ()

	PdfDictionary (const PdfDictionary &rhs)

PdfDictionary &	operator= (const PdfDictionary &rhs)

bool	operator== (const PdfDictionary &rhs) const

bool	operator!= (const PdfDictionary &rhs) const

void	Clear ()

PdfObject &	AddKey (const PdfName &key, const PdfObject &obj)

void	AddKeyIndirect (const PdfName &key, const PdfObject &obj)

PdfObject &	AddKeyIndirectSafe (const PdfName &key, const PdfObject &obj)

const PdfObject *	GetKey (const std::string_view &key) const

PdfObject *	GetKey (const std::string_view &key)

const PdfObject *	FindKey (const std::string_view &key) const

const PdfObject *	FindKeyParent (const std::string_view &key) const

const PdfObject &	MustGetKey (const std::string_view &key) const

bool	HasKey (const std::string_view &key) const

bool	RemoveKey (const std::string_view &key)

void	Write (OutputStream &stream, PdfWriteFlags writeMode, const PdfStatefulEncrypt &encrypt, charbuff &buffer) const override

unsigned	GetSize () const

Public Member Functions inherited from PoDoFo::PdfDataContainer
const PdfObject *	GetOwner () const

Public Member Functions inherited from PoDoFo::PdfDataProvider
std::string	ToString () const

Additional Inherited Members
Protected Member Functions inherited from PoDoFo::PdfDataContainer
	PdfDataContainer ()

Protected Member Functions inherited from PoDoFo::PdfDataProvider
	PdfDataProvider ()

Detailed Description

The PDF dictionary data type of PoDoFo (inherits from PdfDataContainer, the base class for such representations) Note: manipulation function accepts PdfName for the key, while getters accept std::string_view. This is an optimization since we do lookup with both types. We also assume doing lookups with strings will only use characters compatible with PdfDocEncoding

Constructor & Destructor Documentation

◆ PdfDictionary() [1/2]

PdfDictionary::PdfDictionary ( )

Create a new, empty dictionary

◆ PdfDictionary() [2/2]

PdfDictionary::PdfDictionary ( const PdfDictionary & rhs )

Deep copy a dictionary

Parameters

rhs	the PdfDictionary to copy

Member Function Documentation

◆ AddKey()

PdfObject & PdfDictionary::AddKey	(	const PdfName &	key,
		const PdfObject &	obj )

Add a key to the dictionary. If an existing key of this name exists, its value is replaced and the old value object will be deleted. The given object is copied.

This will set the dirty flag of this object.

See also: IsDirty

Parameters

key	the key is identified by this name in the dictionary
obj	object containing the data. The object is copied.

◆ AddKeyIndirect()

void PdfDictionary::AddKeyIndirect	(	const PdfName &	key,
		const PdfObject &	obj )

Add a key to the dictionary. If an existing key of this name exists, its value is replaced and the old value object will be deleted. The object must be indirect and the object reference will be added instead to the dictionary

This will set the dirty flag of this object.

See also: IsDirty

Parameters

key	the key is identified by this name in the dictionary
obj	object containing the data

Exceptions

PdfError::InvalidHandle on nullptr obj or if the object can't be added as an indirect reference

◆ AddKeyIndirectSafe()

PdfObject & PdfDictionary::AddKeyIndirectSafe	(	const PdfName &	key,
		const PdfObject &	obj )

Add a key to the dictionary. If an existing key of this name exists, its value is replaced and the old value object will be deleted. If the object is indirect the object reference will be added instead to the dictionary, otherwise the object is copied

This will set the dirty flag of this object.

See also: IsDirty

Parameters

key	the key is identified by this name in the dictionary
obj	a variant object containing the data

Exceptions

PdfError::InvalidHandle on nullptr obj

◆ Clear()

void PdfDictionary::Clear ( )

Removes all keys from the dictionary

◆ FindKey()

const PdfObject * PoDoFo::PdfDictionary::FindKey ( const std::string_view & key ) const

Get the keys value out of the dictionary

Lookup in the indirect objects as well, if the shallow object was a reference. The returned value is a pointer to the internal object in the dictionary so it MUST not be deleted.

Parameters

key	look for the key names key in the dictionary

Returns: pointer to the found value or 0 if the key was not found.

◆ FindKeyParent()

const PdfObject * PoDoFo::PdfDictionary::FindKeyParent ( const std::string_view & key ) const

Get the keys value out of the dictionary

Lookup in the indirect objects as well, if the shallow object was a reference. Also lookup the parent objects, if /Parent key is found in the dictionary. The returned value is a pointer to the internal object in the dictionary so it MUST not be deleted.

Parameters

key	look for the key names key in the dictionary

Returns: pointer to the found value or 0 if the key was not found.

◆ GetKey() [1/2]

PdfObject * PoDoFo::PdfDictionary::GetKey ( const std::string_view & key )

Get the key's value out of the dictionary. This is an overloaded member function.

The returned value is a pointer to the internal object in the dictionary. It may be modified but is still owned by the dictionary so it MUST not be deleted.

Parameters

key	look for the key named key in the dictionary

Returns: the found value, or 0 if the key was not found.

◆ GetKey() [2/2]

const PdfObject * PoDoFo::PdfDictionary::GetKey ( const std::string_view & key ) const

Get the key's value out of the dictionary.

The returned value is a pointer to the internal object in the dictionary so it MUST not be deleted.

Parameters

key	look for the key named key in the dictionary

Returns: pointer to the found value, or 0 if the key was not found.

◆ GetSize()

unsigned PdfDictionary::GetSize ( ) const

Returns: the size of the internal map

◆ HasKey()

bool PdfDictionary::HasKey ( const std::string_view & key ) const

Allows to check if a dictionary contains a certain key.

Parameters

key	look for the key named key.Name() in the dictionary

Returns: true if the key is part of the dictionary, otherwise false.

◆ MustGetKey()

const PdfObject & PoDoFo::PdfDictionary::MustGetKey ( const std::string_view & key ) const

Get the key's value out of the dictionary.

The returned value is a reference to the internal object in the dictionary so it MUST not be deleted. If the key is not found, this throws a PdfError exception with error code PdfErrorCode::NoObject, instead of returning. This is intended to make code more readable by sparing (especially multiple) nullptr checks.

Parameters

key	look for the key named key in the dictionary

Returns: reference to the found value (never 0).

Exceptions

PdfError(PdfErrorCode::NoObject).

◆ operator!=()

bool PdfDictionary::operator!= ( const PdfDictionary & rhs ) const

See also: operator==

◆ operator=()

PdfDictionary & PdfDictionary::operator= ( const PdfDictionary & rhs )

Assignment operator. Assign another PdfDictionary to this dictionary. This is a deep copy; all elements of the source dictionary are duplicated.

Parameters

rhs	the PdfDictionary to copy.

Returns: this PdfDictionary

This will set the dirty flag of this object.

See also: IsDirty

◆ operator==()

bool PdfDictionary::operator== ( const PdfDictionary & rhs ) const

Comparison operator. If this dictionary contains all the same keys as the other dictionary, and for each key the values compare equal, the dictionaries are considered equal.

◆ RemoveKey()

bool PdfDictionary::RemoveKey ( const std::string_view & key )

Remove a key from this dictionary. If the key does not exist, this function does nothing.

Parameters

key	the name of the key to delete

Returns: true if the key was found in the object and was removed. If there was no key with this name, false is returned.

This will set the dirty flag of this object.

See also: IsDirty

◆ Write()

void PdfDictionary::Write	(	OutputStream &	stream,
		PdfWriteFlags	writeMode,
		const PdfStatefulEncrypt &	encrypt,
		charbuff &	buffer ) const

overridevirtual

Write the complete datatype to a file.

Parameters

device	write the object to this device
writeMode	additional options for writing this object
encrypt	an encryption object which is used to encrypt this object or nullptr to not encrypt this object

Implements PoDoFo::PdfDataProvider.

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

PdfDictionary.h
PdfDictionary.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PdfDictionary() [1/2]

◆ PdfDictionary() [2/2]

Member Function Documentation

◆ AddKey()

◆ AddKeyIndirect()

◆ AddKeyIndirectSafe()

◆ Clear()

◆ FindKey()

◆ FindKeyParent()

◆ GetKey() [1/2]

◆ GetKey() [2/2]

◆ GetSize()

◆ HasKey()

◆ MustGetKey()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ RemoveKey()

◆ Write()