array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'it', ), 'this' => array ( 0 => 'function.str-pad.php', 1 => 'str_pad', 2 => 'Riempie una stringa con un\'altra stringa portando la prima ad una lunghezza pre-determinata', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String Funzioni', ), 'prev' => array ( 0 => 'function.str-ireplace.php', 1 => 'str_ireplace', ), 'next' => array ( 0 => 'function.str-repeat.php', 1 => 'str_repeat', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'it', 'path' => 'reference/strings/functions/str-pad.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_pad

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

str_pad — Riempie una stringa con un'altra stringa portando la prima ad una lunghezza pre-determinata

Descrizione

str_pad(
    string $input,
    int $pad_length,
    string $pad_string = ?,
    int $pad_type = ?
): string

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_string può essere troncato se il numero di caratteri necessari al completamento non può essere diviso per la lunghezza di pad_string.