Ucieczka znaków

Czym jest escapowanie znaków?

Escapowanie znaków polega na wstawieniu odwrotnego ukośnika (lub innego znacznika) przed znakami mającymi specjalne znaczenie wewnątrz literału ciągu znaków. Gdy parser języka programowania napotka cudzysłów wewnątrz ciągu ujętego w cudzysłowy, traktuje go jako koniec ciągu. Escapowanie cudzysłowu odwrotnym ukośnikiem — zapisanie \" zamiast " — informuje parser, że należy traktować go jako dosłowny znak, a nie ogranicznik. Każdy język korzystający z literałów ciągów ma swoje reguły escapowania, choć konkretne sekwencje mogą się różnić.

Najczęstsze sekwencje ucieczki odpowiadają znakom białym i znakom sterującym, które nie mogą pojawić się bezpośrednio w kodzie źródłowym. Znak nowej linii staje się \n, tabulator staje się \t, a dosłowny odwrotny ukośnik staje się \\. Konwencje te wywodzą się z języka C (ISO/IEC 9899) i zostały przyjęte przez JavaScript (ECMA-262), Python, Java, Go i Rust. JSON (RFC 8259) stosuje tę samą składnię, ale obsługuje mniejszy zestaw sekwencji.

De-escapowanie (niekiedy zwane "odwrotnym escapowaniem") to operacja odwrotna: przekształcanie sekwencji ucieczki z powrotem w oryginalne znaki. Jest powszechnie stosowane podczas czytania plików dziennika, parsowania odpowiedzi API lub debugowania danych, które zostały podwójnie escapowane. Obie operacje są mechaniczne i podatne na błędy przy wykonywaniu ręcznie, dlatego programiści sięgają po narzędzie do escapowania/de-escapowania podczas pracy z ciągami wieloliniowymi, osadzonymi cudzysłowami lub znakami Unicode.

Dlaczego warto używać narzędzia do escapowania online?

Ręczne dodawanie lub usuwanie odwrotnych ukośników jest żmudne i łatwe do wykonania błędnie, szczególnie przy zagnieżdżonych cudzysłowach lub wieloliniowym wejściu. Przeglądarkowe narzędzie do escapowania daje natychmiastowe wyniki bez konieczności konfigurowania REPL-a ani pisania jednorazowych skryptów.

Przypadki użycia escapowania znaków

Tabela sekwencji ucieczki

Poniższa tabela zawiera listę powszechnych sekwencji ucieczki oraz informację, czy są obsługiwane w JavaScript, Python i JSON. Wszystkie trzy języki współdzielą podstawowy zestaw (nowa linia, tabulator, odwrotny ukośnik, cudzysłów), ale różnią się w zakresie pojedynczych cudzysłowów, sekwencji szesnastkowych i rozszerzonej notacji Unicode.

JavaScript vs Python vs JSON — porównanie escapowania

Chociaż te trzy formaty korzystają z tej samej składni opartej na odwrotnym ukośniku, różnią się pod względem tego, które sekwencje są prawidłowe i jak obsługują przypadki brzegowe. Wybór niewłaściwego trybu daje wynik, który wygląda poprawnie, ale zawodzi w czasie parsowania.

Przykłady kodu

Przykłady escapowania i de-escapowania ciągów znaków w JavaScript, Python, Go i wierszu poleceń.

// Escape a string with special characters
const raw = 'Line 1\nLine 2\tTabbed "quoted"';
const escaped = JSON.stringify(raw);
// → '"Line 1\\nLine 2\\tTabbed \\"quoted\\""'

// Unescape a JSON string value
const input = '"Hello\\nWorld"';
const unescaped = JSON.parse(input);
// → "Hello\nWorld" (actual newline character)

// Template literals don't need quote escaping
const tpl = `She said "hello"`;
// → 'She said "hello"' — no backslashes needed

// Escape for use inside a RegExp
const query = 'price: $5.00 (USD)';
const safe = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
// → "price: \\$5\\.00 \\(USD\\)"

# Escape with repr() — shows escape sequences
raw = "Line 1\nLine 2\t'quoted'"
print(repr(raw))
# → "Line 1\nLine 2\t'quoted'"

# Raw strings skip escape processing
path = r"C:\Users\name\Documents"
print(path)
# → C:\Users\name\Documents (backslashes kept literal)

# JSON escaping with json module
import json
data = 'He said "hello\nworld"'
escaped = json.dumps(data)
# → '"He said \\"hello\\nworld\\""'

# Unicode escaping
text = "Caf\u00e9"  # → "Café"
print(text.encode('unicode_escape').decode())
# → "Caf\\xe9"

package main

import (
    "fmt"
    "strconv"
    "encoding/json"
)

func main() {
    // strconv.Quote adds escape sequences and wraps in quotes
    raw := "Line 1\nLine 2\t\"quoted\""
    fmt.Println(strconv.Quote(raw))
    // → "\"Line 1\\nLine 2\\t\\\"quoted\\\"\""

    // strconv.Unquote reverses it
    unescaped, _ := strconv.Unquote(`"hello\nworld"`)
    fmt.Println(unescaped)
    // → hello
    //   world

    // JSON marshal handles escaping automatically
    b, _ := json.Marshal("tabs\there & \"quotes\"")
    fmt.Println(string(b))
    // → "tabs\there \u0026 \"quotes\""
}

# Use $'...' syntax for escape sequences in bash
echo $'Line 1\nLine 2\tTabbed'
# → Line 1
#    Line 2	Tabbed

# printf interprets escape sequences
printf 'Path: C:\\Users\\name\n'
# → Path: C:\Users\name

# Use jq to escape a string for JSON
echo 'He said "hello"' | jq -Rs .
# → "He said \"hello\"\n"

# Unescape JSON string with jq
echo '"Line 1\\nLine 2"' | jq -r .
# → Line 1
#    Line 2

Często zadawane pytania