Module tools_utils

Les types sont donnés à titre indicatif puisque Awk type les variables dynamiquement.

La notation module.fonc() signifie que la fonction fonc() se trouve dans un fichier module.awk.

Le code du module est disponible ici.

tools_utils.FALSE = 1

Valeur symbolique pour le faux.

tools_utils.NIL = '\x04'

Valeur spéciale rare pour distinguer de la chaîne vide "".

tools_utils.TRUE = 0

Valeur symbolique pour le vrai.

tools_utils.tdef(t: dict, seq: str)

Définit un dictionnaire dont les clés sont des indices associés aux valeurs énumérées dans une séquence.

Paramètres
  • t – le dictionnaire à définir

  • seq – une chaine de la forme "val1|val2|...|valN"

Renvoie

le nombre d’indices créés dans t

tools_utils.tdef2(t1: dict, t2: dict, seq: str)

Définit deux dictionnaires duaux dont les associations, décrites dans une séquence, seront respectivement indice -> valeur et valeur -> indice.

Paramètres
  • t1 – le dictionnaire dont les clés seront des indices

  • t2 – le dictionnaire dual dont les clés seront les valeurs

  • seq – une chaine de la forme "val1|val2|...|valN"

Renvoie

le nombre d’indices créés dans t1

tools_utils.tdel(t: dict, key: str)

Supprime une clé dans un dictionnaire.

Paramètres
  • t – le dictionnaire concerné

  • key – la clé à supprimer

tools_utils.tget(t: dict, key: str, nil: str) str

Renvoie la valeur associée à une clé dans un dictionnaire.

Paramètres
  • t – le dictionnaire concerné

  • key – la clé demandée

  • nil – optionnel, la valeur à retourner si la clé n’existe pas, NIL par défaut

Renvoie

la valeur de t[key] si key existe dans t sinon nil

tools_utils.tprint(t: dict, key: str)

Affiche toutes les associations clé -> valeur d’un dictionnaire.

Paramètres

t – le dictionnaire concerné

tools_utils.tset(t: dict, key: str)

Assigne une valeur à une clé dans un dictionnaire.

Paramètres
  • t – le dictionnaire concerné

  • key – la clé concernée

  • val – la valeur associée à la clé concernée