W3cubDocs

/Symfony 3.0

Symfony\Component\Console\Helper\ProgressBar

class ProgressBar

The ProgressBar provides helpers to display progress output.

Methods

__construct(OutputInterface $output, int $max)

Constructor.

static setPlaceholderFormatterDefinition(string $name, callable $callable)

Sets a placeholder formatter for a given name.

static callable|null getPlaceholderFormatterDefinition(string $name)

Gets the placeholder formatter for a given name.

static setFormatDefinition(string $name, string $format)

Sets a format for a given name.

static string|null getFormatDefinition(string $name)

Gets the format for a given name.

setMessage($message, $name = 'message')
getMessage($name = 'message')
int getStartTime()

Gets the progress bar start time.

int getMaxSteps()

Gets the progress bar maximal steps.

int getProgress()

Gets the current step position.

float getProgressPercent()

Gets the current progress bar percent.

setBarWidth(int $size)

Sets the progress bar width.

int getBarWidth()

Gets the progress bar width.

setBarCharacter(string $char)

Sets the bar character.

string getBarCharacter()

Gets the bar character.

setEmptyBarCharacter(string $char)

Sets the empty bar character.

string getEmptyBarCharacter()

Gets the empty bar character.

setProgressCharacter(string $char)

Sets the progress bar character.

string getProgressCharacter()

Gets the progress bar character.

setFormat(string $format)

Sets the progress bar format.

setRedrawFrequency(int|float $freq)

Sets the redraw frequency.

start(int|null $max = null)

Starts the progress output.

advance(int $step = 1)

Advances the progress output X steps.

setOverwrite(bool $overwrite)

Sets whether to overwrite the progressbar, false for new line.

setProgress(int $step)

Sets the current progress.

finish()

Finishes the progress output.

display()

Outputs the current progress string.

clear()

Removes the progress bar from the current line.

Details

public __construct(OutputInterface $output, int $max)

Constructor.

Parameters

OutputInterface $output An OutputInterface instance
int $max Maximum steps (0 if unknown)

static public setPlaceholderFormatterDefinition(string $name, callable $callable)

Sets a placeholder formatter for a given name.

This method also allow you to override an existing placeholder.

Parameters

string $name The placeholder name (including the delimiter char like %)
callable $callable A PHP callable

static public callable|null getPlaceholderFormatterDefinition(string $name)

Gets the placeholder formatter for a given name.

Parameters

string $name The placeholder name (including the delimiter char like %)

Return Value

callable|null A PHP callable

static public setFormatDefinition(string $name, string $format)

Sets a format for a given name.

This method also allow you to override an existing format.

Parameters

string $name The format name
string $format A format string

static public string|null getFormatDefinition(string $name)

Gets the format for a given name.

Parameters

string $name The format name

Return Value

string|null A format string

public setMessage($message, $name = 'message')

Parameters

$message
$name

public getMessage($name = 'message')

Parameters

$name

public int getStartTime()

Gets the progress bar start time.

Return Value

int The progress bar start time

public int getMaxSteps()

Gets the progress bar maximal steps.

Return Value

int The progress bar max steps

public int getProgress()

Gets the current step position.

Return Value

int The progress bar step

public float getProgressPercent()

Gets the current progress bar percent.

Return Value

float The current progress bar percent

public setBarWidth(int $size)

Sets the progress bar width.

Parameters

int $size The progress bar size

public int getBarWidth()

Gets the progress bar width.

Return Value

int The progress bar size

public setBarCharacter(string $char)

Sets the bar character.

Parameters

string $char A character

public string getBarCharacter()

Gets the bar character.

Return Value

string A character

public setEmptyBarCharacter(string $char)

Sets the empty bar character.

Parameters

string $char A character

public string getEmptyBarCharacter()

Gets the empty bar character.

Return Value

string A character

public setProgressCharacter(string $char)

Sets the progress bar character.

Parameters

string $char A character

public string getProgressCharacter()

Gets the progress bar character.

Return Value

string A character

public setFormat(string $format)

Sets the progress bar format.

Parameters

string $format The format

public setRedrawFrequency(int|float $freq)

Sets the redraw frequency.

Parameters

int|float $freq The frequency in steps

public start(int|null $max = null)

Starts the progress output.

Parameters

int|null $max Number of steps to complete the bar (0 if indeterminate), null to leave unchanged

public advance(int $step = 1)

Advances the progress output X steps.

Parameters

int $step Number of steps to advance

Exceptions

LogicException

public setOverwrite(bool $overwrite)

Sets whether to overwrite the progressbar, false for new line.

Parameters

bool $overwrite

public setProgress(int $step)

Sets the current progress.

Parameters

int $step The current progress

Exceptions

LogicException

public finish()

Finishes the progress output.

public display()

Outputs the current progress string.

public clear()

Removes the progress bar from the current line.

This is useful if you wish to write some output while a progress bar is running. Call display() to show the progress bar again.

© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Console/Helper/ProgressBar.html