ReceiveHTTPFile()
Syntaxe
Resultat = ReceiveHTTPFile(URL$, NomFichier$ [, Options [, AgentUtilisateur$]])Description
Télécharge un fichier sur le disque à partir d'une URL.
Arguments
URL$ L'URL de téléchargement. NomFichier$ Le nom du fichier qui sera enregistré sur le disque.
Si le nom de fichier ne contient pas de chemin complet, il sera enregistré dans le répertoire courant.
Si le fichier existe, il sera écrasé.Options (optionnel) Peut être une combinaison des valeurs suivantes: #PB_HTTP_Asynchronous: Démarre le téléchargement asynchrone. #PB_HTTP_NoRedirect : Ne pas suivre les redirections automatiques.AgentUtilisateur$ (optionnel) Change l'agent utilisateur (UserAgent) pour la requête HTTP.
L'agent utilisateur par défaut est défini sur "Mozilla / 5.0 Gecko / 41.0 Firefox / 41.0" pour une compatibilité maximale.
Valeur de retour
Renvoie une valeur non nulle en cas de succès, zéro sinon.
Si #PB_HTTP_Asynchronous a été spécifié, la fonction renvoie la valeur 'ConnexionHttp' nécessaire pour HTTPProgress(), AbortHTTP() et FinishHTTP().
Si #PB_HTTP_Asynchronous est utilisé alors FinishHTTP() doit être appelé, que le téléchargement ait été effectué avec succès ou non.
Remarques
Sous Linux, 'libcurl' doit être installé pour que cette commande fonctionne (déjà installé dans la plupart des distributions Linux).
Si le fichier distant n'a pas été trouvé, le fichier créé contiendra l'erreur du serveur Web.
Exemple
NomDeFichier$ = SaveFileRequester("Enregistrer index.php ?", "", "", 0) If ReceiveHTTPFile("https://www.purebasic.com/index.php", NomDeFichier$) Debug "Fichier reçu et écrit sur le disque. Si le fichier distant n'a pas été trouvé, il contiendra l'erreur du serveur Web." Else Debug "Aucun fichier reçu (erreur réseau)." EndIf
Voir aussi
URLEncoder()
OS Supportés
Tous