Command Text Util
Text Utils is one of the many powerful features offered by Luminova's Framework command-line interface. With this versatile class, you can enhance the appearance of your output text, taking your CLI tool to a new level of elegance and professionalism. Whether you're aiming to beautify your output for end users or simply improve readability during development, Text Utils provides functions to help you achieve your goals with ease.
- Class namespace:
\Luminova\Command\TextUtils
Constants
| Constant | Visibility | Type | Value |
|---|---|---|---|
ANSI_RESET | public | int | 0 |
ANSI_BOLD | public | int | 1 |
ANSI_ITALIC | public | int | 3 |
ANSI_UNDERLINE | public | int | 4 |
ANSI_STRIKETHROUGH | public | int | 9 |
Methods
padStart
Pads string left
public static padStart(string $text, int $length, string $char = ' '): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$length | int | |
$char | string | Padding character |
padEnd
Pads string right
public static padEnd(string $text, int $max, string $char = ' '): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$max | int | maximum padding |
$char | string | Padding character |
border
Create a border around text.
public static border(string $text, ?int $padding = null): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$padding | ?int |
Return Value:
string - Return text with border round.
center
Create a centered text
public static center(string $text, int|null $padding = null): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$padding | int|null | maximum padding |
Return Value:
string - Return centered text.
padding
Pads string both left and right.
public static padding(string $text, int $max, string $char = ' ', int $padd = STR_PAD_BOTH): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$max | int | maximum padding |
$char | string | Padding character |
$padd | int | Padding location default is both left and right |
fit
Pads string to fit same length
public static fit(string $text, int $max, int $extra = 2, int $indent): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | string to pad |
$max | int | maximum padding |
$extra | int | How many extra spaces to add at the end |
$indent | int |
strlen
Get the length of characters in a string and ignore styles
public static strlen(string $string = null, string $encoding = 'UTF-8'): intParameters:
| Parameter | Type | Description |
|---|---|---|
$string | string | Optional string |
$encoding | string | Text encoding |
Return Value:
int - The number of characters in the string
style
Apply style format on text string
public static style(string $text, int|null $format = null, bool $formatted = true): stringParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | Text to style |
$format | int|null | Style to apply text. |
$formatted | bool | Return a formatted string or ansi style code |
Return Value:
string - A style formatted ansi string
hasAnsi
Check if text already has ANSI method in place
public static hasAnsi(string $text): boolParameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | Text string |
Return Value:
bool - true or false
largest
Get the largest line from text.
public static largest(string $text): array<int,mixed>Parameters:
| Parameter | Type | Description |
|---|---|---|
$text | string | Text to process. |
Return Value:
array<int,mixed> - Return largest line from text and it length.