source: trunk/web/punbb/include/utf8/str_pad.php @ 7

<?php

/**
* @version $Id: str_pad.php,v 1.1 2006/09/03 09:25:13 harryf Exp $
* @package utf8
* @subpackage strings
*/

/**
* Replacement for str_pad. $padStr may contain multi-byte characters.
*
* @author Oliver Saunders <oliver (a) osinternetservices.com>
* @param string $input
* @param int $length
* @param string $padStr
* @param int $type ( same constants as str_pad )
* @return string
* @see http://www.php.net/str_pad
* @see utf8_substr
* @package utf8
* @subpackage strings
*/
function utf8_str_pad($input, $length, $padStr=' ', $type=STR_PAD_RIGHT)
{
        $inputLen = utf8_strlen($input);
        if ($length <= $inputLen)
                return $input;

        $padStrLen = utf8_strlen($padStr);
        $padLen = $length - $inputLen;

        if ($type == STR_PAD_RIGHT)
        {
                $repeatTimes = ceil($padLen / $padStrLen);
                return utf8_substr($input.str_repeat($padStr, $repeatTimes), 0, $length);
        }

        if ($type == STR_PAD_LEFT)
        {
                $repeatTimes = ceil($padLen / $padStrLen);
                return utf8_substr(str_repeat($padStr, $repeatTimes), 0, floor($padLen)).$input;
        }

        if ($type == STR_PAD_BOTH)
        {
                $padLen /= 2;
                $padAmountLeft = floor($padLen);
                $padAmountRight = ceil($padLen);
                $repeatTimesLeft = ceil($padAmountLeft / $padStrLen);
                $repeatTimesRight = ceil($padAmountRight / $padStrLen);

                $paddingLeft = utf8_substr(str_repeat($padStr, $repeatTimesLeft), 0, $padAmountLeft);
                $paddingRight = utf8_substr(str_repeat($padStr, $repeatTimesRight), 0, $padAmountLeft);

                return $paddingLeft.$input.$paddingRight;
        }

        trigger_error('utf8_str_pad: Unknown padding type ('.$type.')', E_USER_ERROR);
}