SetaPDF_Core_Type_HexString Class representing a hexadecimal string

File: /SetaPDF v2/Core/Type/HexString.php

Class hierarchy

Implements

Summary

Static Properties

$_filter

A singleton AsciiHex filter instance


Properties

$_bypassSecHandler

Flag indicating that the object should bypass the security handler

$_encrypted

protected boolean SetaPDF_Core_Type_HexString::$_encrypted = false

Flag indicating if the string is currently encrypted

$_observed

Defines if this object is under observation

$_observers

protected array SetaPDF_Core_Type_AbstractType::$_observers = array()

The Objects to notify on any change

This will be the PDF document or another value holding this one. Initially this will be an array.

$_owningObject

$_value

protected string SetaPDF_Core_Type_HexString::$_value = ''

The value


Static Methods

_ensureType()

protected static SetaPDF_Core_Type_AbstractType::_ensureType (
string $type, mixed $value, string $errorMessage [, $ensure = true ]
): mixed

Ensure that a value is an instance of a specific PDF type.

Parameters
$type : string
 
$value : mixed
 
$errorMessage : string
 
$ensure
 
Exceptions

Throws SetaPDF_Core_Type_Exception

_getFilter()

Singleton method to get an AsciiHex filter instance.

ensureType()

Ensures that the passed value is a SetaPDF_Core_Type_HexString instance.

Parameters
$hexString : mixed
 
Exceptions

Throws SetaPDF_Core_Type_Exception

ensureWithType()

Ensures that the passed value is an instance of the passed type.

Parameters
$type : string
 
$value : mixed
 
Exceptions

Throws SetaPDF_Core_Type_Exception

hex2str()

public static SetaPDF_Core_Type_HexString::hex2str (
string $hex
): string

Converts a hex encoded string to a normal string.

Parameters
$hex : string
 

is()

public static SetaPDF_Core_Type_AbstractType::is (
string $type, mixed $value [, bool $ensure = true ]
): bool

Checks if the type of a value is the expected one.

Indirect references will be evaluated if $ensure is set to true.

Parameters
$type : string
 
$value : mixed
 
$ensure : bool
 

str2hex()

public static SetaPDF_Core_Type_HexString::str2hex (
string $str
): string

Converts a string to a hex encoded string.

Parameters
$str : string
 

writePdfString()

public static SetaPDF_Core_Type_HexString::writePdfString (
SetaPDF_Core_WriteInterface $writer, string $value [, boolean $fromString = true ]
): string|void

Writes a string as hex encoded string to a writer instance.

Parameters
$writer : SetaPDF_Core_WriteInterface
 
$value : string
 
$fromString : boolean

Convert the string to hex encoded string

Exceptions

Throws InvalidArgumentException

See

Methods

__construct()

public SetaPDF_Core_Type_HexString::__construct (
[ string $value = null [, boolean $fromString = true [, SetaPDF_Core_Type_AbstractType $owningObject = null ]]]
)

The constructor.

Parameters
$value : string
 
$fromString : boolean
 
$owningObject : SetaPDF_Core_Type_AbstractType
 

__clone()

Implementation of __clone().

__sleep()

public SetaPDF_Core_Type_AbstractType::__sleep (
void
): array

Implementation of __sleep.

We remove the observers from all elements because they will get read if they are waked up in an observed object.

_decrypt()

protected SetaPDF_Core_Type_HexString::_decrypt (
void
): string

Decrypts the value.

attach()

Add an observer to the object.

Implementation of the Observer Pattern.

Parameters
$observer : SplObserver
 

cleanUp()

deepClone()

Clone the object recursively in the context of a document.

Parameters
$document : SetaPDF_Core_Document
 

detach()

Detach an observer from the object.

Implementation of the Observer Pattern.

Parameters
$observer : SplObserver
 

detachAll()

Detach all observers from this object.

Be careful with this method!!!

ensure()

public SetaPDF_Core_Type_AbstractType::ensure (
[ bool|null $forceObservation = null ]
): SetaPDF_Core_Type_AbstractType

Returns the main value.

This method is used for automatically resolving of indirect references.

Parameters
$forceObservation : bool|null
 

getValue()

public SetaPDF_Core_Type_HexString::getValue (
[ boolean $asString = true ]
): string

Get the value.

If $asString is set to true the value will be passed to the hex2str() method before it is returned.

Parameters
$asString : boolean
 

isObserved()

Checks if this object is observed.

notify()

public SetaPDF_Core_Type_AbstractType::notify (
void
): void

Notifies all attached observers.

Implementation of the Observer Pattern.

Has to be called by any method that changes a value.

setBypassSecHandler()

public SetaPDF_Core_Type_HexString::setBypassSecHandler (
[ boolean $bypassSecHandler = true ]
): void

Bypass the security handler or not.

Parameters
$bypassSecHandler : boolean
 

setValue()

public SetaPDF_Core_Type_HexString::setValue (
string $value [, boolean $fromString = true ]
): void

Set the value.

Parameters
$value : string
 
$fromString : boolean
 

toPdfString()

public SetaPDF_Core_Type_HexString::toPdfString (
[ SetaPDF_Core_Document|null $pdfDocument = null ]
): string

Returns the type as a formatted PDF string.

Parameters
$pdfDocument : SetaPDF_Core_Document|null
 

toPhp()

public SetaPDF_Core_Type_HexString::toPhp (
void
): string

Converts the PDF data type to a PHP data type and returns it.

See

writeTo()

Writes the type as a formatted PDF string to the document.

Parameters
$pdfDocument : SetaPDF_Core_Document