PHP Class Prado\TPropertyValue

TPropertyValue is a utility class that provides static methods to convert component property values to specific types. TPropertyValue is commonly used in component setter methods to ensure the new property value is of specific type. For example, a boolean-typed property setter method would be as follows,


function setPropertyName($value) {
    $value=TPropertyValue::ensureBoolean($value);
$value is now of boolean type
}

Properties can be of the following types with specific type conversion rules: - string: a boolean value will be converted to 'true' or 'false'. - boolean: string 'true' (case-insensitive) will be converted to true, string 'false' (case-insensitive) will be converted to false. - integer - float - array: string starting with '(' and ending with ')' will be considered as as an array expression and will be evaluated. Otherwise, an array with the value to be ensured is returned. - object - enum: enumerable type, represented by an array of strings.

Since: 3.0

Author: Qiang Xue ([email protected])

Afficher le fichier Open project: pradosoft/prado Class Usage Examples

Méthodes publiques

Méthode	Description
ensureArray ( $value ) : array	Converts a value to array type. If the value is a string and it is in the form (a,b,c) then an array consisting of each of the elements will be returned. If the value is a string and it is not in this form then an array consisting of just the string will be returned. If the value is not a string then
ensureBoolean ( $value ) : boolean	Converts a value to boolean type.
ensureEnum ( $value, $enums ) : string	Converts a value to enum type.
ensureFloat ( $value ) : float	Converts a value to float type.
ensureInteger ( $value ) : integer	Converts a value to integer type.
ensureNullIfEmpty ( $value ) : mixed	Converts the value to 'null' if the given value is empty
ensureObject ( $value ) : object	Converts a value to object type.
ensureString ( $value ) : string	Converts a value to string type.

Method Details

ensureArray() public static méthode

Converts a value to array type. If the value is a string and it is in the form (a,b,c) then an array consisting of each of the elements will be returned. If the value is a string and it is not in this form then an array consisting of just the string will be returned. If the value is not a string then

public static ensureArray ( $value ) : array
Résultat	array

ensureBoolean() public static méthode

Note, string 'true' (case-insensitive) will be converted to true, string 'false' (case-insensitive) will be converted to false. If a string represents a non-zero number, it will be treated as true.

public static ensureBoolean ( $value ) : boolean
Résultat	boolean

ensureEnum() public static méthode

This method checks if the value is of the specified enumerable type. A value is a valid enumerable value if it is equal to the name of a constant in the specified enumerable type (class). For more details about enumerable, see {@link TEnumerable}. For backward compatibility, this method also supports sanity check of a string value to see if it is among the given list of strings.

public static ensureEnum ( $value, $enums ) : string
Résultat	string	the valid enumeration value

ensureFloat() public static méthode

Converts a value to float type.

public static ensureFloat ( $value ) : float
Résultat	float

ensureInteger() public static méthode

Converts a value to integer type.

public static ensureInteger ( $value ) : integer
Résultat	integer

ensureNullIfEmpty() public static méthode

Converts the value to 'null' if the given value is empty

public static ensureNullIfEmpty ( $value ) : mixed
Résultat	mixed	input or NULL if input is empty

ensureObject() public static méthode

Converts a value to object type.

public static ensureObject ( $value ) : object
Résultat	object

ensureString() public static méthode

Note, a boolean value will be converted to 'true' if it is true and 'false' if it is false.

public static ensureString ( $value ) : string
Résultat	string