Convert-GitEscapedPath

EulandaXtools — Funktionsreferenz

Convert-GitEscapedPath

ÜBERSICHT

Dekodiert Git-eskapierte Pfadzeichen in gültige UTF-8-Zeichenketten.

SYNTAX

Convert-GitEscapedPath [[-Value] <string>] [<CommonParameters>]

BESCHREIBUNG

Wenn Git-Dateipfade Umlaute oder Sonderzeichen enthalten, werden diese in der Ausgabe von `git diff`, `git status` usw. als oktale Escape-Sequenzen dargestellt (z. B. `\303\234` für `Ü`). Diese Funktion wandelt solche Pfadangaben wieder in korrekt dekodierte UTF-8-Dateinamen zurück.

Umgebende Anführungszeichen (wie sie Git bei escaped Pfaden setzt) werden automatisch entfernt. Neben oktalen Escapes werden auch `\\`, `\"`, `\t` und `\n` korrekt behandelt.

Falls der Pfad keine Escape-Sequenzen enthält (z. B. bei `core.quotepath=false`), wird er unverändert durchgereicht.

PARAMETER

-Value

Type: string

Ein Pfad oder Dateiname mit eventuell enthaltenen Git-Escape-Sequenzen (z. B. `\303\244` für `ä`).

AUSGABEN

[string] -- Der dekodierte Pfad als UTF-8-Zeichenkette.

Bei ungültigen Sequenzen wird der Originalwert zurückgegeben.

BEISPIELE

Convert-GitEscapedPath -Value '"\303\234berblick.md"'
# Gibt zurück: 'Überblick.md'
Convert-GitEscapedPath -Value 'content/docs/\303\204nderungen.md'
# Gibt zurück: 'content/docs/Änderungen.md'
Convert-GitEscapedPath -Value 'bereits-dekodiert.md'
# Gibt unverändert zurück: 'bereits-dekodiert.md'