Funzioni di parsing

Le funzioni di parsing leggono valori dal testo restituito da un dispositivo — tipicamente la risposta di una richiesta HTTP o un messaggio ricevuto in uno script Packet parser. Accettano una stringa, una collezione di byte (collection<uint8>) o un blob, funzionano in ogni script e richiedono Core 2022.2 o più recente.

PARSETEXT#

PARSETEXT restituisce la parte di un testo che segue un modello sinistro e termina prima di un modello destro; quando quella parte è un numero, viene restituito un numero.

1
2

PARSETEXT(source, leftPattern)
PARSETEXT(source, leftPattern, rightPattern)

Valore restituito — un numero quando il testo trovato si legge come numero (con il punto decimale), altrimenti il testo senza spazi iniziali e finali. Null quando il modello sinistro non viene trovato.

Quando il modello sinistro viene trovato ma quello destro no, lo script si interrompe con l’errore Specified argument was out of the range of valid values. — non restituisce Null. Quando il modello destro può mancare, verificalo prima con INDEXOF (verificato su Core 2026.1, build 40599).

Esempio

PARSETEXT("Lorem ipsum dolor sit amet", "ipsum", "amet");
# Result: "dolor sit"
PARSETEXT("<temp>12.2</temp>", "<temp>", "</temp>");
# Result: 12.2
PARSETEXT("<temp>12.2</temp>", "<temp>");
# Result: 12.2
PARSETEXT("status:ok,error:none", "status:");
# Result: "ok"
PARSETEXT("Lorem ipsum dolor sit amet", "ipsum...sit");
# Result: "amet"
PARSETEXT("Lorem ipsum dolor sit amet consectetur adipiscing", "ipsum...sit", "adipiscing");
# Result: "amet consectetur"
PARSETEXT("a=1", "b=");
# Result: Null

Esempio — modello destro che può mancare

VAR start := INDEXOF(text, "temp=");
IF start < 0 OR INDEXOF(COPY(text, start), ";") < 0
    RETURN(NaN);
END
PARSETEXT(text, "temp=", ";");

Vedi anche — INDEXOF, COPY.

PARSEJSON#

PARSEJSON legge un valore da JSON con un’espressione JSONPath; con TRUE come terzo argomento restituisce Null invece di interrompere lo script quando il percorso non viene trovato.

1
2

PARSEJSON(json, path)
PARSEJSON(json, path, ignoreError)

Valore restituito — il valore nel percorso: una stringa, un numero o un bool. Più corrispondenze vengono restituite come collezione. Un oggetto o un array viene restituito come testo JSON, che può essere analizzato di nuovo.

Esempio — con json che contiene:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "firstName": "John",
  "lastName": "Doe",
  "age": 26,
  "address": {
    "streetAddress": "Naist street",
    "city": "Nara",
    "postalCode": "630-0192"
  }
}

PARSEJSON(json, "firstName");
# Result: "John"
PARSEJSON(json, "address.city");
# Result: "Nara"
PARSEJSON(json, "age");
# Result: 26
PARSEJSON(json, "address.country", TRUE);
# Result: Null

PARSEJSON(json, "address.country") senza il terzo argomento interrompe lo script con PARSEJSON - Element not found: ‘address.country’.

Esempio — ciclo su un array JSON

Con TRUE, PARSEJSON restituisce Null dopo l’ultimo elemento, il che termina il ciclo:

VAR i := 0;
VAR names := "";
VAR name := PARSEJSON(json, "$.devices[0].name", TRUE);
WHILE !ISNULL(name)
    names := names + name + "\n";
    i := i + 1;
    name := PARSEJSON(json, "$.devices[" + TOSTRING(i) + "].name", TRUE);
LOOP
names;

Errori — PARSEJSON - Element not found: ‘path’; PARSEJSON - parse error: … (JSON non valido); PARSEJSON - argument 1 is null.

PARSEXML#

PARSEXML legge un valore da XML con un’espressione XPath e restituisce il valore del primo nodo corrispondente.

1

PARSEXML(xml, xpath)

Valore restituito — il valore del primo nodo: un numero quando il testo si legge come numero, altrimenti una stringa; Null quando non c’è nessuna corrispondenza. Le funzioni XPath restituiscono il proprio risultato, ad esempio un numero da count().

Note

• I numeri nel testo dei nodi vengono letti secondo le impostazioni di lingua dell’unità di controllo. Per leggere un numero con il punto decimale indipendentemente da esse, racchiudi il percorso nella funzione XPath number().
• I namespace dichiarati nel documento vengono registrati automaticamente. Un namespace con prefisso (xmlns:dc="…") si usa con il suo prefisso; un namespace predefinito (xmlns="…") prende il nome dell’elemento che lo dichiara — per <DIDL-Lite xmlns="…"> scrivi DIDL-Lite:container.
• I documenti più piccoli di 80 kB e le espressioni compilate vengono messi in cache, quindi le chiamate ripetute sulla stessa risposta sono poco costose.

Esempio — con la risposta che contiene:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

<?xml version="1.0"?>
<catalog>
  <book id="bk101">
    <title>XML Developer's Guide</title>
    <price>44.95</price>
  </book>
  <book id="bk102">
    <title>Midnight Rain</title>
    <price>5.95</price>
  </book>
</catalog>

VAR xml := response.Content;
PARSEXML(xml, "//book[2]/title");
# Result: "Midnight Rain"
PARSEXML(xml, "//book[1]/@id");
# Result: "bk101"
PARSEXML(xml, "number(//catalog/book[1]/price)");
# Result: 44.95
PARSEXML(xml, "count(//book)");
# Result: 2
PARSEXML(xml, "//catalog/magazine[1]/price");
# Result: Null

Esempio — XML con namespace

VAR xml := response.Content;
PARSEXML(xml, "//DIDL-Lite:container[dc:title='My Playlist']/DIDL-Lite:res");

Errori — PARSEXML - parse error: … (XML o XPath non valido).

Vedi anche — SENDHTTPREQUEST, DECODE.