EventImmutable

Extends AbstractEvent

Implementation of an immutable Event.

final

An immutable event cannot be modified after instanciation :

  • its propagation cannot be stopped
  • its arguments cannot be modified

You may want to use this event when you want to ensure that the listeners won't manipulate it.

since

1.0

package

Joomla Framework

Methods

__construct

Constructor.

__construct(string name, array arguments = []) : mixed
inherited
since

1.0

Arguments

name

stringThe event name.

arguments

arrayThe event arguments.

Response

mixed

__serialize

Serialize the event.

__serialize() : array
inherited
since

2.0.0

Response

arrayThe data to be serialized

__unserialize

Unserialize the event.

__unserialize(array data) : void
inherited
since

2.0.0

Arguments

data

arrayThe serialized event.

count

Count the number of arguments.

count() : int
inherited
since

1.0

Response

intThe number of arguments.

getArgument

Get an event argument value.

getArgument(string name, mixed default = null) : mixed
inherited
since

1.0

Arguments

name

stringThe argument name.

default

mixedThe default value if not found.

Response

mixedThe argument value or the default value.

getArguments

Get all event arguments.

getArguments() : array
inherited
since

1.0

Response

arrayAn associative array of argument names as keys and their values as values.

getName

Get the event name.

getName() : string
inherited
since

1.0

Response

stringThe event name.

hasArgument

Tell if the given event argument exists.

hasArgument(string name) : bool
inherited
since

1.0

Arguments

name

stringThe argument name.

Response

boolTrue if it exists, false otherwise.

isStopped

Tell if the event propagation is stopped.

isStopped() : bool
inherited
since

1.0

Response

boolTrue if stopped, false otherwise.

offsetExists

Tell if the given event argument exists.

offsetExists(string name) : bool
inherited
since

1.0

Arguments

name

stringThe argument name.

Response

boolTrue if it exists, false otherwise.

offsetGet

Get an event argument value.

offsetGet(string name) : mixed
inherited
since

1.0

Arguments

name

stringThe argument name.

Response

mixedThe argument value or null if not existing.

offsetSet

Set the value of an event argument.

offsetSet(string name, mixed value) : void
since

1.0

throws

\BadMethodCallException

Arguments

name

stringThe argument name.

value

mixedThe argument value.

offsetUnset

Remove an event argument.

offsetUnset(string name) : void
throws

\BadMethodCallException

since

1.0

Arguments

name

stringThe argument name.

serialize

Serialize the event.

serialize() : string
inherited
since

1.0

Response

stringThe serialized event.

stopPropagation

Stops the propagation of the event to further event listeners.

stopPropagation() : void
inherited
since

2.0.0

unserialize

Unserialize the event.

unserialize(string serialized) : void
inherited
since

1.0

Arguments

serialized

stringThe serialized event.

Properties

constructed

A flag to see if the constructor has been already called.

Type(s)

bool

name

The event name.

inherited
since

1.0

Type(s)

string

arguments

The event arguments.

inherited
since

1.0

Type(s)

array

stopped

A flag to see if the event propagation is stopped.

inherited
since

1.0

Type(s)

bool