pfSense-pkg-RESTAPI

HexValidator extends Validator
in package

Defines a Validator that checks if a given value is a valid hexadecimal value.

Table of Contents

Constants

HEX_PREFIX  = '0x'

Properties

$allow_hex_prefix  : bool
$bytes  : int
$field_context  : Field|null
$model_context  : Model|null
$expected_length  : int

Methods

__construct()  : mixed
Constructs the HexValidator object.
get_class_fqn()  : string
Obtains the fully qualified name of the called class.
get_class_shortname()  : string
Obtains the shortname of the called class.
get_classes_in_namespace()  : array<string|int, mixed>
Obtains all classes associated with this class's current namespace.
log_error()  : void
Logs an error to the syslog.
validate()  : void
Checks if a given value is a valid hexadecimal value of the provide byte length.
set_label()  : mixed
Sets a label on the assigned $field_context if present.

Constants

HEX_PREFIX

public mixed HEX_PREFIX = '0x'
Tags
const

Stores the hexadecimal prefix value 0x

Properties

$field_context

public Field|null $field_context = null

The parent Model Field object that called this Validator.

$model_context

public Model|null $model_context = null

The parent Model object that called this Validator.

$expected_length

private int $expected_length

The maximum character length the hexadecimal value can have. This value is determined by the assigned $bytes value. This is generally twice the $bytes value.

Methods

__construct()

Constructs the HexValidator object.

public __construct(int $bytes[, bool $allow_hex_prefix = true ]) : mixed
Parameters
$bytes : int

The expected byte length of the hexadecimal value. Set to 0 to allow hex values of any length.

$allow_hex_prefix : bool = true

Set to true to allow the hex prefix (0x) to be present in the value.

get_class_fqn()

Obtains the fully qualified name of the called class.

public get_class_fqn() : string
Return values
string

The FQN for this object's class.

get_class_shortname()

Obtains the shortname of the called class.

public get_class_shortname() : string
Return values
string

The shortname for this object's class.

get_classes_in_namespace()

Obtains all classes associated with this class's current namespace.

public get_classes_in_namespace([bool $shortnames = false ]) : array<string|int, mixed>
Parameters
$shortnames : bool = false
Return values
array<string|int, mixed>

An array of classes currently in this object's namespace

log_error()

Logs an error to the syslog.

public static log_error(string $message) : void
Parameters
$message : string

The error message to write to the syslog

validate()

Checks if a given value is a valid hexadecimal value of the provide byte length.

public validate(mixed $value[, string $field_name = '' ]) : void
Parameters
$value : mixed

The incoming value to be validated.

$field_name : string = ''

The name of the field being validated.

Tags
throws
ValidationError

When the $value is greater than or less than $this->maximum_length.

throws
ValidationError

When the $value is not a hexadecimal string.

set_label()

Sets a label on the assigned $field_context if present.

protected set_label(string $label_name) : mixed
Parameters
$label_name : string

The label to assign to the Field context object


        
On this page

Search results