ABSINT

Syntaxe

Paramètres

Retour

Description

Cette fonction permet de retourner la valeur absolue du nombre spécifié sous la forme d'un entier sans décimal.

Remarques

• Définition et rôle principal : La fonction absint() est une fonction utilitaire de WordPress convertissant une valeur en un entier absolu (positif). Elle est principalement utilisée pour s'assurer qu'une valeur est bien un entier non négatif, ce qui est utile pour éviter des erreurs lors du traitement de données numériques.
• Équivalent de abs(intval($value)) : Cette fonction est équivalente à :
1. $valeur_propre = abs(intval($valeur));

Elle s'assure que la valeur passée est bien un entier en supprimant les parties décimales et en prenant la valeur absolue. Par exemple, absint(-45.9) renverra 45.

• Exemple d'utilisation courante : Une utilisation typique de absint() est pour traiter des identificateurs (ID) entreposés dans des variables POST ou GET :
1. $post_id = absint($_GET['post_id'] ?? 0);

Cela permet d'éviter les injections et garantit que l'ID est un entier valide.

• Prévention des valeurs négatives : L'un des avantages majeurs de absint() est qu'elle empêche les valeurs négatives d'être utilisées. Si une valeur négative est fournie, elle sera convertie en sa version positive, ce qui est utile pour les indices d'éléments ou les IDs en base de données.
• Gestion des valeurs non numériques : Si une chaîne de caractères ou une valeur non numérique est passée à absint(), elle sera convertie en entier en fonction des règles de intval(). Par exemple :
1. echo absint("123abc"); /* Affiche 123 */
2. echo absint("abc123"); /* Affiche 0 */

Cela permet d'éviter les erreurs, mais peut aussi donner des résultats inattendus.

• Différence avec (int) et intval() : Contrairement à (int) ou intval(), conservant le signe d'un nombre, absint() force toujours un résultat positif. Exemple :
1. echo intval(-10); /* Affiche -10 */
2. echo absint(-10); /* Affiche 10 */

Cela peut être essentiel dans certaines situations où les valeurs négatives doivent être évitées.

• Utilisation pour la validation des options WordPress : Dans le cadre de la gestion des options WordPress, absint() est souvent utilisé pour valider des valeurs entreposées dans la base de données, par exemple :
1. update_option('max_items', absint($_POST['max_items'] ?? 10));

Cela garantit que la valeur stockée est toujours un entier positif, évitant ainsi des erreurs d'affichage ou des comportements inattendus.

Emplacement