Submit a Pull Request Report a Bug

    vprintf

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

    vprintf — Выводит отформатированную строку

    Описание

    vprintf(string $format, array $values): int

    Выводит значения массива, отформатированные в соответствии с аргументом format, описанном в документации функции sprintf().

    Работает как printf(), но принимает не переменное число аргументов, а массив.

    Список параметров

    format

    Строка формата состоит из нуля или более директив: обычные символы (за исключением %), которые просто выводятся без изменения и спецификаторы преобразования, каждый из которых требует передачи своего параметра.

    Спецификаторы преобразования имеют следующий формат: %[argnum$][flags][width][.precision]specifier.

    Argnum

    Целое число, за которым следует знак доллара $, чтобы указать, какой числовой аргумент обрабатывать при преобразовании.

    Флаги
    Флаг Описание
    - Выравнивание по левому краю в пределах заданной ширины поля; По умолчанию выравнивание происходит по правому краю.
    + Печатает плюс + у не отрицательных чисел; По умолчанию знак печатается только у отрицательных чисел.
    (space) Дополняет результат пробелами. Это поведение по умолчанию.
    0 Дополняет числа нулями (только слева). Со спецификатором s также может дополнять нулями справа.
    '(char) Дополняет результат символом (char).

    Ширина

    Целое число, определяющее минимальное количество символов, которое будет напечатано.

    Точность

    Точка . с последующим целым числом, работающая по разному для разных спецификаторов:

    • Для спецификаторов e, E, f и F: задаёт количество цифр после десятичной запятой (по умолчанию 6).
    • Для спецификаторов g,G, h и H: задаёт максимальное значение печатаемых значащих цифр.
    • Для спецификатора s: задаёт ограничение максимального количества символов в строке, которые будут выведены.

    Замечание: Если указана точка без последующего значения точности, то точность будет считаться за 0.

    Замечание: Попытка использовать спецификатор позиции со значением больше, чем PHP_INT_MAX приведёт к выводу предупреждения.

    Спецификаторы
    Спецификатор Описание
    % Символ процента. Аргументы не требуются.
    b Аргумент рассматривается как целое число и печатается в бинарном представлении.
    c Аргумент рассматривается как целое число и печатается как символ из таблицы ASCII с соответствующим кодом.
    d Аргумент рассматривается как целое число и печатается как целое число со знаком.
    e Аргумент считается за число в научной нотации (т.е. 1.2e+2).
    E Аналогично спецификатору e, но использует заглавные символы (т.е. 1.2E+2).
    f Аргумент считается за число с плавающей точкой (с учётом локали).
    F Аргумент считается за число с плавающей точкой (без учёта локали).
    g

    Общий формат.

    Пусть P равно точности, если она не равно нулю, 6 - если точность не задана и 1, если точность задана как 0. Тогда, если преобразование со стилем "E" будет иметь показатель степени X:

    Если P > X ≥ −4, преобразование будет в стиле "f" и точность будет P − (X + 1). В обратном случае, преобразование будет в стиле "e" и точность будет P − 1.

    G Аналогично спецификатору g, но использует E и f.
    h Аналогично спецификатору g, но использует F. Доступен с PHP 8.0.0.
    H Аналогично спецификатору g, но использует E и F. Доступен с PHP 8.0.0.
    o Аргумент рассматривается как целое число и печатается в восьмеричном представлении.
    s Аргумент рассматривается и печатается как строка.
    u Аргумент рассматривается как целое число и печатается как беззнаковое целое число.
    x Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в нижнем регистре).
    X Аргумент рассматривается как целое число и печатается в шестнадцатеричном представлении (буквы будут в верхнем регистре).

    Внимание

    Спецификатор c игнорирует значения ширины и дополнения

    Внимание

    Попытка использовать спецификаторы с указанием ширины для строки в многобайтовой кодировке может привести к неожиданным результатам.

    Переменные будут приведены к подходящему для спецификатора типу:

    Обработка типов
    Тип Спецификатор
    string s
    int d, u, c, o, x, X, b
    float e, E, f, F, g, G, h, H

    values

    Возвращаемые значения

    Возвращает длину выведенной строки.

    Примеры

    Пример #1 vprintf(): дополнение нулями целых чисел

    <?php
    vprintf    ("%04d-%02d-%02d", explode('-', '1988-8-1'));
    ?>

    Результат выполнения данного примера:

    1988-08-01

    Смотрите также

    • printf() - Выводит отформатированную строку
    • sprintf() - Возвращает отформатированную строку
    • fprintf() - Записывает отформатированную строку в поток
    • vsprintf() - Возвращает отформатированную строку
    • vfprintf() - Записывает отформатированную строку в поток
    • sscanf() - Разбирает строку в соответствии с заданным форматом
    • fscanf() - Обрабатывает данные из файла в соответствии с форматом
    • number_format() - Форматирует число с разделением групп
    • date() - Форматирует вывод системной даты/времени

    add a note add a note

    User Contributed Notes 8 notes

    up
    9
    steve at stevelockwood dot net
    9 years ago
    If, instead of an array, you pass an object PHP will automatically cast the object as an array so you can use it directly in vprintf.
    <?php
    $object     = new stdClass();
    $object->Property1 = 'Value 1';
    $object->Property2 = 'Value 2';
    vprintf('%-20s %-20s', $object);

    /* will output
    Value 1              Value 2            
    */
    ?>
    up
    1
    tehjosh at gamingg dot net
    16 years ago
    To toolofthesystem at gmail dot com:

    You don't need to use output buffering with vprintf() because you can use vsprintf(), which has the same functionality as vprintf(), except that it returns the resulting string instead of outputting it.
    up
    0
    phpcoder at gmail dot com
    4 years ago
    Using the ... operator, vprintf($format, $array) is basically just printf($format, ...$array).
    up
    0
    taken from &#34;Php Phrasebook&#34;
    15 years ago
    <?php
    $string     = 'The site runs on PHP '.phpversion();
    preg_match('/php ((\d)\.\d\.\d+)/i',$string,$matches);
    print_r($matches);
    vprintf('Match: %s<br /> Version %s; Major:%d.',$matches);
    ?>

    output:
    Array ( [0] => PHP 5.2.5 [1] => 5.2.5 [2] => 5 )
    Match: PHP 5.2.5 Version 5.2.5; Major:5.

    For preg_match:

    If matches  is provided, then it is filled with the results of search. $matches[0] will contain the text that matched the full pattern, $matches[1]  will have the text that matched the first captured parenthesized subpattern, and so on.
    up
    0
    toolofthesystem at gmail dot com
    17 years ago
    This function comes useful sometimes when trying to list information returned from MySQL:

    function print_sql($query,$printf){
        $sql_sql = mysql_query($query);
        while($sql = mysql_fetch_row($sql_sql)){
            vprintf($printf,$sql);
        }
    }

    Unfortunately, this seems to sneak its way past output buffering when I tried creating an argument to allow it to be contained in a returned string... either that or I didn't do it right.
    up
    0
    caleb at tekhawk dot com
    17 years ago
    i know that you can use %1$s or %3$s to select the first or third string but how can you or can you use array names to select it

    something like %'user'$s $'email'$s

    i tend to add things to my databases over time and this could save loads of recoding
    up
    -2
    Chris
    11 years ago
    Another way to display arrays is use an array_walk(). This can be useful inline echo/print where a foreach wouldn't work, e.g.

    <?php
    echo "These errors: ", (unset)array_walk($msgs, function($a) { echo "<p>$a</p>"; } ), "must be corrected.";
    ?>
    up
    -2
    badcop666 at hotmail dot com
    16 years ago
    For blocks of text, sprintf() is slow according to my tests.

    Also, having the mapping between place-holders and the list of actual variables or datastructures often makes this code difficult to read. But the printf() family are widely supported and have a huge range of nice features. Performance is a cold mistress though!

    From an ease-of-reading and maintenance, debugging point of view, I much prefer HEREDOC and "...{$variable}..." methods.

    For a block of HTML markup with place holders, the fastest by far was:-

    ?>
    <div> markup etc<?= $variable ?>more markup
    <?

    My tests comprised 20 runs of a loop of 1 million iterations with output buffering    , ditching the buffer on each loop.

    The timings ranged from average 2.1msec/million repetitions for the <?= $var ?> method up to 7.6msec/million using printf().

    I'll try some benchmarking tools too, since I just wrote this myself and it could be introducing bias, but they've run on dev servers with low load.

    Hopefully interesting.
    add a note add a note
    To Top