ReceiveHTTPFile

ReceiveHTTPFile()

Syntax

Ergebnis = ReceiveHTTPFile(URL$, Dateiname$ [, Flags [, UserAgent$]])

Beschreibung

Lädt eine Datei von der angegebenen URL$ auf Disk herunter.

Parameter

URL$ Die URL, von der geladen werden soll.

Dateiname$ Der lokale Dateiname, wohin die Datei geschrieben werden soll. Wenn der Dateiname keinen vollständigen Pfad enthält, wird dieser relativ zum aktuellen Verzeichnis interpretiert. Wenn die Datei existiert, wird sie überschrieben.
Flags (optional)
Dies kann eine Kombination der folgenden Werte sein:
  #PB_HTTP_Asynchronous: startet den Download asynchron.
  #PB_HTTP_NoRedirect  : folgt keinen automatischen Weiterleitungen.
UserAgent$ (optional) Ändert den Benutzeragenten (englisch "User agent") für die HTTP-Anforderung. Der Standardbenutzer-Agent ist gesetzt auf "Mozilla/5.0 Gecko/41.0 Firefox/41.0" für maximale Kompatibilität.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn der Download erfolgreich war, andernfalls Null. Wenn #PB_HTTP_Asynchronous angegeben wurde, dann wird der für HTTPProgress(), AbortHTTP() und FinishHTTP() benötigte 'HttpVerbindung'-Wert zurückgegeben. Bei der Verwendung von #PB_HTTP_Asynchronous muss FinishHTTP() aufgerufen werden, sobald der Download beendet wurde (erfolgreich oder nicht).

Anmerkungen

Auf Linux muss 'libcurl' installiert sein, damit dieser Befehl funktioniert (die meisten Linux-Distributionen haben es bereits standardmäßig installiert).
Wenn die Remote-Datei nicht gefunden wurde, enthält sie den Webserver-Fehler.

Beispiel

  Filename$ = SaveFileRequester("Where to save index.php ?", "", "", 0)

  If ReceiveHTTPFile("https://www.purebasic.com/index.php", Filename$)
    Debug "Datei empfangen und auf Disk geschrieben. Wenn die Remote-Datei nicht gefunden wurde, enthält sie den Webserver-Fehler."
  Else
    Debug "Keine Datei empfangen (Netzwerk-Fehler).
  EndIf

Siehe auch

URLEncoder()

Unterstützte OS

Alle

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

URL$	Die URL, von der geladen werden soll.
Dateiname$	Der lokale Dateiname, wohin die Datei geschrieben werden soll. Wenn der Dateiname keinen vollständigen Pfad enthält, wird dieser relativ zum aktuellen Verzeichnis interpretiert. Wenn die Datei existiert, wird sie überschrieben.
Flags (optional)	Dies kann eine Kombination der folgenden Werte sein: #PB_HTTP_Asynchronous: startet den Download asynchron. #PB_HTTP_NoRedirect : folgt keinen automatischen Weiterleitungen.
UserAgent$ (optional)	Ändert den Benutzeragenten (englisch "User agent") für die HTTP-Anforderung. Der Standardbenutzer-Agent ist gesetzt auf "Mozilla/5.0 Gecko/41.0 Firefox/41.0" für maximale Kompatibilität.