Extensions Citrix ADC - Référence de bibliothèque

Liste des bibliothèques prises en charge dans les extensions de stratégie.

  • Bibliothèque de base
  • Bibliothèque de chaînes
  • Modèles d’expression régulière - Classes de caractères
  • Modèles d’expression régulière - Éléments de motif
  • Bibliothèque de tables
  • Bibliothèque mathématique
  • Bibliothèque binaire
  • Bibliothèque du système d’exploitation
  • Bibliothèque Citrix ADC

Bibliothèque de base

   
assert(v[,message]) Emet une erreur, avec un message facultatif, lorsque v est faux.
error(message) Termine une fonction et signale le message d’erreur.
ipairs(a) Iterateur pour un tableau a. Renvoie un index et une valeur pour chaque itération.
pairs(t) Iterateur pour une table t. Renvoie une clé et une valeur pour chaque itération.
tonumber(e[,base]) Convertit e en nombre, avec une base facultative.
tostring(v) Convertit v en une chaîne
type(v) Retourne le type de v : nombre, chaîne, booléen, table, etc.
getmetatable (objet) Renvoie nil si l’objet n’a pas de métatable. Sinon, si la métatable de l’objet a un champ « __metatable », renvoie la valeur associée. Sinon, retourne le métatable de l’objet donné.
setmetatable (table, metatable) Définit la métatable de la table donnée. (Vous ne pouvez pas modifier la métatable d’autres types de Lua, seulement de C.) Si metatable est nul, supprime le metatable de la table donnée. Si le métatable d’origine a un champ « __metatable », déclenche une erreur.
select (index, ···) Retourne tous les arguments après l’index du numéro d’argument. Si index est chaîne “#”, alors il retourne le nombre total d’arguments supplémentaires qu’il a reçus.
pcall (f [, arg1, ···]) Appelle la fonction f avec les arguments donnés en mode protégé. Il renvoie le code d’état comme premier résultat qui indique si l’appel a réussi ou non. Si l’appel a réussi, puis avec le code d’état, il renvoie également tous les résultats de l’appel, sinon renvoie un message d’erreur.
xpcall (f, msgh [, arg1, ···]) Cette fonction est similaire à pcall, sauf qu’elle prend également un argument pour la gestion des erreurs.
_VERSION Renvoie la version actuelle de l’interpréteur.

Bibliothèque de chaînes

   
string.byte(s[,i[,j]]) Retourne les valeurs d’octets pour s[i] à s[j]. Par défaut i = 1 et j = i
ching.char (…) Renvoie une chaîne construite à partir des paramètres entiers.
string.find(s,pattern[,init[,plain]) Recherche la première correspondance d’un motif d’expression régulière dans s. Retourne le premier et le dernier index de match ou nil. init is index to start, default 1. plain = true signifie que le modèle n’est pas une expression régulière.
string.format(form,…) Renvoie une version formatée des paramètres.
string.gmatch(s,pattern) Iterateur pour la recherche s avec le modèle regex. Renvoie les valeurs correspondantes.
string.gsub(s,pattern,repl[,n]) Renvoie une copie de s dans laquelle toutes (ou n) occurrences du modèle ont été remplacées par repl.
string.len(s) Renvoie la longueur de la chaîne.
string.lower(s) Renvoie une copie de la chaîne convertie en minuscules.
string.match(s,pattern[,init]) Recherche la première correspondance du motif regex dans s et renvoie les captures ou le motif entier. init est l’index à démarrer, par défaut 1.
string.rep(s,n[,sep]) Retourne une chaîne qui est n copies de s, avec le séparateur sep, par défaut aucun séparateur
string.reverse(s) Renvoie une chaîne qui est s inversée.
string.sub(s,i[,j]) Retourne la sous-chaîne de s de s[i] à s[j], par défaut j est la fin de la chaîne.
string.upper(s) Renvoie une copie de la chaîne convertie en majuscules.
string.dump (function) Renvoie une chaîne contenant une représentation binaire de la fonction donnée.

Modèles d’expression régulière - classes de caractères

   
x le caractère x, sauf pour les caractères magiques ^$()%.[]*+-?)
. n’importe quel caractère
%a toute lettre
%c tout caractère de contrôle
%d n’importe quel chiffre
%g tout caractère imprimable à l’exception de l’espace
%l toute lettre minuscule
%p tout caractère de ponctuation
%s tout caractère d’espace blanc
%u toute lettre majuscule
%w toute lettre alphanumérique
%x un caractère magique échappé x (par exemple%%)
[ensemble] un ensemble de caractères : séquence de caractères individuels, plages x-y et% classes
[^set] caractères ne figurant pas dans l’ensemble.

Motifs d’expression régulière - éléments de motif

   
X une classe de caractères
X* 0 ou plus de répétitions de caractères les plus longues dans X
X+ 1 ou plusieurs répétitions de caractères dans X
X- 0 ou plusieurs répétitions les plus courtes de caractères dans X
X? 0 ou 1 caractère dans X
%n n=1 à 9 ; correspond à la nième chaîne capturée
%bxy correspond à une sous-chaîne entre deux caractères équilibrés x et y. L’exemple %b() correspond à une sous-chaîne entre deux parenthèses équilibrées.
%f[ensemble] correspond à une chaîne vide à n’importe quelle position de telle sorte que le caractère suivant appartient à set et que le caractère précédent n’appartient pas à set.

Une répétition est une séquence d’éléments de répétition. ^pattern correspond au début d’une chaîne et pattern$ correspond à la fin de la chaîne.

Les sous-chaînes appariées peuvent être capturées à l’aide de (motif). Les parenthèses sans pattern () capturent la position actuelle de la chaîne (un nombre).

Bibliothèque de tables

   
table.concat(list[,sep[,i[,j]]]) Renvoie une liste de chaînes[i] .. sep.. list[i+1] .. sep… list[j]. Par défaut, sep est la chaîne vide. Par défaut i est 1, j est #list.
table.insert(list,[pos,]value) Insère une valeur dans la liste à l’index pos. La valeur par défaut pour pos est #list (fin de la liste).
table.pack (…) Retourne un tableau contenant les paramètres commençant à l’index 1, et une clé n avec le nombre total de paramètres.
table.remove(list[,pos]) Supprime de la liste l’élément à la position pos, déplaçant les éléments pour remplir la position. Renvoie l’élément supprimé. Par défaut pour posis #list (fin de la liste.)
table.sort(list[,comp]) Trier les éléments de la liste en place. comp est la fonction de comparaison à utiliser. La valeur par défaut pour comp est <.
table.unpack(list[,i[,j]]) Retourne la liste[i] à travers la liste[j] . La valeur par défaut pour i est 1 et j est #list <c/ode>.

Bibliothèque mathématique

Diverses fonctions trigonométriques et logarithmiques ne sont pas montrées.

   
math.abs(x) Renvoie la valeur absolue de x.
math.ceil(x) Retourne le plus petit entier >= x.
math.floor(x) Retourne le plus grand nombre entier <= x.
math.fmod(x,y) Renvoie le reste de x/y arrondissant le quotient vers zéro.
math.énorme Une valeur >= tout autre nombre.
math.max(x,…) Renvoie l’argument maximum.
math.min(x,…) Renvoie l’argument minimum.
math.modf(x) Retourne les parties intégrales et fractionnelles de x.
math.random() Renvoie un nombre pseudo-aléatoire compris entre 0 et 1.
math.random(m) Retourne un entier pseudo-aléatoire compris entre 1 et m.
math.random(m, n) Retourne un entier pseudo-aléatoire entre m et n.
math.randomseed(x) Définit le générateur de nombres pseudo-aléatoires défini sur x.
math.sqrt(x) Retourne la racine carrée de x (x^0.5)
math.acos(x) Renvoie l’arc cosinus de x (en radians).
math.asin(x) Renvoie le sinus arc de x (en radians).
math.atan(x) Renvoie la tangente de l’arc de x (en radians).
math.atan2(y, x) Renvoie la tangente d’arc de y/x (en radians).
math.cos(x) Renvoie le cosinus de x.
math.cosh(x) Renvoie le cosinus hyperbolique de x.
math.sin(x) Retourne le sinus de x.
math.sinh(x) Retourne le sinus hyperbolique de x.
math.tan(x) Retourne la tangente de x.
math.tanh(x) Renvoie la tangente hyperbolique de x.
math.deg(x) Renvoie l’angle x (donné en radians) en degrés.
math.exp(x) Renvoie la valeur e^x.
math.frexp (x) Renvoie m et e de telle sorte que x = m2e, e est un entier et la valeur absolue de m est dans la plage [0.5, 1).
math.ldexp (m, e) Retourne m2e (e devrait être un entier).
math.log (x [, base]) Renvoie le logarithme de x dans la base donnée. La valeur par défaut pour la base est e.
math.pow (x, y) Renvoie x^y.
math.rad (x) Renvoie l’angle x (donné en degrés) en radians.
math.pi La valeur de π.

Bibliothèque binaire

Sauf indication contraire :

  • Toutes les fonctions acceptent des arguments numériques dans la plage (-2^51, +2^51).
  • Chaque argument est normalisé au reste de sa division par 2^32 et tronqué en un entier (d’une manière non spécifiée), de sorte que sa valeur finale tombe dans la plage [0,2^32 - 1].
  • Tous les résultats sont dans la plage[0,2^32 - 1].
   
bit32.arshift(x,disp) Retourne x bits de disp décalés arithmétiquement vers la droite (+disp) ou la gauche (-disp).
bit32.band (…) Renvoie le bit et les arguments.
bit32.bnot(x) Retourne la négation binaire de x.
bit32.bor (…) Renvoie le bit ou des arguments.
bit32.btest(…) Renvoie true si le bit et les arguments ne sont pas nuls.
bit32.bxor (…) Renvoie le bit exclusif ou des arguments.
bit32.extract(n,field[,width]) Retourne les bits en n du champ au champ + largeur - 1 (nombre de bits du plus au moins significatif). La valeur par défaut pour la largeur est 1.
bit32.replace(n,v,field[,width]) Renvoie une copie de n avec des bits du champ au champ + largeur -1 remplacée par v. La largeur par défaut est 1.
bit32.lrotate(x,disp) Retourne x bits de disp pivotés vers la gauche (+disp) ou vers la droite (-disp).
bit32.lshift(x,disp) Retourne x bits de disp décalés vers la gauche (+disp) ou vers la droite (-disp).
bit32.rrotate(x,disp) Retourne x bits de disp pivotés vers la droite (+disp) ou vers la gauche (-disp).
bit32.rshift(x,disp) Retourne x bits de disp décalés vers la droite (+disp) ou vers la gauche (-disp).

Bibliothèque du système d’exploitation

   
os.clock () Renvoie une approximation de la quantité en secondes de temps CPU.
os.date ([format [, time]]) Renvoie une chaîne ou un tableau contenant la date et l’heure, formaté selon le format de chaîne donné.
os.time ([tableau]) Renvoie l’heure actuelle lorsqu’elle est appelée sans arguments, ou une heure représentant la date et l’heure spécifiées par la table donnée.
os.difftime (t2, t1) Renvoie le nombre de secondes entre le temps t1 et le temps t2.

Bibliothèque Citrix ADC

   
ns.logger:level(message) Pour consigner les messages dont le niveau est d’urgence, alerte, critique, erreur, avertissement, notification, informations ou débogage. Les paramètres sont les mêmes que la fonction C printf() : une chaîne de format et un nombre variable d’arguments pour fournir des valeurs pour les spécificateurs % dans la chaîne de format.