Quiq::AnsiColor - Erzeuge Text mit/ohne ANSI Colorcodes
Quiq::Object
use Quiq::AnsiColor; my $a = Quiq::AnsiColor->new(-t STDOUT); say $a->str('bold white on_cyan','Hello, world!');
Die Klasse erlaubt es, Textausgaben - die typischerweise aufs Terminal gehen - mit ANSI Colorcodes auszuzeichnen und diese Auszeichnung bei Aufruf des Konstruktors zentral an- oder ab-zuschalten.
Allgemein Vordergrund Hintergrund ----------- ----------- ----------- dark black on_black bold red on_red underline green on_green blink yellow on_yellow reverse blue on_blue concealed magenta on_magenta reset cyan on_cyan white on_white
Es kann eine Kombination aus Eigenschaften angegeben werden. Mehrere aus der Rubrik "Allgemein", eine aus der Rubrik "Vordergrund", eine aus der Rubrik "Hintergrund". Werden mehrere Eigenschaften angegeben, werden diese durch Leerzeichen getrennt.
Beispiele: 'bold reverse' oder 'dark red on_green'
Die im folgenden genannten Programme aha, wkhtmltopdf sind im Debian-Repository enthalten.
aha
wkhtmltopdf
$ PROGRAM | aha | wkhtmltopdf - FILE.pdf
$ PROGRAM | aha | wkhtmltopdf - - | lpr
$ PROGRAM | less -R
$a = $class->new; $a = $class->new($bool);
Wenn wahr, findet eine Auszeichnung mit ANSI Colorcodes statt, wenn falsch, nicht. Ist das Argument nicht angegeben, ist dies gleichbedeutend mit wahr.
AnsiColor-Objekt
Instantiiere ein Objekt der Klasse und liefere dieses zurück. Durch den Parameter $bool wird entschieden, ob die Methode str() ihren Rückgabewert mit oder ohne ANSI Colorcodes liefert.
$bool = $a->active;
Bool
Liefere wahr, wenn ANSI Colorcodes aktiviert sind, anderfalls falsch.
$str = $a->str($attr,$str);
Attribut-Spezifikation gemäß Term::ANSIColor (siehe auch Terminal-Eigenschaften).
Zeichenkette, die mit ANSI Colorcodes formatiert wird.
Zeichenkette mit ANSI Colorcodes (String)
Formatiere Zeichenkette $str mit ANSI Colorcodes gemäß Spezifikation $attr und liefere das Resultat zurück. Die Colorcodes werden der Zeichenkette vorangestellt und mit dem Colorcode 'reset' beendet. Ist die Erzeugung von Colorcodes abgeschaltet, wird die Zeichenkette unverändert geliefert.
$str = $a->strLn($attr,$str);
Siehe str()
Wie str(), nur dass das Resultat mit einem Newline terminiert wird.
1.178
Frank Seitz, http://fseitz.de/
Copyright (C) 2020 Frank Seitz
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Quiq, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Quiq
CPAN shell
perl -MCPAN -e shell install Quiq
For more information on module installation, please visit the detailed CPAN module installation guide.