Split-IdentIntoLines #

ÜBERSICHT #

Teilt einen beliebigen Text in eine angegebene Anzahl von Zeilen mit maximaler Zeichenlänge.

SYNTAX #

Split-IdentIntoLines [[-Ident] <string>] [[-MaxLength] <int>] [[-MaxLines] <int>]
    [<CommonParameters>]

BESCHREIBUNG #

Die Funktion teilt einen gegebenen Text (‘Ident’) so auf, dass er auf mehrere Zeilen verteilt wird. Dabei wird versucht, ganze Wörter in einer Zeile zu lassen, sofern sie die maximale Zeichenanzahl nicht überschreiten. Wörter, die länger als ‘MaxLength’ sind, werden hart umgebrochen. Die Rückgabe ist eine Hashtable mit Schlüsseln wie ‘LINE1’, ‘LINE2’, …, bis zur angegebenen Anzahl ‘MaxLines’. Nicht genutzte Zeilen werden als ‘$null’ gesetzt. Ist der Text zu lang für die Zeilenanzahl, wird der Rest abgeschnitten und als Warnung ausgegeben.

PARAMETER #

-Ident #

Type: string

Der Eingabetext, der auf mehrere Zeilen verteilt werden soll.

-MaxLength #

Type: int
Default: 40

Die maximale Zeichenanzahl pro Zeile. Standard: 40.

-MaxLines #

Type: int
Default: 3

Die maximale Anzahl der Zeilen (Default: 3). Erzeugt LINE1 bis LINEn.

AUSGABEN #

hashtable

Enthält Schlüssel ‘LINE1’ bis ‘LINEn’ mit aufgeteiltem Text oder ‘$null’.

BEISPIELE #

Split-IdentIntoLines -Ident "Dies ist ein sehr langer Text der sinnvoll umgebrochen werden soll." -MaxLines 3

HINWEISE #

Gibt bei abgeschnittenem Text eine farbige Warnung auf der Konsole aus.