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.