Quiq::Record - Verarbeitung von Text-Records
Quiq::Object
Ein Text-Record ist eine Folge von Schlüssel/Wert-Paaren in Textform, wobei
ein Schlüssel eine Folge von alphanumerischen Zeichen oder Unterstrich ('_') oder Bindestrich ('-') ist, und
ein Wert ein beliebiger einzeiliger oder mehrzeiliger Text ist.
Stringrepräsentation:
Schlüssel1: Wert1 Schlüssel2: Wert2 ...
oder
oder ein Mischung aus beidem oder
@@Schlüssel@@ Wert1 @@Schlüsse2@@ Wert2
Um die dritte Repräsentation (mit @@Schlüssel@@) zu erzeugen, muss als Option -format => '@' angegeben werden.
@keyVal | $keyValA = $class->fromString($str); @keyVal | $keyValA = $class->fromString(\$str);
Lies Text-Record aus Zeichenkette $str, zerlege ihn in Schlüssel/Wert-Paare und liefere die Liste der Schlüssel/Wert-Paare zurück. Im Skalarkontext liefere eine Referenz auf die Liste.
NEWLINEs am Anfang und am Ende eines Werts werden entfernt.
Eine Einrückung innerhalb eines mehrzeiligen Werts wird entfernt. Eine Einrückung ist die längste Folge von Leerzeichen oder Tabs, die allen Zeilen eines mehrzeiligen Werts gemeinsam ist.
@keyVal | $keyValA = $class->fromFile($file,@opt);
Datei, die den Record enthält.
Character Encoding, z.B. 'UTF-8'.
Wie fromString, nur dass der Record aus Datei $file gelesen wird.
$str = $class->toString(@keyVal,@opt); $str = $class->toString(\@keyVal,@opt);
Im Falle von ':' erzeuge das Format:
<KEY>: <VAL>
Im Falle von '@' erzeuge das Format:
@@<KEY>@@ <VAL>
Tiefe der Einrückung.
Ignoriere Schlüssel/Wert-Paare, bei denen der Wert null ist.
Anzahl Leerzeilen zwischen den Einträgen.
Entferne Leerzeilen am Anfang und Whitespace am Ende des Werts.
Generiere für die Schlüssel/Wert-Paare @keyVal eine Text-Record Repräsentation und liefere diese zurück.
$class->toFile($file,@keyVal,@opt); $class->toFile($file,\@keyVal,@opt);
Siehe toString
Wie toString, nur dass der Record auf eine Datei geschrieben wird. Die Methode liefert keinen Wert zurück.
1.208
Frank Seitz, http://fseitz.de/
Copyright (C) 2023 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.