URLEncode (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Fonctions de gestion des chaînes

Caractères admissibles dans une URL encodée

Constantes de cryptage/compression

Constantes de gestion des chaînes de caractères

Constantes de sérialisation

EntierSystèmeVersEntier

EntierVersHexa

ExtraitChaîne

ExtraitLigne

Fonctions de gestion des chaînes de caractères

Gauche

Gestion de l'Unicode dans les chaînes de caractères

Manipuler les chaînes de caractères

NumériqueVersEcritureFinancièreChinoise

VérifieExpressionRégulière

Caractères admissibles dans une URL encodée
Cas particuliers

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

URLEncode (Fonction)

En anglais : URLEncode

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.

Versions 15 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 15

Cette fonction est désormais disponible pour les applications Android.

Versions 16 et supérieures

Cette fonction est désormais disponible pour les applications Windows Phone.

Nouveauté 16

Cette fonction est désormais disponible pour les applications Windows Phone.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Versions 22 et supérieures

Cette fonction est désormais disponible en code navigateur.

Nouveauté 22

Cette fonction est désormais disponible en code navigateur.

Exemple

// 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

Versions 22 et supérieures

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)

Nouveauté 22

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)

Versions 22 et supérieures

// Encodage d'une URL avec un paramètre de type URL
Info(EncodeURL("https://www.google.fr/?", encodeURLDepuisAnsi) + ...
EncodeURL(EncodeURL("https://www.google.fr/?é", encodeURLDepuisAnsi), encodeURLParamètre))

Nouveauté 22

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 (avec guillemets)

URL à encoder (au format ANSI). URL à encoder.

<Format d'encodage> : Constante optionnelle de type Entier

Versions 22 et supérieures
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, encodeURLDepuisUnicode ou encodeURLDepuisUTF8.

Ce paramètre n'est pas disponible.
Nouveauté 22
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, encodeURLDepuisUnicode ou encodeURLDepuisUTF8.

Ce paramètre n'est pas disponible.
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, encodeURLDepuisUnicode ou encodeURLDepuisUTF8.

Ce paramètre n'est pas disponible.

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.

Cas particuliers

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).

Composantes