str_pad
- (PHP 4 >= 4.0.1, PHP 5, PHP 7)
- str_pad — Pad a string to a certain length with another string
- str_pad — 使用另一个字符串填充字符串为指定长度
Description
string str_pad ( ????string $input , ????int $pad_length [, ????string $pad_string = " " [, ????int $pad_type = STR_PAD_RIGHT ]] )//This function returns the input string padded on the left, the right, or both sides to the specified padding length. If the optional argument pad_string is not supplied, the input is padded with spaces, otherwise it is padded with characters from pad_string up to the limit.//该函数返回 input 被从左端、右端或者同时两端被填充到制定长度后的结果。如果可选的 pad_string 参数没有被指定，input 将被空格字符填充，否则它将被 pad_string 填充到指定长度。Parameters
input
- The input string.
- 输入字符串。
pad_length
- If the value of pad_length is negative, less than, or equal to the length of the input string, no padding takes place, and input will be returned.
- 如果 pad_length 的值是负数，小于或者等于输入字符串的长度，不会发生任何填充，并会返回 input 。
pad_string
Note:
- The pad_string may be truncated if the required number of padding characters can‘t be evenly divided by the pad_string‘s length.
- 如果填充字符的长度不能被 pad_string 整除，那么 pad_string 可能会被缩短。
pad_type
- Optional argument pad_type can be STR_PAD_RIGHT, STR_PAD_LEFT, or STR_PAD_BOTH. If pad_type is not specified it is assumed to be STR_PAD_RIGHT.
- 可选的 pad_type 参数的可能值为
STR_PAD_RIGHT，STR_PAD_LEFT或STR_PAD_BOTH。如果没有指定 pad_type，则假定它是STR_PAD_RIGHT。
Return Values
- Returns the padded string.
- 返回填充后的字符串。
Examples
<?php/** * Created by PhpStorm. * User: zhangrongxiang * Date: 2018/2/19 * Time: 下午10:59 *///function str_pad ($input, $pad_length, $pad_string = null, $pad_type = null) {}$input = "zing";$str ??= str_pad( $input, 10 );//"zing ?????"echo $str . PHP_EOL;//10echo strlen( $str ) . PHP_EOL;//zing******echo str_pad( $input, 10, "*" ) . PHP_EOL;//^^^^^^zingecho str_pad( $input, 10, "^", STR_PAD_LEFT ) . PHP_EOL; ?// 输出 "-=-=-Alien"//___zing___echo str_pad( $input, 10, "_", STR_PAD_BOTH ) . PHP_EOL;//zing=echo str_pad( $input, 5, "==" ) . PHP_EOL;//zingecho str_pad( $input, 3, "-" ) . PHP_EOL;///////////////////////////////////////////////////////////////** * since the default pad_type is STR_PAD_RIGHT. * using STR_PAD_BOTH were always favor in the right pad * if the required number of padding characters can't be evenly divided. *///ppinputpppecho str_pad( "input", 10, "pp", STR_PAD_BOTH ) . PHP_EOL;//inputpecho str_pad( "input", 6, "p", STR_PAD_BOTH ) . PHP_EOL;//pinputppecho str_pad( "input", 8, "p", STR_PAD_BOTH ) . PHP_EOL;/////////////////////////////////////////////////////////////function str_pad_unicode( $str, $pad_len, $pad_str = ' ', $dir = STR_PAD_RIGHT ) { ???$str_len ????= mb_strlen( $str ); ???$pad_str_len = mb_strlen( $pad_str ); ???if ( ! $str_len && ( $dir == STR_PAD_RIGHT || $dir == STR_PAD_LEFT ) ) { ???????$str_len = 1; // @debug ???} ???if ( ! $pad_len || ! $pad_str_len || $pad_len <= $str_len ) { ???????return $str; ???} ???????$result = null; ???$repeat = ceil( $str_len - $pad_str_len + $pad_len ); ???if ( $dir == STR_PAD_RIGHT ) { ???????$result = $str . str_repeat( $pad_str, $repeat ); ???????$result = mb_substr( $result, 0, $pad_len ); ???} else if ( $dir == STR_PAD_LEFT ) { ???????$result = str_repeat( $pad_str, $repeat ) . $str; ???????$result = mb_substr( $result, - $pad_len ); ???} else if ( $dir == STR_PAD_BOTH ) { ???????$length = ( $pad_len - $str_len ) / 2; ???????$repeat = ceil( $length / $pad_str_len ); ???????$result = mb_substr( str_repeat( $pad_str, $repeat ), 0, floor( $length ) ) ?????????????????. $str ?????????????????. mb_substr( str_repeat( $pad_str, $repeat ), 0, ceil( $length ) ); ???} ???????return $result;}$str = "拍黄片";//哈拍黄片哈echo str_pad_unicode( $str, 5, '哈', STR_PAD_BOTH ) . PHP_EOL;//哈哈哈拍黄片哈哈哈哈echo str_pad_unicode( $str, 10, '哈', STR_PAD_BOTH ) . PHP_EOL;function mb_str_pad( $str, $pad_len, $pad_str = ' ', $dir = STR_PAD_RIGHT, $encoding = null ) { ???$encoding ??????= $encoding === null ? mb_internal_encoding() : $encoding; ???$padBefore ?????= $dir === STR_PAD_BOTH || $dir === STR_PAD_LEFT; ???$padAfter ??????= $dir === STR_PAD_BOTH || $dir === STR_PAD_RIGHT; ???$pad_len ???????-= mb_strlen( $str, $encoding ); ???$targetLen ?????= $padBefore && $padAfter ? $pad_len / 2 : $pad_len; ???$strToRepeatLen = mb_strlen( $pad_str, $encoding ); ???$repeatTimes ???= ceil( $targetLen / $strToRepeatLen ); ???$repeatedString = str_repeat( $pad_str, max( 0, $repeatTimes ) ); // safe if used with valid utf-8 strings ???$before ????????= $padBefore ? mb_substr( $repeatedString, 0, floor( $targetLen ), $encoding ) : ''; ???$after ?????????= $padAfter ? mb_substr( $repeatedString, 0, ceil( $targetLen ), $encoding ) : ''; ???????return $before . $str . $after;}//哈拍黄片哈echo mb_str_pad( $str, 5, '哈', STR_PAD_BOTH ) . PHP_EOL;//哈哈哈拍黄片哈哈哈哈echo mb_str_pad( $str, 10, '哈', STR_PAD_BOTH ) . PHP_EOL;///////////////////////////////////////////////////////////////////////function pad_between_strings( $string1, $string2, $length, $char = " " ) { ???$fill_length = $length - ( strlen( $string1 ) + strlen( $string2 ) ); ???????return $string1 . str_repeat( $char, $fill_length ) . $string2;}//abc**************123echo pad_between_strings( "abc", "123", 20, "*" ) . PHP_EOL;See
- http://php.net/manual/zh/function.str_pad.php