Cette fonction permet d'encoder la valeur d'un paramètre d'une URL (échappement des caractères spéciaux et des espaces).
Cette fonction échappe tous les caractères sauf les lettres de l'alphabet latin, les chiffres et les caractères suivants : - _ . ! ~ * ' ( ).
Domaine d'application
Client Java.
Client Web.
Client Cloud.
Serveur Java.
Paramètres
ALPHA(n) |
Paramètre |
Valeur du paramètre de l'URL |
ALPHA(n) |
Encodage |
Encodage de l'URL. Si *BLANK, assume UTF-8. Pour l'utilisation avec Adélia Cloud et la fonction VaToolBxOpenURL, utilisez l'encodage par défaut, soit UTF-8. |
ALPHA(n) |
ParamètreEnc |
Paramètre encodé. |
ALPHA(n) |
LgValeur |
Longueur de la variable Parametre. |
NUM_BIN_4 |
CodeRetour |
Code retour de l'opération : 0 : si l'opération s'est déroulée correctement. -1 : en cas d'erreur d'encodage. -2 : si la variable fournie est trop petite pour stocker le résultat. |
Exemple
Parametre |
= '<Karine Béranger> Karine.Beranger@gmail.com' |
Enc |
= 'UTF-8' |
* résultat : %3CKarine%20B%C3%A9ranger%3E%20Karine.Beranger%40gmail.com
APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxJavaEncodeURLComponent' Parametre Enc ParametreEnc 256 CodeRetour
URL = 'http://mondomain.com/app?action=checkMail&mail=' /// ParametreEnc
