Hướng dẫn str_pad php

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

Show

str_padPad a string to a certain length with another string

Description

str_pad(
    string $string,
    int $length,
    string $pad_string = " ",
    int $pad_type = STR_PAD_RIGHT
): string

Parameters

string

The input string.

length

If the value of length is negative, less than, or equal to the length of the input string, no padding takes place, and string will be returned.

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_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.

Return Values

Returns the padded string.

Examples

Example #1 str_pad() example

$input "Alien";
echo 
str_pad($input10);                      // produces "Alien     "
echo str_pad($input10"-="STR_PAD_LEFT);  // produces "-=-=-Alien"
echo str_pad($input10"_"STR_PAD_BOTH);   // produces "__Alien___"
echo str_pad($input,  6"___");               // produces "Alien_"
echo str_pad($input,  3"*");                 // produces "Alien"
?>

Marjune

7 years ago

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.

e.g

echo str_pad("input", 10, "pp", STR_PAD_BOTH ); // ppinputppp
echo str_pad("input", 6, "p", STR_PAD_BOTH ); // inputp
echo str_pad("input", 8, "p", STR_PAD_BOTH ); //pinputpp?>

robertwhishaw at gmail dot com

2 years ago

Incrementing or decrementing numbers in PHP is easy with the ++ and -- operators but it can be difficult to set the precision of the numbers. The str_pad() can be useful for concatenating a string to the beginning or end of the incrementing number to simulate a different precision.

Good example, we want to increment 001 to 002, 003, 004:

$numbers = [];

for($i = 1; $i <= 4; $i++){
    $numbers[] = str_pad($i, 3, '0', STR_PAD_LEFT);
}

print_r($numbers);

$numbers[0] => '001',
$numbers[1] => '002',
$numbers[2] => '003',
$numbers[3] => '004',

Bad example, we want to increment 001 to 002, 003, 004 but if we set $i = 001 in the for() loop to start with, 001 will be converted to 1 and the incrementing will return: 1, 2, 3, 4 etc...

$numbers = [];

for($i = 001; $i <= 4; $i++){
    $numbers[] = $i;
}

print_r($numbers);

$numbers[0] => 1,
$numbers[1] => 2,
$numbers[2] => 3,
$numbers[3] => 4,

wes at nospamplsexample dot org

7 years ago

multibyte version:

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;
}
?>

qeremy [atta] gmail [dotta] com

9 years ago

A proper unicode string padder;

mb_internal_encoding('utf-8'); // @importantfunction 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;
}
?>

Test;
// needs ie. "test.php" file encoded in "utf-8 without bom"
$s = '...';
for (
$i = 3; $i <= 1000; $i++) {
   
$s1 = str_pad($s, $i, 'AO', STR_PAD_BOTH); // can not inculde unicode char!!!
   
$s2 = str_pad_unicode($s, $i, 'ÄÖ', STR_PAD_BOTH);
   
$sl1 = strlen($s1);
   
$sl2 = mb_strlen($s2);
    echo 
"len $sl1: $s1 \n";
    echo 
"len $sl2: $s2 \n";
    echo 
"\n";
    if (
$sl1 != $sl2) die("Fail!");
}
?>

Output;
len 3: ...
len 3: ...

len 4: ...A
len 4: ...Ä

len 5: A...A
len 5: Ä...Ä

len 6: A...AO
len 6: Ä...ÄÖ
...

pestilenc at hotmail dot com

20 years ago

For me this worked.
$string = 'help';

#First, str_pad() with unique character.
$string = str_pad($string, 10, "*", STR_PAD_BOTH);
#$string = '***help***';

#Second, str_replace with ' '
$string = str_replace("*", " ", $string);

mcinp

7 years ago

a different, more robust multibyte version of str_pad that works correctly only if $pad_string is non-multibyte string

function my_mb_str_pad($input, $pad_length, $pad_string=' ', $pad_type=STR_PAD_RIGHT,$encoding='UTF-8'){
    $mb_diff=mb_strlen($str, $encoding)-strlen($string);       
    return str_pad($input,$pad_length+$mb_diff,$pad_string,$pad_type);
}

bob [at] bobarmadillo [dot] com

19 years ago

In a lot of cases you're better off using str_repeat if you want to use something like   - it repeats the entire string.

Using str_repeat, I wrote a full string pad function that should closely mimic str_pad in every other way:

function full_str_pad($input, $pad_length, $pad_string = '', $pad_type = 0) {
$str = '';
$length = $pad_length - strlen($input);
if (
$length > 0) { // str_repeat doesn't like negatives
 
if ($pad_type == STR_PAD_RIGHT) { // STR_PAD_RIGHT == 1
  
$str = $input.str_repeat($pad_string, $length);
  } elseif (
$pad_type == STR_PAD_BOTH) { // STR_PAD_BOTH == 2
  
$str = str_repeat($pad_string, floor($length/2));
  
$str .= $input;
  
$str .= str_repeat($pad_string, ceil($length/2));
  } else {
// defaults to STR_PAD_LEFT == 0
  
$str = str_repeat($pad_string, $length).$input;
  }
} else {
// if $length is negative or zero we don't need to do anything
 
$str = $input;
}
return
$str;
}
$pad_me = "Test String";
echo
'|'.full_str_pad($pad_me, 20, ' ')."|\n";
echo
'|'.full_str_pad($pad_me, 20, ' ', STR_PAD_RIGHT)."|\n";
echo
'|'.full_str_pad($pad_me, 20, ' ', STR_PAD_BOTH)."|\n";
?>

Spudley

15 years ago

Warning: If your string includes non-ascii characters (eg the British pounds sign), str_pad() will treat these as two characters when calculating the padding.

So for example:
str_pad($currency_symbol.$showtottopay,12," ",STR_PAD_LEFT);
?>
will produce a different length string depending on whether $currency_symbol is pounds or dollars.

Hope this helps someone -- it caused me a lot of problems with misaligned columns in my invoices until I worked it out.

neo_selen

2 years ago

you can use str_pad to display an integer with a fixed amount of digits, like that:
0002
0003
...
0100

by just writing

    for ($i=0;$i<10000;$i++){
        echo
str_pad($i,4,'0',STR_PAD_LEFT)."\n";
    }
?>

i set 4 digits (see parameter #2), but you can set any fitting your needs.

gene at swipesy dot com

10 years ago

This is how I pad using   :

str_replace(" ", "  ", str_pad($foo, 10, " ", STR_PAD_LEFT))

Seems to work well using two   tags for each character added, at least for my use. YMMV.

Fahad dot Gilani at anu dot edu dot au

19 years ago

Basically, *all* of you guys have a 'long' way of padding text with html tags (which includes  ) You dont even have to do a str_replace... try the following code and this will work with ANY html tag there is out there and you don't have to worry about tag character lengths so on and so forth:
  $text = "This is pretty interesting!";
  $pad_string = " ";

    //Pad text on both sides
  $text = str_pad($text, strlen($text)+(20*strlen($pad_string)), $pad_string, STR_PAD_BOTH);
  print $text." Dont you think?";
?>
Will produce:
          This is pretty interesting!           Dont you think?

Cheers,
Fahad

Kirill Fuchs

5 years ago

sprintf() is not always faster... It certainly scales a lot better then str_pad so when running a benchmark that pads 10k characters,  sprintf will come out on top. But if you benchmarked a more real world scenario, it seems str_pad comes out the clear winner.

$sTime = microtime(true);
$count = 5;
$s = sprintf("%'\n5s", "\n");
$eTime = microtime(true);
echo 'sprintf ran in ' . (($eTime - $sTime) * 1000) . ' milliseconds' . "\n";

$sTime = microtime(true);
$s = str_pad("\n", 5, "\n");
$eTime = microtime(true);
echo 'str_pad ran in ' . (($eTime - $sTime) * 1000) . ' milliseconds' . "\n";

sprintf ran in 0.015974044799805 milliseconds
str_pad ran in 0.0059604644775391 milliseconds

christian dot reinecke at web dot de

15 years ago

Fills the first argument (mostly a number, f.e. from a