category Zend
package Zend_Console
subpackage Adapter

 Methods

Clear console screen

clear() 

Clear line at cursor position

clearLine() 

Clear console screen

clearScreen() 

Prepare a string that will be rendered in color.

colorize(string $string, int $color, null | int $bgColor) : string

Parameters

$string

string

$color

int

$bgColor

nullint

Returns

string

Get charset currently in use by this adapter.

getCharset() : \Zend\Console\Charset\CharsetInterface

getDefaultCharset()

getDefaultCharset() : \Zend\Console\Charset\Utf8

Determine and return current console height.

getHeight() : int

Returns

int

Return current cursor position - array($x, $y)

getPos() : array

Returns

arrayarray($x, $y);

Determine and return current console width and height.

getSize() : array

Returns

arrayarray($width, $height)

Return current console window title.

getTitle() : string

Returns

string

Determine and return current console width.

getWidth() : int

Returns

int

Hide console cursor

hideCursor() 

Check if console is UTF-8 compatible

isUtf8() : bool

Returns

bool

Read a single character from the console input

readChar(string | null $mask) : string

Parameters

$mask

stringnull

A list of allowed chars

Returns

string

Read a single line from the console input

readLine(int $maxLength) : string

Parameters

$maxLength

int

Maximum response length

Returns

string

Reset color to console default.

resetColor() 

Reset console window title to previous value.

resetTitle() 

Change current drawing background color

setBgColor(int $color) 

Parameters

$color

int

Set Console charset to use.

setCharset(\Zend\Console\Charset\CharsetInterface $charset) 

Change current drawing color.

setColor(int $color) 

Parameters

$color

int

Set cursor position

setPos(int $x, int $y) 

Parameters

$x

int

$y

int

Set console window title

setTitle($title) 

Parameters

$title

Show console cursor

showCursor() 

Write a chunk of text to console.

write(string $text, null | int $color, null | int $bgColor) 

Parameters

$text

string

$color

nullint

$bgColor

nullint

Write a piece of text at the coordinates of $x and $y

writeAt(string $text, int $x, int $y, null | int $color, null | int $bgColor) 

Parameters

$text

string

Text to write

$x

int

Console X coordinate (column)

$y

int

Console Y coordinate (row)

$color

nullint

$bgColor

nullint

Write a box at the specified coordinates.

writeBox(int $x1, int $y1, int $x2, int $y2, int $lineStyle, int $fillStyle, int $color, int $bgColor, null | int $fillColor, null | int $fillBgColor) 

If X or Y coordinate value is negative, it will be calculated as the distance from far right or bottom edge of the console (respectively).

Parameters

$x1

int

Top-left corner X coordinate (column)

$y1

int

Top-left corner Y coordinate (row)

$x2

int

Bottom-right corner X coordinate (column)

$y2

int

Bottom-right corner Y coordinate (row)

$lineStyle

int

(optional) Box border style.

$fillStyle

int

(optional) Box fill style or a single character to fill it with.

$color

int

(optional) Foreground color

$bgColor

int

(optional) Background color

$fillColor

nullint

(optional) Foreground color of box fill

$fillBgColor

nullint

(optional) Background color of box fill

Exceptions

\Zend\Console\Exception\BadMethodCallException if coordinates are invalid

Write a single line of text to console and advance cursor to the next line.

writeLine(string $text, null | int $color, null | int $bgColor) 

If the text is longer than console width it will be truncated.

Parameters

$text

string

$color

nullint

$bgColor

nullint

Alias for write()

writeText(string $text, null | int $color, null | int $bgColor) 

Parameters

$text

string

$color

nullint

$bgColor

nullint

Write a block of text at the given coordinates, matching the supplied width and height.

writeTextBlock(string $text, int $width, int | null $height, int $x, int $y, null | int $color, null | int $bgColor) 

In case a line of text does not fit desired width, it will be wrapped to the next line. In case the whole text does not fit in desired height, it will be truncated.

Parameters

$text

string

Text to write

$width

int

Maximum block width. Negative value means distance from right edge.

$height

intnull

Maximum block height. Negative value means distance from bottom edge.

$x

int

Block X coordinate (column)

$y

int

Block Y coordinate (row)

$color

nullint

(optional) Text color

$bgColor

nullint

(optional) Text background color

Helper function that return string length as rendered in console.

getStringWidth($string) : int

static

Parameters

$string

Returns

int

Trim a string in an encoding-safe way

stringTrim(mixed $string, mixed $length) : int

Parameters

$string

mixed

$length

mixed

Returns

int

 Properties

   

Whether or not mbstring is enabled

$hasMBString : null | bool

 

Current cursor X position

$posX : int

 

Current cursor Y position

$posY : int

 Constants

 

FILL_BLOCK

FILL_BLOCK 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::FILL_BLOCK
 

FILL_NONE

FILL_NONE 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::FILL_NONE
 

FILL_SHADE_DARK

FILL_SHADE_DARK 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::FILL_SHADE_DARK
 

FILL_SHADE_LIGHT

FILL_SHADE_LIGHT 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::FILL_SHADE_LIGHT
 

FILL_SHADE_MEDIUM

FILL_SHADE_MEDIUM 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::FILL_SHADE_MEDIUM
 

LINE_BLOCK

LINE_BLOCK 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::LINE_BLOCK
 

LINE_DOUBLE

LINE_DOUBLE 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::LINE_DOUBLE
 

LINE_NONE

LINE_NONE 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::LINE_NONE
 

LINE_SINGLE

LINE_SINGLE 
Inherited

inherited_from \Zend\Console\Adapter\AdapterInterface::LINE_SINGLE