Fluent Strings Helper for Nette Framework

string-helper.php

<?php

/**
 * Fluent Strings Helper for Nette Framework
 *
 * @author  Vojtěch Dobeš <me@vojtechdobes.com>
 * @license WTFPL
 */
class StringObject
{

	/** @var array */
	public static $modifies = array(
		'capitalize',
		'firstUpper',
		'upper',
		'lower',
		'indent',
		'truncate',
		'webalize',
		'toAscii',
		'normalize',
		'substring',
		'trim',
		'padLeft',
		'padRight',
		'reverse',
		'replace',
		'fixEncoding',
	);

	/** @var array */
	public static $evaluates = array(
		'checkEncoding',
		'startsWith',
		'endsWith',
		'contains',
		'compare',
		'length',
		'split',
		'match',
		'matchAll',
	);

	/** @var string */
	private $value;



	/**
	 * @param  string whatever stringifyable
	 */
	public function __construct($value)
	{
		$this->value = (string) $value;
	}



	/**
	 * @return string
	 */
	public function get()
	{
		return $this->__toString();
	}



	/**
	 * @return string
	 */
	public function __toString()
	{
		return $this->value;
	}



	public function __call($name, $args)
	{
		if (!($modifies = in_array($name, self::$modifies)) && !in_array($name, self::$evaluates)) return parent::__call($name, $args);

		array_unshift($args, $this->value);
		$result = call_user_func_array(array('Nette\Utils\Strings', $name), $args);
		if ($modifies) {
			$this->value = $result;
			return $this;
		} else {
			return $result;
		}
	}

}

/**
 * @param  string whatever stringifyable
 * @return StringObject
 */
function string($value)
{
	return new StringObject($value);
}