CheatSheet pour travailler avec les globales

Nom de fonction (commande) et sa description

COS syntaxe

COS exemples

Python syntaxe

Python exemples

Java syntaxe

Java exemples

set - attribue une valeur à une variable

set:pc argument, ...

où pc est post condition (facultative) et argument peut être soit 

variable = valeur

soit

(liste de variables) = valeur

set ^z = 648
//attribue une valeur 648 à une globale ^z
set ^a = 10, ^b(“dif”) = 21, ^b(10) = 8
//attribute une valeur 10 à une globale ^a, une valeur 21 à une globale ^b(“dif”) et une valeur 8 à une globale ^b(10)
set:^a=10 ^c = “string”
//attribue une valeur “string” à une globale ^c si une globale ^a a une valeur 10
set (^x, ^y) = “string” 
//attribue une valeur “string” aux globales ^x et ^y

iris.set(value, globalName, *subscripts)

où value est la valeur de datatype supportée, globalName est le nom de la globale et subscripts sont la liste des indices (une ou zéro des indices)

# attribue une valeur "A" à une globale ^root("foo", "SubFoo"), la même chose que set ^root("foo", "SubFoo") = "A"
iris.set('A', 'root', 'foo', 'SubFoo')
# attribue une valeur 123 à une globale ^root("bar", "lowbar", "UnderBar"), la même chose que set ^root("bar", "lowbar", "UnderBar") = 123
iris.set(123, 'root', 'bar', 'lowbar', 'UnderBar')
# attribue une valeur 963 à une globale ^root, la même chose que set ^root = 123
iris.set(963, 'root')

void jdbc.IRIS.set(value, globalname, subscripts)

où value est la valeur de datatype supportée, globalname est le nom de la globale et subscripts sont la liste des indices (une ou zéro des indices)

iris.set("A", "root", "foo", "SubFoo");
//attribue une valeur "A" à une globale ^root("foo", "SubFoo"), la même chose que set ^root("foo", "SubFoo") = "A"
iris.set(123, "root", "bar", "lowbar", "UnderBar");
//attribue une valeur 123 à une globale ^root("bar", "lowbar", "UnderBar"), la même chose que set ^root("bar", "lowbar", "UnderBar") = 123
iris.set(963, "root");
//attribue une valeur 963 à une globale ^root, la même chose que set ^root = 963

increment – augmente la global spécifié avec la valeur passée. S'il n'y a pas de nœud à l'adresse spécifiée, un nouveau nœud est créé avec la valeur passée.

$increment(variable, num)

où variable est la variable la valeur de laquelle doit être changée et num est l'incrément numérique que vous souhaitez ajouter (facultatif, par défaut = 1)

set ^b=$increment(^a)
//^b =11
set ^c=$increment(^a, -3)
//^c = 7

iris.increment(value, globalName, *subscripts)

où value est la valeur numérique, globalName est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

iris.increment(-2, 'myGlobal', 'B')
# diminue la valeur du nœud ^myGlobal("B") par 2

long increment(value, globalname, subscripts)

où value est la valeur numérique, globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

//diminue la valeur du nœud ^myGlobal("B") par 2
iris.increment(-2, "myGlobal", "B");

get - obtient une valeur de la globale

$get(variable, defaut)

où variable est la variable la valeur de laquelle on veut obtenir et defaut est la valeur à renvoyer si la variable n'est pas définie (facultative).

set val = $get(^b(“dif”))
//val = 21
set val = $get(^b(1), 100)
//val = 100

iris.get(globalName, *subscripts)

iris.getBoolean(globalName, *subscripts)

iris.getBytes(globalName, *subscripts)

iris.getFloat(globalName, *subscripts)

iris.getLong(globalName ,*subscripts)

iris.getString(globalName, *subscripts)

où globalName est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices).

# obtient la valeur string de la globale ^root("foo", "SubFoo")
subfoo = iris.getString('root', 'foo', 'SubFoo')
# obtient la valeur de la globale ^root("bar", "lowbar", "UnderBar")
underbar = iris.get('root', 'bar', 'lowbar', 'UnderBar')

Boolean jdbc.IRIS.getBoolean(globalname, subscripts)

byte[] jdbc.IRIS.getBytes(globalname, subscripts)

Date jdbc.IRIS.getDate(globalname, subscripts)

Double jdbc.IRIS.getDouble(globalname, subscripts)

Float jdbc.IRIS.getFloat(globalname, subscripts)

InputStream jdbc.IRIS.getInputStream(globalname, subscripts)

Integer jdbc.IRIS.getInteger(globalname, subscripts)

Long jdbc.IRIS.getLong(globalname, subscripts)

Object jdbc.IRIS.getObject(globalname, subscripts)

Reader jdbc.IRIS.getReader(globalname, subscripts)

Short jdbc.IRIS.getShort(globalname, subscripts)

String jdbc.IRIS.getString(globalname, subscripts)

Time jdbc.IRIS.getTime(globalname, subscripts)

Timestamp jdbc.IRIS.getTimestamp(globalname, subscripts)

IRISList jdbc.IRIS.getIRISList(globalname, subscripts)

où globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices). Si le nœud n’existe pas la fonction retourne null.

String subfoo = iris.getString("root", "foo", "SubFoo");
//obtient la valeur de la globale ^root("foo", "SubFoo")
Integer underbar = iris.getInteger("root");
//obtient la valeur de la globale ^root
Object obj = iris.getObject("root", "nothing");
//dans ce cas obj = null

kill – supprime des variables avec tous leurs nœuds descendants

kill:pc argument, ...

où pc est post condition (facultative) et argument (facultatif) peut être soit 

variable, ...

soit

(variable, ...)

kill ^a
//supprime une globale ^a avec tous leurs nœuds descendants
kill ^b, ^c
//supprime des globales ^b et ^c avec tous leurs nœuds descendants
kill:^a=10 ^z
//supprime une globale ^z avec tous leurs nœuds descendants si une globale ^a a une valeur 10

iris.kill(globalName, *subscripts)

où globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

iris.kill('myGlobal', 'A')
# supprime la variable ^myGlobal('A') et tous ses nœuds descendants

jdbc.IRIS.kill(globalName, subscripts)

où globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

kill("root", "foo", "SubFoo") ;
//supprime la variable ^root('foo', 'SubFoo') et tous ses nœuds descendants

zkill:pc nœud, ...

où pc est post condition (facultative) et nœud est le noud exact de la globale

zkill ^b(“dif”)
//supprime un nœud ^b(“dif”), laisse tous les autres nœuds

data/isDefined – renvoie une valeur indiquant si le nœud spécifié existe et s'il contient une valeur. Elle peut renvoyer quatre valeurs : 0 — le nœud spécifié n'existe pas ; 1 — le nœud existe et a une valeur ; 10 — le nœud est sans valeur mais a des sous-nœuds ; 11 — le nœud a à la fois une valeur et des sous-nœuds.

$data(variable, target)

où variable est la variable a vérifier et target est la variable où on renvoie la valeur actuelle de la variable (facultative)

set val = $data(^a)
//val = 1
set val = $data(^b)
//val = 10
set val = $data(^qqch)
//val = 0

iris.isDefined(globalName, *subscripts)

où globalName est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

if iris.isDefined('root')%10 > 0:
        print(iris.get('root'))
# si le nœud ^root a de valeur, l’imprime

int jdbc.IRIS.isDefined(globalName, subscripts)

où globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

//si le nœud ^root("foo") n’existe pas
if isDefined("root", "foo") ==0 {
//crée le nœud ^root("foo") avec la valeur 74
 iris.set(74, "root", "foo");
}

iterator - itère sur un ensemble de sous-nœuds.

$order(variable, direction, target)

où variable est la variable à partir de laquelle commence le parcours en largeur, direction est l’ordre croissant (1, par défaut) ou décroissant (-1) dans lequel on parcourt l’arbre (facultatif) et target est la variable où on renvoie la valeur actuelle de la variable trouvée (facultative)

 set mydata(1) = "a", mydata(-3) = "C", mydata(5) = "e", mydata(-5) = "E"
 set key = $order(mydata(""))
 while (key'="") {
    write key, ", "
    // obtient le nouvel indice
    set key = $order(mydata(key))
   }
 // -5, -3, 1, 5,

iris.iterator(globalName, *subscripts) - renvoie un objet iterator pour le nœud spécifié,

où globalName est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

# reçoit l’iterateur
subscript_iter = iris.iterator('root')
for subscript, value in subscript_iter:
 # imprime l’indice et la valeur des sous-nœuds
 print("subscript = {}, value = {}".format(subscript, value))

IRISIterator getIRISIterator(globalName, subscripts) - renvoie un objet IRISIterator pour le nœud spécifié,

où globalname est le nom de globale et subscripts sont la liste des indices (une ou zéro des indices)

//reçoit l’iterateur
IRISIterator iter = iris.getIRISIterator("myNames","people");
//vérifie si le nœud suivant existe
while (iter.hasNext()) {
  //cherche le nœud suivant
  iter.next();
  //imprime la valeur d’indice et de nœud 
  System.out.print(" \"" + iter.getSubscriptValue() + "\"=" + iter.getValue());             
};

iterator.items() – renvoi l’iterateur qui contient les indices et les valeurs

boolean hasNext() – renvoie true si l'itérateur a un élément suivant

$qsubscript(namevalue, intexpr)

où namevalue est le string avec le nom de variable et intexpr est un numéro qui spécifie le nom à renvoyer : nom de l'espace de noms (-1), nom de la variable(0) ou nom de l'indice(1-..)

 set ^grocerylist("food","fruit",1)="apples"
 write $qsubscript($name(^grocerylist("food","fruit",1)), 0)
//^grocerylist
 write $qsubscript($name(^grocerylist("food","fruit",1)), 1)
//food
 write $qsubscript($name(^grocerylist("food","fruit",1)), 2)
//fruit
 write $qsubscript($name(^grocerylist("food","fruit",1)), 3)
//1

iterator.values() – renvoi l’iterateur qui contient juste les valeurs

boolean hasPrevious() – renvoie true si l'itérateur a un élément précèdent

iterator.subscripts() – renvoi l’iterateur qui contient juste les indices

String next() – renvoie l’élément suivant

$qlength(var)

où var est le string avec le nom de variable dont la fonction compte le nombre d'indices

write $qlength($name(^grocerylist("food","fruit",1)))
//3

iterator.reversed() – renvoi l’iterateur dans la direction opposée de la précédente

String previous() – renvoie l’élément suivant

//reçoit l’iterateur
IRISIterator iter = iris.getIRISIterator("myNames","people");
//vérifie si le nœud précèdent existe
while (iter.hasPrevious()) {
  //cherche le nœud précédent
  iter.previous();
  //imprime la valeur de l’indice et du nœud 
   System.out.print(" \"" + iter.getSubscriptValue() + "\"");

};

iterator.next() – renvoi l’indice, la valeur ou tous les deux du nœud suivant (ou précèdent)

# reçoit l’iterateur
iterNode= iris.iterator('root').subscripts()
output = "\nSubscripts under node root: "
try:
    while True:
        output += '%s ' % iterNode.next()
except StopIteration:
        print(output + '\n')
        # pour finir le boucle

Object getValue() – obtient la valeur du nœud à la position actuelle de l'itérateur

$query(reference, direction, target)

où reference est la variable à partir de laquelle commence le parcours en profondeur, direction est l’ordre croissant (1, par défaut) ou décroissant (-1) dans lequel on parcour l’arbre (facultatif) et target est la variable où on renvoie la valeur actuelle de la variable trouvée (facultative)

 set ^a = 10
 set ^a(10) = 100
 set ^a("Bonjour") = 200
 set ^a(10, "Salut") = 300
 set ^a(10, 150) = 80
 set x = "^a"
 for {
   set x = $query(@x)
   quit:x=""
   write x, ", "
 }
 //^a(10), ^a(10,150), ^a(10,"Salut"), ^a("Bonjour"),

iterator.startFrom(subscript) – renvoi l’iterateur qui commence par le nœud subscript

void startFrom(subscript) – définit la position de départ de l'itérateur à l'indice spécifié

où subscript est un point de départ arbitraire et n'a pas besoin de spécifier un nœud existant

void remove() – supprime de la collection sous-jacente le dernier élément renvoyé par cet itérateur

String getSubscriptValue() – obtient l'indice de niveau le plus bas pour le nœud à la position actuelle de l'itérateur

merge – copie la source dans la destination et tous les descendants de la source dans les descendants de la destination.

merge:pc arg, ...

où pc est post condition (facultative) et arg est

destination = source

 set ^a = 10
 set ^a(10) = 100
 set ^a("Bonjour") = 200
 set ^a(10, "Salut") = 300
 set ^a(10, 150) = 80
 set ^b = 25
 set ^b(10) = 248
 set ^b(10, 48) = 963
 
 merge ^a("Bonjour") = ^b(10)
 //copie les nœuds descendants de ^b(10) dans le nœud ^a("Bonjour")

merge = on recoit