README

composer require sbwerewolf/language-specific

Features

ArrayHandler with ValueHandler are purpose to safe access to array elements and type-safe using of elements values

With ArrayHandler class you do not need to use

array_key_exists() intval() boolval() floatval() and others

With ValueHandler class you get that type exact you want.

Use-cases

Get database response with proper types

use SbWereWolf\LanguageSpecific\AdvancedArray; $connection = new PDO ($dsn,$login,$password); $command = $connection-> prepare('select name,salary from employee' . ' ORDER BY salary DESC LIMIT 1'); $command->execute(); $data = $command->fetch(PDO::FETCH_ASSOC); /* $data =  array (  'name' => 'Mike',  'salary'=> 19999.99  ); */ $employee = new AdvancedArray($data); echo "The highest paid employee is {$employee->get('name')->str()}" . ", with salary of {$employee->get('salary')->int()}$"; /* The highest paid employee is Mike, with salary of 19999$ */

Library methods of version 8.4

raw() - returns original array

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray( [0 => 'first', 'index' => 20, 3 => 'last',] ); $original = $data->raw(); var_export($original); /* array (  0 => 'first',  'index' => 20,  3 => 'last', ) */

has($key = null) - flag that array has the index (key)

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray([0=>1]); $data->has(); // true // array has at least one element $data = new AdvancedArray([0=>1]); $data->has(0); // true // array has element with index 0 $data = new AdvancedArray([2=>3]); $data->has('4'); // false // array not has element with index '4'

get($key = null) - Get element by index or without it

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray( [0 => 'first', 'index' => 20, 3 => 'last',]); $data->get()->asIs(); /* 'first' */ $data->get()->isReal(); /* true */ $data->get('no-exists')->asIs(); /* NULL */ $data->get('no-exists')->isReal(); /* false */ $data->get('index')->asIs(); /* 20 */ $data->get('index')->isReal(); /* true */ $data->get(99)->asIs(); /* NULL */ $data->get(99)->isReal(); /* false */ $data->get(3)->asIs(); /* 'last' */ $data->get(3)->isReal(); /* true */

isDummy() - flag that indicates exemplar value is dummy

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray([ 'first' => ['A' => 1], 'next' => ['B' => 2], 'last' => ['C' => 3], ]); $data->pull('first')->isDummy(); // false $data->pull('begin')->isDummy(); // true

pull($key = null) - get advanced array for nested array

use SbWereWolf\LanguageSpecific\AdvancedArray; $level4 = [-4 => ['over' => ['and' => ['over' => ['again' => ['for always']]]]]]; $level3 = [-3 => $level4, 'some' => 'other',]; $level2 = [-2 => $level3]; $level1 = [-1 => $level2, 'other' => ['content'], 'any']; $level0 = [$level1]; $data = new AdvancedArray($level0); $data->pull(0)->pull(-1)->pull(-2) ->pull(-3)->pull(-4)->pull('over') ->pull('and')->pull('over')->pull('again') ->isDummy(); // false $data->pull(0)->pull(-1)->pull(-2) ->pull(-3)->pull(-4)->pull('over') ->pull('and')->pull('over')->pull('again') ->get()->str(); // 'for always' $data->pull(0)->pull(-1)->pull(-2) ->pull(-3)->pull(-4 )->pull(-5)->isDummy(); // true

arrays() iterate through array and get handler for each nested array

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray([ ['first', 'next', 'last',], ['A','B','C',], ['1','2','3',] ]); foreach ($data->arrays() as $next) { /* @var $next AdvancedArray */ echo PHP_EOL. var_export($next->raw()); } /* array (  0 => 'first',  1 => 'next',  2 => 'last', ) array (  0 => 'A',  1 => 'B',  2 => 'C', ) array (  0 => '1',  1 => '2',  2 => '3', ) */

asIs() - Get value as it is

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray('1.1'); $data->get()->asIs(); // "1.1"

int() - to integer

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray('1.1'); $data->get()->int(); // 1

double() to double

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray('1.1'); $data->get()->double(); // 1.1

str() - to string

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray('1.1'); $data->get()->str(); // "1.1"

bool() - to boolean

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray('1.1'); $data->get()->bool(); // true

array() - to array

use SbWereWolf\LanguageSpecific\AdvancedArray; /* Let input string */ $data = new AdvancedArray('1.1'); $data->get()->array(); // [0 => "1.1"] /* Let input array with string */ $data = new AdvancedArray(['1.1']); $data->get()->array(); // [0 => "1.1"]

object() - to object

use SbWereWolf\LanguageSpecific\AdvancedArray; use SbWereWolf\LanguageSpecific\Value\CommonValue; $data = new AdvancedArray([new CommonValue()]); $value = $data->get()->object(); var_export($value); /* \SbWereWolf\LanguageSpecific\Value\CommonValue::__set_state(array(  '_value' => NULL,  '_isReal' => true,  '_default' => NULL, )) */

isReal() - flag that value of element is real (is not dummy)

use SbWereWolf\LanguageSpecific\AdvancedArray; $data = new AdvancedArray([0=>1]); $data->get(0)->isReal(); // true // array element with index 0 has value $data = new AdvancedArray([2=>3]); $data->get('4')->isReal(); // false // array do not have element with index '4' then value is not real

type() - get type of value

use SbWereWolf\LanguageSpecific\Value\CommonValue; (new CommonValue(null))->type(); // `NULL` (new CommonValue(false))->type(); // `boolean` (new CommonValue(0))->type(); // `integer` (new CommonValue(0.0))->type(); // `double` (new CommonValue('a'))->type(); // `string` (new CommonValue([]))->type(); // `array` (new CommonValue(new CommonValue()))->type(); // `object`

class() - get pretty name of type of value

use SbWereWolf\LanguageSpecific\Value\CommonValue; (new CommonValue(null))->class(); // `null` (new CommonValue(false))->class(); // `bool` (new CommonValue(0))->class(); // `int` (new CommonValue(0.0))->class(); // `float` (new CommonValue('a'))->class(); // `string` (new CommonValue([]))->class(); // `array` (new CommonValue(new CommonValue()))->class(); // `SbWereWolf\LanguageSpecific\Value\CommonValue`

CommonValueFactory::makeCommonValueAsDummy

Create exemplar of CommonValue as dummy

use SbWereWolf\LanguageSpecific\Value\CommonValueFactory; $value = CommonValueFactory::makeCommonValueAsDummy(); var_export($value); /* \SbWereWolf\LanguageSpecific\Value\CommonValue::__set_state(array(  '_value' => NULL,  '_isReal' => false,  '_default' => NULL, )) */

default($value = null) - define default value

Default value will be implemented when value is dummy

use SbWereWolf\LanguageSpecific\Value\CommonValueFactory; $dummy = CommonValueFactory::makeCommonValueAsDummy(); $dummy->default('default')->str(); // "default" $real = CommonValueFactory::makeCommonValue('real value'); $real->default('default')->str(); // "real value"

Detail info

Refer to

for detail examples of class methods working

Unit tests

composer test

Контакты

Volkhin Nikolay e-mail ulfnew@gmail.com phone +7-902-272-65-35 Telegram @sbwerewolf

sbwerewolf/language-specific

包简介

README 文档