Extensions NetScaler - référence de bibliothèque

La liste des bibliothèques prises en charge dans les extensions de politique.

  • 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

   
affirmer (v [, message]) Emet une erreur, avec un message facultatif, lorsque v est faux.
erreur (message) Met fin à une fonction et signale le message d’erreur.
altérations (a) Itérateur pour un tableau a. Renvoie un indice et une valeur pour chaque itération.
paires (t) Itérateur pour une table t. Renvoie une clé et une valeur pour chaque itération.
pour numéroter (e [, base]) Convertit e en nombre, avec une base facultative.
tostring (v) Convertit v en chaîne
type (v) Renvoie 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, msh [, 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

   
chaîne.octet (s [, i [, j]]) Renvoie les valeurs d’octets pour s [i] à s [j]. Par défaut i = 1 et j = i
chaîne.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 (formulaire,…) Renvoie une version formatée des paramètres.
chaîne.gmatch (s, modèle) Itérateur pour rechercher s avec le modèle regex. Renvoie les valeurs correspondantes.
chaîne.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.
chaîne.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
chaîne.reverse (s) Renvoie une chaîne qui est s inversée.
chaîne.sub (s, i [, j]) Renvoie la sous-chaîne de s de s [i] à s [j], j par défaut étant la fin de la chaîne.
chaîne.upper (s) Renvoie une copie de la chaîne convertie en majuscules.
string.dump (fonction) 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%%)
[ensemble] 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 [définir] 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 motif () capturent la position actuelle de la chaîne (un nombre).

Bibliothèque de tables

   
table.concat (liste [, 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 (liste, [pos,] valeur) Insère une valeur dans la liste à l’index pos. La valeur par défaut pour pos est #list (fin de la liste).
pack de tables (…) 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.
sol mathématique (x) Renvoie le plus grand entier <= x.
math.fmod (x, y) Renvoie le reste de x/y en arrondissant le quotient vers zéro.
maths. énorme 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, champ [, largeur]) 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, champ [, largeur]) 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

   
horloge du système d’exploitation () Renvoie une approximation de la quantité en secondes de temps CPU.
os.date ([format [, heure]]) 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.