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

<- HTTPTimeout() - Http Index - ReceiveHTTPMemory() ->