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;
//10
echo strlen( $str ) . PHP_EOL;
//zing******
echo str_pad( $input, 10, "*" ) . PHP_EOL;
//^^^^^^zing
echo 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;
//zing
echo 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.
*/
//ppinputppp
echo str_pad( "input", 10, "pp", STR_PAD_BOTH ) . PHP_EOL;
//inputp
echo str_pad( "input", 6, "p", STR_PAD_BOTH ) . PHP_EOL;
//pinputpp
echo 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**************123
echo pad_between_strings( "abc", "123", 20, "*" ) . PHP_EOL;