questlab/app/lib/Netcarver/Textile/DataBag.php

100 lines
2.9 KiB
PHP

<?php
/**
* Textile - A Humane Web Text Generator.
*
* @link https://github.com/textile/php-textile
*/
namespace Netcarver\Textile;
/*
* Copyright (c) 2013, Netcarver https://github.com/netcarver
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* * Neither the name Textile nor the names of its contributors may be used to
* endorse or promote products derived from this software without specific
* prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
/**
* Simple data storage.
*
* This class to allows storing assignments in an internal
* data array.
*
* <code>
* use Netcarver\Textile\DataBag;
* $plant = new DataBag(array('key' => 'value'));
* $plant->flower('rose')->color('red');
* </code>
*/
class DataBag
{
/**
* The data array stored in the bag.
*
* @var array
*/
protected $data;
/**
* Constructor.
*
* @param array|null $data The initial data array stored in the bag
*/
public function __construct(array $data = null)
{
$this->data = (array) $data;
}
/**
* Adds a value to the bag.
*
* Empty values are rejected, unless the
* second argument is set TRUE.
*
* <code>
* use Netcarver\Textile\DataBag;
* $plant = new DataBag(array('key' => 'value'));
* $plant->flower('rose')->color('red')->emptyValue(false, true);
* </code>
*
* @param string $name The name
* @param array $params Arguments
* @return DataBag
*/
public function __call($name, array $params)
{
if (!empty($params[1]) || !empty($params[0])) {
$this->data[$name] = $params[0];
}
return $this;
}
}