3. Syntax

3. Syntax

Ein JSON Pointer ist eine Unicode-Zeichenkette (siehe [RFC4627], Section 3), die eine Sequenz von null oder mehr Referenz-Tokens (reference tokens) enthält, wobei jedem Token ein '/' (%x2F) Zeichen vorangestellt ist.

Da die Zeichen '' (%x7E) und '/' (%x2F) in JSON Pointer eine besondere Bedeutung haben, muss '' als '~0' und '/' als '~1' kodiert werden, wenn diese Zeichen in einem Referenz-Token erscheinen.

Die ABNF-Syntax eines JSON Pointers lautet:

json-pointer    = *( "/" reference-token )
reference-token = *( unescaped / escaped )
unescaped       = %x00-2E / %x30-7D / %x7F-10FFFF
   ; %x2F ('/') and %x7E ('~') are excluded from 'unescaped'
escaped         = "~" ( "0" / "1" )
  ; representing '~' and '/', respectively

Es ist ein Fehlerzustand (error condition), wenn ein JSON Pointer-Wert nicht mit dieser Syntax übereinstimmt (siehe Section 7).

Beachten Sie, dass JSON Pointers in Zeichen (characters) und nicht als Bytes spezifiziert sind.