ReceiveHTTPMemory()

Syntax

*Puffer = ReceiveHTTPMemory(URL$ [, Flags [, UserAgent$]])

Lädt eine Datei von der angegebenen URL in einen neuen Speicherpuffer.

Parameter

URL$	Die URL, von der der Download erfolgen soll.
Flags (optional)	Dies kann eine Kombination der folgenden Werte sein: #PB_HTTP_Asynchronous: startet den Download asynchron. Um die Adresse des Speicherpuffers zu erhalten, verwenden Sie FinishHTTP(). #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 die Adresse des neuen Speicherpuffers zurück, wenn der Download erfolgreich war, andernfalls Null. MemorySize() kann verwendet werden, um die Größe des Downloads zu ermitteln. Der Speicherpuffer muss mittels FreeMemory() freigegeben werden, sobald dessen Nutzung abgeschlossen ist. Wenn #PB_HTTP_Asynchronous angegeben wurde, dann wird der für HTTPProgress(), AbortHTTP() und FinishHTTP() benötigte 'HttpVerbindung'-Wert zurückgegeben.

Anmerkungen

InitNetwork() muss aufgerufen werden, bevor dieser Befehl benutzt werden kann.

Auf Linux muss 'libcurl' installiert sein, damit dieser Befehl funktioniert (die meisten Linux-Distributionen haben es bereits standardmäßig installiert).

Beispiel

  InitNetwork()

  *Buffer = ReceiveHTTPMemory("http://www.purebasic.com/index.php")
  If *Buffer
    Size = MemorySize(*Buffer)
    Debug "Content: " + PeekS(*Buffer, Size, #PB_UTF8|#PB_ByteLength)
    FreeMemory(*Buffer)
  Else
    Debug "Failed"
  EndIf

Siehe auch

GetHTTPHeader(), URLEncoder()

Unterstützte OS

Alle