Text
» Kohana_Text

public static limit_words ( string $str, integer $limit = 100, string $end_char = NULL )

Returns:

• string

Source:

public static function limit_words($str, $limit = 100, $end_char = NULL)
{
	$limit = (int) $limit;
	$end_char = ($end_char === NULL) ? '…' : $end_char;

	if (trim($str) === '')
		return $str;

	if ($limit <= 0)
		return $end_char;

	preg_match('/^\s*+(?:\S++\s*+){1,'.$limit.'}/u', $str, $matches);

	// Only attach the end character if the matched string is shorter
	// than the starting string.
	return rtrim($matches[0]).(strlen($matches[0]) === strlen($str) ? '' : $end_char);
}

public static limit_chars ( string $str, integer $limit = 100, string $end_char = NULL, boolean $preserve_words = false )

Returns:

• string

Source:

public static function limit_chars($str, $limit = 100, $end_char = NULL, $preserve_words = FALSE)
{
	$end_char = ($end_char === NULL) ? '…' : $end_char;

	$limit = (int) $limit;

	if (trim($str) === '' OR UTF8::strlen($str) <= $limit)
		return $str;

	if ($limit <= 0)
		return $end_char;

	if ($preserve_words == FALSE)
	{
		return rtrim(UTF8::substr($str, 0, $limit)).$end_char;
	}

	preg_match('/^.{'.($limit - 1).'}\S*/us', $str, $matches);

	return rtrim($matches[0]).(strlen($matches[0]) == strlen($str) ? '' : $end_char);
}

public static alternate ( )

Returns:

• string

Source:

public static function alternate()
{
	static $i;

	if (func_num_args() === 0)
	{
		$i = 0;
		return '';
	}

	$args = func_get_args();
	return $args[($i++ % count($args))];
}

public static random ( string $type = 'alnum', integer $length = 8 )

Returns:

• string

Source:

public static function random($type = 'alnum', $length = 8)
{
	$utf8 = FALSE;

	switch ($type)
	{
		case 'alnum':
			$pool = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
		break;
		case 'alpha':
			$pool = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
		break;
		case 'hexdec':
			$pool = '0123456789abcdef';
		break;
		case 'numeric':
			$pool = '0123456789';
		break;
		case 'nozero':
			$pool = '123456789';
		break;
		case 'distinct':
			$pool = '2345679ACDEFHJKLMNPRSTUVWXYZ';
		break;
		default:
			$pool = (string) $type;
			$utf8 = ! UTF8::is_ascii($pool);
		break;
	}

	// Split the pool into an array of characters
	$pool = ($utf8 === TRUE) ? UTF8::str_split($pool, 1) : str_split($pool, 1);

	// Largest pool key
	$max = count($pool) - 1;

	$str = '';
	for ($i = 0; $i < $length; $i++)
	{
		// Select a random character from the pool and add it to the string
		$str .= $pool[mt_rand(0, $max)];
	}

	// Make sure alnum strings contain at least one letter and one digit
	if ($type === 'alnum' AND $length > 1)
	{
		if (ctype_alpha($str))
		{
			// Add a random digit
			$str[mt_rand(0, $length - 1)] = chr(mt_rand(48, 57));
		}
		elseif (ctype_digit($str))
		{
			// Add a random letter
			$str[mt_rand(0, $length - 1)] = chr(mt_rand(65, 90));
		}
	}

	return $str;
}

tutorial

alnum alpha-numeric characters

alpha alphabetical characters

hexdec hexadecimal characters, 0-9 plus a-f

numeric digit characters, 0-9

nozero digit characters, 1-9

distinct clearly distinct alpha-numeric characters

public static reduce_slashes ( string $str )

Returns:

• string

Source:

public static function reduce_slashes($str)
{
	return preg_replace('#(?