prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » http$head()

http$head()

Den Kopf einer Seite gemäß des HTTP-Protokolls (Methode HEAD) laden.

Syntax:

list http$head ( url )
list http$head ( url, referer )
list http$head ( url, referer, command_header )

Parameter:

url Der Parameter wird mittels string() zwangsweise in eine Zeichenkette gewandelt. Dieses Zeichenkette solle den URL (Web-Adresse) der Seite, die geladen werden soll, enahlten.
referer Der Parameter wird mittels string() zwangsweise in eine Zeichenkette gewandelt. Enthält diese Zeichenkette mindestens ein Zeichen, dann wird sie im Anfrage-Kopf (Header) als 'Referer:' übermittelt. Ohne Zeichen oder ohne Verwendung wird kein 'Referer:' übermittelt.
command_header Der Parameter wird mittels string() zwangsweise in eine Zeichenkette gewandelt. Dieses Zeichenkette wird 1:1 in den Anfrage-Kopf (Header) kopiert.

Beschreibung:

Der Kopf der Seite unter der Adresse url wird gemäß des HTTP-Protokolls geladen. Der Anfrage-Kopf (Header) wird wie folgt in der genannten Reihenfolge aufgebaut:

Wurde mittels http$setProxy() ein Proxy-Server angegeben, dann wird für das Laden der Seite der Proxy-Server angesprochen. Anderenfalls wird der Ziel-Server direkt angesprochen.

Funktionsergebnis:   LIST

Als Funktionsergebnis wird eine Liste mit _HTTP__LENGTH Elementen geliefert. Die einzelnen Elemente der Liste werden über die Konstanten der folgenden Tabellen angesprochen, wobei die Werte nur als Orientierung dienen und in Zukunft geändert werden können.

Index Wert Beschreibung
_HTTP__LENGTH 8 Dieses Konstante gibt die Anzahl der Elemente der Rückgabeliste der Funktionen http$get(), http$head() und http$post() an. Auf die einzelnen Elemente kann mit den folgenden Konstanten zugegriffen werden. Diese folgenden Konstanten sind alle aus dem Intervall [0 .. _HTTP__LENGTH[.
_HTTP_CALL_STATUS 0 Das Element mit dem Index _HTTP_CALL_STATUS ist eine 32-Bit Ganzzahl. Der Wert ist der eigentliche Status der Operation. Bei einem Wert <0 wurde der Befehl nicht ausgeführt. Einem Wert >=0 gibt die Anzahl der Zeichen im Body-Bereich an; im Falle von http$head() die Anzahl der potentiellen Zeichen.
_HTTP_VALID 1 Das Element mit dem Index _HTTP_VALID ist eine 32-Bit Ganzzahl. Sie ist 1, wenn die folgenden Daten gültig sind. Anderenfalls ist sie 0.
_HTTP_MAJOR_VERSION 2 Das Element mit dem Index _HTTP_MAJOR_VERSION ist eine 32-Bit Ganzzahl, die die Major-ID des HTTP-Servers enthält. Diese Major-ID wurde aus Statusmeldung des HTTP-Servers extrahiert.
_HTTP_MINOR_VERSION 3 Das Element mit dem Index _HTTP_MINOR_VERSION ist eine 32-Bit Ganzzahl, die die Minor-ID des HTTP-Servers enthält. Diese Minor-ID wurde aus Statusmeldung des HTTP-Servers extrahiert.
_HTTP_STATUS_NUM 4 Das Element mit dem Index _HTTP_STATUS_NUM ist eine 32-Bit Ganzzahl, die den Status enthält. Dieser Fehlerstatus wurde aus Statusmeldung des HTTP-Servers extrahiert.
_HTTP_STATUS_TEXT 5 Das Element mit dem Index _HTTP_STATUS_TEXT ist eine Zeichenkette, die den Fehlerstatus ohne Nummer als Klartext angibt. Dieser Fehlerstatus wurde aus Statusmeldung des HTTP-Servers extrahiert.
_HTTP_HEADER 6 Das Element mit dem Index _HTTP_HEADER ist eine Map. Diese Map enthält alle Parameter des Kopfes, der vom HTTP-Server erzeugt wurde. Der jeweilige Parametername wurde als Schlüssel verwendet, unter dem der Wert des Parameters als Zeichenkette abgelegt wurde.
_HTTP_DATA 7 Das Element mit dem Index _HTTP_DATA ist eine Zeichenkette, die die zurückgelieferten Daten enthält. Im Falle von http$head() enthält die Zeichenkette nie Zeichen.

Siehe auch:
 http$get()   http$post()   http$setUserAgent()   http$setProxy() 

Weitere ähnliche Funktionen:

HTTP Unterstützung
Funktion Kurzinfo
http$get() Eine Seite gemäß des HTTP-Protokolls (Methode GET) laden.
http$getProxy() Den eingestellten HTTP-Proxy ermitteln.
http$getUserAgent() Den eingestellten User-Agent ermitteln.
http$head() Den Kopf einer Seite gemäß des HTTP-Protokolls (Methode HEAD) laden.
http$post() Eine Seite gemäß des HTTP-Protokolls (Methode POST) laden.
http$setProxy() Einen HTTP-Proxy benennen.
http$setUserAgent() Einen User-Agent benennen.