Extensions NetScaler - 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’expressions régulières - Classes de caractères
- Modèles d’expressions régulières - Éléments du modèle
- Bibliothèque de tables
- Bibliothèque de mathématiques
- Bibliothèque Bitwise
- Bibliothèque du système d’exploitation
- Bibliothèque NetScaler
Bibliothèque de base
assert(v[,message]) | Emet une erreur, avec un message facultatif, lorsque v est faux. |
error(message) | Met fin à une fonction et signale le message d’erreur. |
ipairs(a) | Iterateur pour un tableau a. Renvoie un indice et une valeur pour chaque itération. |
pairs(t) | Itérateur 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 chaîne |
type(v) | Retourne le type de v : nombre, chaîne, booléen, table, etc. |
getmetatable (objet) | Renvoie la valeur nil si l’objet ne possède pas de métable. Sinon, si la métatable de l’objet comporte un champ « __metatable », renvoie la valeur associée. Dans le cas contraire, renvoie la métatable de l’objet donné. |
setmetatable (table, metatable) | Définit la métatable pour la table donnée. (Vous ne pouvez pas modifier la métatable d’autres types à partir de Lua, uniquement à partir de C.) Si la valeur métatable est nulle, supprime la métatable de la table donnée. Si la métatable d’origine comporte un champ « __metatable », génère une erreur. |
sélectionner (index, ···) | Renvoie tous les arguments après l’indice 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, 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]]) | Renvoie les valeurs d’octets pour s [i] à s [j]. Par défaut i = 1 et j = i |
string.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. Renvoie le premier et le dernier index de match ou nul. init est l’index de départ, par défaut 1. plain = true signifie que le pattern n’est pas une regex. |
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]) | Renvoie la sous-chaîne de s de s[i] à s[j], la valeur 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’expressions régulières - classes de caractères
x | le caractère x, sauf pour les caractères magiques ^$()%.[]*+-?) |
. | n’importe quel personnage |
%a | n’importe quelle lettre |
%c | n’importe quel caractère de contrôle |
%d | n’importe quel chiffre |
%g | n’importe quel caractère imprimable à l’exception de l’espace |
%l | n’importe quelle lettre minuscule |
%p | n’importe quel caractère de ponctuation |
%s | n’importe quel caractère d’espace blanc |
%u | n’importe quelle lettre majuscule |
%w | n’importe quelle lettre alphanumérique |
%x | un personnage magique x échappé (par exemple%%) |
[set] | un ensemble de caractères : séquence de caractères individuels, plages x-y et classes % |
[^set] | personnages ne figurant pas dans le set. |
Modèles d’expression régulière - éléments du modèle
X | une classe de caractères |
X* | 0 ou plusieurs répétitions les plus longues de caractères dans X |
X+ | 1 ou plusieurs répétitions de caractères en X |
X- | 0 ou plusieurs répétitions les plus courtes de caractères dans X |
X ? | 0 ou 1 caractère en 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 () fait correspondre la sous-chaîne entre deux parenthèses équilibrées. |
%f[set] | 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 matrice est une séquence d’éléments de la matrice. ^pattern correspond au début d’une chaîne et pattern$ correspond à la fin de la chaîne.
Les sous-chaînes correspondantes peuvent être capturées à l’aide de (pattern). 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]]) | Renvoie la liste [i] à la liste [j]. La valeur par défaut pour i est 1 et j est #list <c/ode>. |
Bibliothèque de mathématiques
Diverses fonctions trigonométriques et logarithmiques ne sont pas représentées.
math.abs(x) | Renvoie la valeur absolue de x. |
math.ceil(x) | Renvoie le plus petit entier >= x. |
math.floor(x) | Renvoie le plus grand entier <= x. |
math.fmod (x, y) | Renvoie le reste de x/y en arrondissant le quotient vers zéro. |
math.huge | Une valeur >= n’importe quel autre nombre. |
math.max(x,…) | Renvoie l’argument maximum. |
math.min(x,…) | Renvoie l’argument minimum. |
math.modf(x) | Renvoie les parties intégrales et fractionnaires de x. |
math.random() | Renvoie un nombre pseudo-aléatoire compris entre 0 et 1. |
math.random(m) | Renvoie un entier pseudo-aléatoire compris entre 1 et m. |
math.random(m, n) | Renvoie un entier pseudo-aléatoire compris entre m et n. |
math.randomseed(x) | Définit x pour le générateur de nombres pseudo-aléatoires. |
math.sqrt(x) | Renvoie la racine carrée de x (x^0,5) |
math.acos(x) | Renvoie l’arc-cosinus de x (en radians). |
math.asin(x) | Renvoie l’arc-sinus de x (en radians). |
math.atan(x) | Renvoie l’arc-tangent de x (en radians). |
math.atan2 (y, x) | Renvoie l’arc-tangent 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) | Renvoie le sinus de x. |
math.sinh(x) | Renvoie le sinus hyperbolique de x. |
math.tan(x) | Renvoie la tangente de x. |
math.tanh(x) | Renvoie la tangente hyperbolique de x. |
math.deg(x) | Renvoie l’angle x (exprimé en radians) en degrés. |
math.exp(x) | Renvoie la valeur e^x. |
math.frexp (x) | Renvoie m et e tels que x = m2e, e est un entier et la valeur absolue de m se situe 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 base est e. |
math.pow (x, y) | Renvoie x^y. |
math.rad (x) | Renvoie l’angle x (exprimé en degrés) en radians. |
math.pi | La valeur de π. |
Bibliothèque Bitwise
Sauf indication contraire :
- Toutes les fonctions acceptent des arguments numériques dans la plage (-2^51, +2^51).
- Chaque argument est normalisé par rapport 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 se situe dans la plage [0,2^32 - 1].
- Tous les résultats se situent dans la plage [0,2^32 - 1].
bit32.arshift(x,disp) | Renvoie x bits de disp décalés arithmétiquement vers la droite (+disp) ou vers la gauche (-disp). |
bit32.band (…) | Renvoie la valeur bit par bit des arguments. |
bit32.bnot(x) | Renvoie la négation bit par bit de x. |
bit32.bor (…) | Renvoie la valeur bit par bit ou des arguments. |
bit32.btest(…) | Renvoie la valeur true si le nombre de bits par bit des arguments n’est pas nul. |
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 les bits d’un champ à l’autre, plus la largeur -1 est remplacée par v. La largeur par défaut est 1. |
bit32.lrotate(x,disp) | Renvoie x bits de disp pivotés vers la gauche (+disp) ou vers la droite (-disp). |
bit32.lshift(x,disp) | Renvoie x bits de disp décalés vers la gauche (+disp) ou vers la droite (-disp). |
bit32.rrotate(x,disp) | Renvoie x bits de disp pivotés vers la droite (+disp) ou vers la gauche (-disp). |
bit32.rshift(x,disp) | Renvoie 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 ([table]) | 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 l’instant t1 et l’instant t2. |
Bibliothèque NetScaler
ns.logger:level(message) | Pour enregistrer les messages dont le niveau est « urgence », « alerte », « critique », « erreur », « avertissement », « notice », « information » ou « débogage ». Les paramètres sont les mêmes que ceux de 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. |