ProgressBar
класс ProgressBar
ProgressBar предоставляет инструменты для отображения прогресса.
Методы
| __construct(OutputInterface $output, int $max) | ||
| static | setPlaceholderFormatterDefinition(string $name, callable $callable) Устанавливает форматировщик подстановок для заданного имени. | |
| static callable|null | getPlaceholderFormatterDefinition(string $name) Получает форматировщик подстановок для заданного имени. | |
| static | setFormatDefinition(string $name, string $format) Устанавливает формат для заданного имени. | |
| static string|null | getFormatDefinition(string $name) Получает формат для заданного имени. | |
| setMessage(string $message, string $name = 'message') Связывает текст с именованной подстановкой. | ||
| getMessage($name = 'message') | ||
| int | getStartTime() Получает время начала прогресс-бара. | |
| int | getMaxSteps() Получает максимальное количество шагов прогресс-бара. | |
| int | getProgress() Получает текущую позицию шага. | |
| float | getProgressPercent() Получает текущий процент прогресс-бара. | |
| setBarWidth(int $size) Устанавливает ширину прогресс-бара. | ||
| int | getBarWidth() Получает ширину прогресс-бара. | |
| setBarCharacter(string $char) Устанавливает символ для прогресс-бара. | ||
| string | getBarCharacter() Получает символ для прогресс-бара. | |
| setEmptyBarCharacter(string $char) Устанавливает символ для пустого прогресс-бара. | ||
| string | getEmptyBarCharacter() Получает символ для пустого прогресс-бара. | |
| setProgressCharacter(string $char) Устанавливает символ для прогресса прогресс-бара. | ||
| string | getProgressCharacter() Получает символ для прогресса прогресс-бара. | |
| setFormat(string $format) Устанавливает формат прогресс-бара. | ||
| setRedrawFrequency(int|float $freq) Устанавливает частоту перерисовки. | ||
| start(int|null $max = null) Запускает вывод прогресса. | ||
| advance(int $step = 1) Переводит вывод прогресса на X шагов. | ||
| setOverwrite(bool $overwrite) Устанавливает, нужно ли перезаписывать прогресс-бар (false — новая строка). | ||
| setProgress(int $step) Устанавливает текущий прогресс. | ||
| finish() Завершает вывод прогресса. | ||
| display() Выводит текущую строку прогресса. | ||
| clear() Удаляет прогресс-бар из текущей строки. |
Подробности
__construct(OutputInterface $output, int $max)
Параметры
| OutputInterface | $output | Экземпляр OutputInterface |
| int | $max | Максимальное количество шагов (0, если неизвестно) |
static setPlaceholderFormatterDefinition(string $name, callable $callable)
Устанавливает форматировщик плейсхолдеров для данного имени.
Этот метод также позволяет переопределить существующий плейсхолдер.
Параметры
| string | $name | Имя плейсхолдера (включая разделитель, например %) |
| callable | $callable | PHP-вызов |
static callable|null getPlaceholderFormatterDefinition(string $name)
Получает форматировщик плейсхолдеров для данного имени.
Параметры
| string | $name | Имя плейсхолдера (включая разделитель, например %) |
Возвращаемое значение
| callable|null | PHP-вызов |
static setFormatDefinition(string $name, string $format)
Устанавливает формат для данного имени.
Этот метод также позволяет переопределить существующий формат.
Параметры
| string | $name | Имя формата |
| string | $format | Строка формата |
static string|null getFormatDefinition(string $name)
Получает формат для данного имени.
Параметры
| string | $name | Имя формата |
Возвращаемое значение
| string|null | Строка формата |
setMessage(string $message, string $name = 'message')
Связывает текст с именованным плейсхолдером.
Текст отображается при отрисовке полосы прогресса, но только если соответствующий плейсхолдер является частью пользовательской строки формата (путём обертывания имени в %).
Параметры
| string | $message | Текст для связывания с плейсхолдером |
| string | $name | Имя плейсхолдера |
getMessage($name = 'message')
Параметры
| $name |
int getStartTime()
Получает время начала полосы прогресса.
Возвращаемое значение
| int | Время начала полосы прогресса |
int getMaxSteps()
Получает максимальное количество шагов полосы прогресса.
Возвращаемое значение
| int | Максимальное количество шагов полосы прогресса |
int getProgress()
Получает текущую позицию шага.
Возвращаемое значение
| int | Текущий шаг полосы прогресса |
float getProgressPercent()
Получает текущий процент полосы прогресса.
Возвращаемое значение
| float | Текущий процент полосы прогресса |
setBarWidth(int $size)
Устанавливает ширину полосы прогресса.
Параметры
| int | $size | Ширина полосы прогресса |
int getBarWidth()
Получает ширину полосы прогресса.
Возвращаемое значение
| int | Размер полосы прогресса |
setBarCharacter(string $char)
Устанавливает символ полосы прогресса.
Параметры
| string | $char | Символ |
string getBarCharacter()
Получает символ полосы прогресса.
Возвращаемое значение
| string | Символ |
setEmptyBarCharacter(string $char)
Устанавливает символ пустой части полосы прогресса.
Параметры
| string | $char | Символ |
string getEmptyBarCharacter()
Получает символ пустой части полосы прогресса.
Возвращаемое значение
| string | Символ |
setProgressCharacter(string $char)
Устанавливает символ текущего прогресса.
Параметры
| string | $char | Символ |
string getProgressCharacter()
Получает символ текущего прогресса.
Возвращаемое значение
| string | Символ |
setFormat(string $format)
Устанавливает формат полосы прогресса.
Параметры
| string | $format | Формат |
setRedrawFrequency(int|float $freq)
Устанавливает частоту перерисовки.
Параметры
| int|float | $freq | Частота в шагах |
start(int|null $max = null)
Запускает вывод прогресса.
Параметры
| int|null | $max | Количество шагов для завершения полосы (0 для неопределённого значения), null, чтобы оставить без изменений |
advance(int $step = 1)
Передвигает вывод прогресса на X шагов.
Параметры
| int | $step | Количество шагов для перемещения |
setOverwrite(bool $overwrite)
Устанавливает, следует ли перезаписывать полосу прогресса. False для новой строки.
Параметры
| bool | $overwrite |
setProgress(int $step)
Устанавливает текущий прогресс.
Параметры
| int | $step | Текущий прогресс |
finish()
Завершает вывод прогресса.
display()
Выводит текущую строку прогресса.
clear()
Удаляет полосу прогресса из текущей строки.
Это полезно, если вы хотите вывести что-то, пока работает полоса прогресса. Вызовите display(), чтобы снова отобразить полосу прогресса.
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.4/Symfony/Component/Console/Helper/ProgressBar.html