(PHP 4 >= 4.0.1, PHP 5)
str_pad — Riempie una stringa con un'altra stringa portando la prima ad una lunghezza pre-determinata
$input
, int $pad_length
[, string $pad_string
[, int $pad_type
]] )
Questa funzione restituisce la stringa input
riempita per una data lunghezza a sinistra, a destra, o in entrambi i lati.
Se il parametro opzionale
pad_string non viene passato, l'
input viene completato con spazi, altrimenti viene
completato con i caratteri di pad_string
fino al limite.
Il parametro pad_type, opzionale, può valere
STR_PAD_RIGHT, STR_PAD_LEFT,
oppure STR_PAD_BOTH. Se non si indica
pad_type lo si assume pari a
STR_PAD_RIGHT.
Se il valore di pad_length è negativo oppure
minore della stringa di input, non si ha nessun completamento.
Example #1 Esempio di uso di str_pad()
<?php
$input = "Alien";
echo str_pad($input, 10); // produces "Alien "
echo str_pad($input, 10, "-=", STR_PAD_LEFT); // produces "-=-=-Alien"
echo str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Alien___"
echo str_pad($input, 6 , "___"); // produces "Alien_"
?>
Nota:
Il parametro
pad_stringpuò essere troncato se il numero di caratteri necessari al completamento non può essere diviso per la lunghezza dipad_string.