Class Posix

Summary

Fully Qualified Name: Laminas\Console\Adapter\Posix
Extends: AbstractAdapter

Description

Methods

Name Description Defined By
clear() Reset color to console default. Posix
clearLine() Clear line at cursor position AbstractAdapter
clearScreen() Clear console screen AbstractAdapter
colorize() Prepare a string that will be rendered in color. Posix
encodeText() Encode a text to match console encoding AbstractAdapter
getCharset() Get charset currently in use by this adapter. Posix
getDefaultCharset() Posix
getHeight() Determine and return current console height. Posix
getSize() Determine and return current console width and height. AbstractAdapter
getTitle() Return current console window title. AbstractAdapter
getWidth() Determine and return current console width. Posix
hideCursor() Hide console cursor Posix
isUtf8() Check if console is UTF-8 compatible Posix
readChar() Read a single character from the console input Posix
readLine() Read a single line from the console input AbstractAdapter
resetColor() Reset color to console default. Posix
setBgColor() Change current drawing background color Posix
setCharset() Set Console charset to use. Posix
setColor() Change current drawing color. Posix
setPos() Set cursor position Posix
showCursor() Show console cursor Posix
write() Write a chunk of text to console. AbstractAdapter
writeAt() Write a piece of text at the coordinates of $x and $y AbstractAdapter
writeBox() Write a box at the specified coordinates. AbstractAdapter
writeLine() Write a single line of text to console and advance cursor to the next line. Posix
writeText() Alias for write() AbstractAdapter
writeTextBlock() Write a block of text at the given coordinates, matching the supplied width and height. AbstractAdapter

Method Details

clear()

Reset color to console default.

Returns:

clearLine()

Clear line at cursor position

Returns:

clearScreen()

Clear console screen

Returns:

colorize()

Prepare a string that will be rendered in color.

Parameter Name Type Description
$string string
$color int
$bgColor null|int

Returns: string

encodeText()

Encode a text to match console encoding

Parameter Name Type Description
$text string

Returns: string the encoding text

getCharset()

Get charset currently in use by this adapter.

Returns: \Charset\CharsetInterface $charset

getDefaultCharset()

Returns: \Charset\CharsetInterface

getHeight()

Determine and return current console height.

Returns: bool|int

getSize()

Determine and return current console width and height.

Returns: int[] array($width, $height)

getTitle()

Return current console window title.

Returns: string

getWidth()

Determine and return current console width.

Returns: int

hideCursor()

Hide console cursor

Returns:

isUtf8()

Check if console is UTF-8 compatible

Returns: bool

readChar()

Read a single character from the console input

Parameter Name Type Description
$mask string|null A

Returns: string

readLine()

Read a single line from the console input

Parameter Name Type Description
$maxLength int Maximum

Returns: string

resetColor()

Reset color to console default.

Returns:

setBgColor()

Change current drawing background color

Parameter Name Type Description
$bgColor int

Returns:

setCharset()

Set Console charset to use.

Parameter Name Type Description
$charset \Charset\CharsetInterface

Returns:

setColor()

Change current drawing color.

Parameter Name Type Description
$color int

Returns:

setPos()

Set cursor position

Parameter Name Type Description
$x int
$y int

Returns:

showCursor()

Show console cursor

Returns:

write()

Write a chunk of text to console.

Parameter Name Type Description
$text string
$color null|int
$bgColor null|int

Returns:

writeAt()

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

Parameter Name Type Description
$text string Text
$x int Console
$y int Console
$color null|int
$bgColor null|int

Returns:

writeBox()

Write a box at the specified coordinates.

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).

Parameter Name Type Description
$x1 int Top-left
$y1 int Top-left
$x2 int Bottom-right
$y2 int Bottom-right
$lineStyle int (optional)
$fillStyle int (optional)
$color int (optional)
$bgColor int (optional)
$fillColor null|int (optional)
$fillBgColor null|int (optional)

Returns:

writeLine()

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

This override works around a bug in some terminals that cause the background color to fill the next line after EOL. To remedy this, we are sending the colored string with appropriate color reset sequences before sending EOL character.

Parameter Name Type Description
$text string
$color null|int
$bgColor null|int

Returns:

writeText()

Alias for write()

Parameter Name Type Description
$text string
$color null|int
$bgColor null|int

Returns:

writeTextBlock()

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

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.

Parameter Name Type Description
$text string Text
$width int Maximum
$height int|null Maximum
$x int Block
$y int Block
$color null|int (optional)
$bgColor null|int (optional)

Returns:

Top