Encode une URL avec uniquement un sous-ensemble de caractères ASCII. Cette fonction permet de remplacer les caractères interdits dans une URL (accents, espaces, ...). Une URL encodée peut être décodée grâce à la fonction
URLDécode.
Remarque : La validité syntaxique de l'URL n'est pas vérifiée.
// Encode une URL
URLEncodée = URLEncode("http://mon site/ma page")
// URLEncodée contient maintenant http://mon%20site/ma%20page
// Les deux espaces ont été transformés en %20
MonURL est une chaîne UNICODE = "http://mon site/ma page"
MonURLEncodée est une chaîne
// Encode une URL
MonURLEncodée = URLEncode(MonURL, encodeURLDepuisUnicode)
// Encodage d'une URL avec un paramètre de type URL
Info(URLEncode("https://www.google.fr/?", encodeURLDepuisAnsi) + ...
URLEncode(URLEncode("https://www.google.fr/?é", encodeURLDepuisAnsi), encodeURLParamètre))
Syntaxe
<Résultat> = URLEncode(<URL> [, <Format d'encodage>])
<Résultat> : Chaîne de caractères
Chaîne de caractères contenant l'URL encodée. Les caractères non acceptables sont transformés en %xx où xx est la valeur hexadécimale de ce caractère.Cette fonction ne retourne pas de code d'erreur car toutes les chaînes de caractères peuvent être encodées.
<URL> : Chaîne de caractères
URL à encoder (au format ANSI).
<Format d'encodage> : Constante optionnelle de type Entier
Format d'encodage de l'URL : | |
encodeURLDepuisAnsi | Format URL. Le texte encodé comporte uniquement des caractères autorisés dans une URL. Le texte à encoder est une chaîne ANSI. |
encodeURLDepuisUTF8 (Valeur par défaut) | Format URL. Le texte encodé comporte uniquement des caractères autorisés dans une URL. Le texte à encoder est une chaîne UTF-8. |
encodeURLParamètre | Format URL. Les caractères réservés d'une URL sont encodés pour pouvoir passer une URL en paramètre d'une URL. Attention : Il faut auparavant avoir encodé l'URL passée en paramètre avec une des constantes encodeURLDepuisAnsi ou encodeURLDepuisUTF8. |
Remarques
Caractères admissibles dans une URL encodée
La liste des caractères admissibles dans une URL encodée est la suivante :
| | | | |
; | / | ? | : | @ |
& | = | + | $ | , |
- | _ | . | ! | ~ |
* | ' | ( | | | ) |
% | # | les chiffres | les lettres (majuscules et minuscules) | |
Selon les options, certains de ces caractères pourront être encodés par la fonction.
- L'encodage d'une URL vide (chaîne vide) est une URL vide.
- Cas particulier : le signe % et le signe +
- Le signe % étant utilisé pour l'encodage décimal, ce caractère est lui-même encodé en décimal.
- Le signe "+" qui est une alternative à %20 pour encoder un espace est lui-même encodé (pour éviter un mauvais décodage).
Composante : wd280std.dll