Documentation

DomainHostInterface extends Countable, HostInterface, IteratorAggregate
in

Tags
extends

Table of Contents

Methods

__toString()  : string
Returns the instance string representation.
append()  : self
Appends a label to the host.
count()  : int
Returns the labels total number.
get()  : string|null
Retrieves a single host label.
getIp()  : string|null
Returns the IP component If the Host is an IP address.
getIpVersion()  : string|null
Returns the IP version.
getIterator()  : Iterator<string|int, string>
Iterate over the Domain labels.
getUriComponent()  : string
Returns the instance string representation with its optional URI delimiters.
isAbsolute()  : bool
Tells whether the domain is absolute.
isDomain()  : bool
Tells whether the host is a domain name.
isIp()  : bool
Tells whether the host is an IP Address.
isRegisteredName()  : bool
Tells whether the host is a registered name.
jsonSerialize()  : string|null
Returns the instance json representation.
keys()  : array<string|int, int>
Returns the associated key for a specific label or all the keys.
prepend()  : self
Prepends a label to the host.
slice()  : self
Extracts a slice of $length elements starting at position $offset from the host.
toAscii()  : string|null
Returns the ascii representation.
toString()  : string
Returns the instance string representation.
toUnicode()  : string|null
Returns the unicode representation.
value()  : string|null
Returns the instance string representation.
withLabel()  : self
Returns an instance with the modified label.
withoutLabel()  : self
Returns an instance without the specified label.
withoutRootLabel()  : self
Returns an instance without its Root label.
withRootLabel()  : self
Returns an instance with its Root label.

Methods

__toString()

Returns the instance string representation.

public __toString() : string

If the instance is defined, the value returned MUST be percent-encoded, but MUST NOT double-encode any characters. To determine what characters to encode, please refer to RFC 3986, Sections 2 and 3.

If the instance is not defined, an empty string is returned

Return values
string

get()

Retrieves a single host label.

public get(int $offset) : string|null

If the label offset has not been set, returns the null value.

Parameters
$offset : int
Return values
string|null

getIp()

Returns the IP component If the Host is an IP address.

public getIp() : string|null

If the host is a not an IP this method will return null

Return values
string|null

getIpVersion()

Returns the IP version.

public getIpVersion() : string|null

If the host is a not an IP this method will return null

Return values
string|null

getIterator()

Iterate over the Domain labels.

public getIterator() : Iterator<string|int, string>
Return values
Iterator<string|int, string>

getUriComponent()

Returns the instance string representation with its optional URI delimiters.

public getUriComponent() : string

The value returned MUST be percent-encoded, but MUST NOT double-encode any characters. To determine what characters to encode, please refer to RFC 3986, Sections 2 and 3.

If the instance is not defined, an empty string is returned

Return values
string

isAbsolute()

Tells whether the domain is absolute.

public isAbsolute() : bool
Return values
bool

isDomain()

Tells whether the host is a domain name.

public isDomain() : bool
Return values
bool

isIp()

Tells whether the host is an IP Address.

public isIp() : bool
Return values
bool

isRegisteredName()

Tells whether the host is a registered name.

public isRegisteredName() : bool
Return values
bool

jsonSerialize()

Returns the instance json representation.

public jsonSerialize() : string|null

If the instance is defined, the value returned MUST be percent-encoded, but MUST NOT double-encode any characters. To determine what characters to encode, please refer to RFC 3986 or RFC 1738.

If the instance is not defined, null is returned

Return values
string|null

keys()

Returns the associated key for a specific label or all the keys.

public keys([string|null $label = null ]) : array<string|int, int>
Parameters
$label : string|null = null
Return values
array<string|int, int>

slice()

Extracts a slice of $length elements starting at position $offset from the host.

public slice(int $offset[, int|null $length = null ]) : self

This method MUST retain the state of the current instance, and return an instance that contains the selected slice.

If $length is null it returns all elements from $offset to the end of the Domain.

Parameters
$offset : int
$length : int|null = null
Return values
self

toAscii()

Returns the ascii representation.

public toAscii() : string|null
Return values
string|null

toString()

Returns the instance string representation.

public toString() : string

If the instance is defined, the value returned MUST be percent-encoded, but MUST NOT double-encode any characters. To determine what characters to encode, please refer to RFC 3986, Sections 2 and 3.

If the instance is not defined, an empty string is returned

Return values
string

toUnicode()

Returns the unicode representation.

public toUnicode() : string|null
Return values
string|null

value()

Returns the instance string representation.

public value() : string|null

If the instance is defined, the value returned MUST be percent-encoded, but MUST NOT double-encode any characters. To determine what characters to encode, please refer to RFC 3986, Sections 2 and 3.

If the instance is not defined null is returned

Return values
string|null

withLabel()

Returns an instance with the modified label.

public withLabel(int $key, Stringable|string $label) : self

This method MUST retain the state of the current instance, and return an instance that contains the new label

If $key is non-negative, the added label will be the label at $key position from the start. If $key is negative, the added label will be the label at $key position from the end.

Parameters
$key : int
$label : Stringable|string
Tags
throws
SyntaxError

If the key is invalid

Return values
self

withoutLabel()

Returns an instance without the specified label.

public withoutLabel(int ...$keys) : self

This method MUST retain the state of the current instance, and return an instance that contains the modified component

If $key is non-negative, the removed label will be the label at $key position from the start. If $key is negative, the removed label will be the label at $key position from the end.

Parameters
$keys : int
Tags
throws
SyntaxError

If the key is invalid

Return values
self 

        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results