Bezeichnung
easy:SetOpt_SeekFunction -- legt den Benutzer-Callback zum Suchen im Eingabedatenstrom fest
Übersicht
easy:SetOpt_SeekFunction(seek_callback[, userdata])
Beschreibung
Übergeben Sie eine Callback-Funktion. Diese Funktion wird von libcurl aufgerufen, um nach einer bestimmten Position im Eingabedatenstrom zu suchen und kann verwendet werden, um eine Datei in einem erneuten Upload vorwärtszuspulen (anstatt alle hochgeladenen Bytes mit der normalen Lesefunktion/Callback zu lesen). Sie wird auch aufgerufen, um einen Datenstrom zurückzuspulen, wenn bereits Daten an den Server gesendet wurden und erneut gesendet werden müssen. Dies kann passieren, wenn ein HTTP-PUT oder -POST mit einer Authentifizierungsmethode mit mehreren Durchläufen ausgeführt wird oder wenn eine vorhandene HTTP-Verbindung zu spät wiederverwendet wird und der Server die Verbindung schließt.

Die Funktion empfängt zwei Argumente: Das erste Argument gibt den zu suchenden Versatz an, das zweite Argument den Ursprung des im ersten Argument übergebenen Versatzes. Dies wird eine der folgenden speziellen Zeichenketten sein:

set
Der Versatz ist relativ zum Anfang.
cur
Der Versatz ist relativ zur aktuellen Position.
end
Der Versatz ist relativ zum Ende.

Wenn Sie das optionale Argument userdata übergeben, wird der in userdata übergebene Wert als dritter Parameter an Ihre Callback-Funktion übergeben. Der Parameter userdata kann einen beliebigen Typ haben.

Die Callback-Funktion muss bei Erfolg #CURL_SEEKFUNC_OK (oder nichts) zurückgeben, #CURL_SEEKFUNC_FAIL, damit der Upload-Vorgang fehlschlägt, oder #CURL_SEEKFUNC_CANTSEEK, um anzuzeigen, dass libcurl das Problem nach Möglichkeit umgeht. Letzteres kann manchmal durch Lesen von der Eingabe oder ähnlichem erfolgen.

Eingaben
seek_callback
Eingabewert
userdata
optional: Benutzerdaten, die an die Callback-Funktion übergeben werden sollen

Navigation zeigen