<< Inhaltsverzeichnis Suchen >>

FTP_GETFILEINFO$

Funktion

Syntax:

FTP_GETFILEINFO$(<HOST>,<USERNAME>,<PASSWORT>,
                                      <PFAD>,<DATEIEN>,<TRENNZEICHEN>,
                                     <DATEITYP>,<INFOTYP>,<SUBDIR>)

<HOST>                            = <STRING-AUSDRUCK>

<USERNAME>                 = <STRING-AUSDRUCK>

<PASSWORT>                 = <STRING-AUSDRUCK>
<PFAD>                             = <STRING-AUSDRUCK>
<DATEIEN>                      = <STRING-AUSDRUCK>
<TRENNZEICHEN>        = <STRING-AUSDRUCK>
<DATEITYP>                    = <NUM-AUSDRUCK>
<INFOTYP>                      = <NUM-AUSDRUCK>
<SUBDIR>                        = <NUM-AUSDRUCK>

 

Bedeutung:

FTP_GETFILEINFO$ liefert Informationen über den Pfad, die Länge und das Änderungsdatum von Dateien auf einem Internetserver.

 

<HOST> bezeichnet den Internetserver, von dem die Informationen geholt werden sollen.

 

<USERNAME> und <PASSWORT> legen Username und Passwort fest für den Zugriff auf den Server <HOST> fest.

 

<PFAD> gibt an, in welchem Verzeichnis die <DATEIEN> gesucht werden sollen. ACHTUNG: Bei FTP-Servern ist "/" das Trennzeichen für Verzeichnisse !

 

Ist <SUBDIR> <> 0, so werden auch alle Unterverzeichnisse von <PFAD> durchsucht.<DATEIEN> enthält einen Dateinamen, in dem auch Wildcards ("*", "?") zulässig sind (z.B. *.bat, winword.exe).

 

Das erste Zeichen von <TRENNZEICHEN> legt fest, durch welches Zeichen die Ergebnisnamen in der Ergebniszeichenkette getrennt werden. Ist <TRENNZEICHEN> der Leerstring "", so gilt der Strichpunkt ";" als Trennzeichen.

 

 

<DATEITYP> legt fest, nach welchen Dateien gesucht werden soll:

 

Wert von <DATEITYP>
1
2
sonst

Gesucht werden
nur Dateien, keine Verzeichnisnamen
nur Verzeichnisnamen, keine Dateien
Dateien und Verzeichnisnamen

 

<INFOTYP> legt fest, welche Information als Ergebnis geliefert werden soll:

 

Wert von <INFOTYP>
1
2

sonst

Geliefertes Ergebnis
Dateinamen mit vollständiger Pfadangabe
Dateiname und Dateilänge getrennt durch <TRENNZEICHEN>
Dateiname, Dateilänge und Datum und Uhrzeit der letzten Änderung getrennt durch <TRENNZEICHEN>
ACHTUNG: Unter Java wird  weder Datum noch Urzeit geliefert, da dies derzeit von Java nicht unterstützt wird.

 

FTP_GETFILEINFO$ liefert als Ergebnis alle gefundenen Datei- und Verzeichnisnamen (evtl. mit Dateilänge und Änderungsdatum/-uhrzeit) mit vollständigem Pfad. Die einzelnen Ergebniswerte sind in der Ergebniszeichenkette durch <TRENNZEICHEN> getrennt. Werden keine Dateien gefunden, so liefert GET_FILEINFO$ als Ergebnis den Leerstring "".

Tritt ein Fehler auf, so liefert FTP_GETFILEINFO$ als Ergebnis den Leerstring "" und ERRORTEXT$ enthält die Fehlermeldung.

 

Beispiel:

HOST$ = "www.xxx.de"
USERNAME$ = "user1"

PASSWORT$ = "passwort1"

H$ = FTP_GETFILEINFO$(HOST$,USERNAME$,PASSWORT$,
                                                "/","*.zip",";",1,1,1)
/* H$ enthält durch ";" getrennt alle zip-Dateien aus dem
/* Home-Verzeichnis und allen Unterverzeichnissen des
/* Internetservers.

siehe auch:

GET_FILEINFO$, FTP_GETFILE, FTP_PUTFILE, FTP_DELETEFILE