JSONPATH

Icône du lien vers le conceptVoir également Icône du lien vers le conceptExemple

Traitement de données au format Json.

Support WebVue - Oui.

Mode

Mnémonique

Syntaxe

1 GET 1
2 GETSTR 2
3 GETDOUBLE 3
4 GETSINGLE 4
5 GETLONG 5
6 GETINT 6
7 GETBOOL 7
8 LOAD 8
9 UNLOAD 9
10 LOADFILE 10

Arguments communs à plusieurs modes

Argument

Description

Namespace

Identifiant du fragment Json utilisé comme entrée. Type STR ou LONG.

JsonPath

Nom d'une clé Json sous la forme d'un chemin Json. Type STR ou LONG.

Syntaxe 1

LongVal = JsonPath(Mode, Namespace, JsonPath);

Type de retour : LONG.

Exécution

Mode

Mnémonique

Action

1

GET

Retourne un handle pour la clé JsonPath dans Namespace.

LongVal est automatiquement alloué et réalloué si le verbe est appelé cycliquement. Il n'y a pas besoin de faire une allocation via ALLOC_BUFFER. Il n'y a pas de limite sur la taille du buffer, nous recommandons donc au concepteur du projet d'être attentif lorsqu'il manipule de gros fragments Json car cela peut requérir une grande quantité de mémoire.

Le Handle LongVal est désalloué à la fin, lorsque le mode UNLOAD est appelé.

Syntaxe 2

StrVal = JsonPath(Mode, Namespace, JsonPath);

Type de retour : STR.

Exécution

Mode

Mnémonique

Action

2

GETSTR

Retourne la valeur sous forme chaîne de caractères pour la clé JsonPath dans Namespace.

Syntaxe 3

DoubleVal = JsonPath(Mode, Namespace, JsonPath);

Type de retour : DOUBLE.

Exécution

Mode

Mnémonique

Action

3

GETDOUBLE

Retourne la valeur sous forme de Double pour la clé JsonPath dans Namespace.

Syntaxe 4

SingleVal = JsonPath(Mode,Namespace, JsonPath);

Type de retour : DOUBLE.

Exécution

Mode

Mnémonique

Action

4

GETSINGLE

Retourne la valeur sous forme de Single pour la clé JsonPath dans Namespace.

Syntaxe 5

LongVal = JsonPath(Mode, Namespace, JsonPath);

Type de retour : LONG

Exécution

Mode

Mnémonique

Action

5

GETLONG

Retourne la valeur sous forme de Long pour la clé JsonPath dans Namespace.

Syntaxe 6

IntVal = JsonPath(Mode,Namespace, JsonPath);

Type de retour : INTEGER

Exécution

Mode

Mnémonique

Action

6

GETINT

Retourne la valeur sous forme d'Integer pour la clé JsonPath dans Namespace.

Syntaxe 7

IntVal = JsonPath(Mode, Namespace, JsonPath);

Type de retour : INTEGER.

Exécution

Mode

Mnémonique

Action

7

GETBOOL

Retourne la valeur sous forme de Booléen (type Integer) pour la clé JsonPath dans Namespace.

  • 1 pour <true>
  • 0 pour <false>

Syntaxe 7

IntVal = JsonPath(Mode, Namespace, JsonData);

Type de retour : INTEGER

Argument

Description

JsonData

Une chaîne de caractères formatée en Json. Type STR.

Ou un handle vers un buffer contenant une chaîne formatée en Json. Type LONG.

Exécution

Mode

Mnémonique

Action

8

LOAD

Charge et mappe un fragment Json passé sous forme d'une chaîne de caractères, vers le Namespace spécifié.

Retour : 1 si OK, -1 si erreur de parsing Json.

Syntaxe 8

IntVal = JsonPath(Mode, Namespace);

Type de retour : INTEGER

Exécution

Mode

Mnémonique

Action

9

UNLOAD

Décharge et démappe le fragment Json du Namespace spécifié.

Retour : Toujours 0.

UNLOAD doit être utilisé une fois que les opérations Json sont terminées pour libérer la mémoire allouée par les modes LOAD ou LOADFILE.

Syntaxe 10

IntVal = JsonPath(Mode, Namespace, JsonFilename);

Type de retour : INTEGER.

Argument

Description

JsonFilename Nom du fichier Json à charger. Type STR ou LONG.

Exécution

Mode

Mnémonique

Action

10

LOADFILE

Charge et mappe un fragment Json à partir d'un fichier vers le Namespace spécifié.

Retour : 1 si OK, -1 si erreur de parsing Json, -2 si fichier introuvable.

Si exécutée dans le contexte d'une session WebVue, cette instruction est traitée par le back end web, en conséquence de quoi le fichier référencé est sur la machine back end web.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.