Referenz - KILL

Referenz-Navigation

FreeBASIC-Referenz (anklicken z. Aufklappen)
- Über diese Referenz
- Alphabetische Befehlsreferenz
  - A
    - ABS
    - ABSTRACT
    - ACCESS
    - ACOS
    - ADD
    - ALIAS
    - ALLOCATE
    - ALPHA
    - AND (Methode)
    - AND (Operator)
    - ANDALSO
    - ANY
    - APPEND
    - AS
    - ASC
    - ASIN
    - ASM
    - ASSERT
    - ASSERT (Meta)
    - ASSERTWARN
    - ATAN2
    - ATN
    - THREADDETACH
  - B
    - BASE
    - BASE (Vererbung)
    - BEEP
    - BIN
    - BINARY
    - BIT
    - BITRESET
    - BITSET
    - BLOAD
    - BOOLEAN
    - BSAVE
    - BYREF
    - BYREF (Rückgaben)
    - BYTE
    - BYVAL (Klausel)
    - BYVAL (Rückgaben)
    - BYVAL (Schlüsselwort)
  - C
    - CALL
    - CALLOCATE
    - CASE
    - CAST
    - CBOOL
    - CBYTE
    - CDBL
    - CDECL
    - CHAIN
    - CHDIR
    - CHR
    - CINT
    - CIRCLE
    - CLASS
    - CLEAR
    - CLNG
    - CLNGINT
    - CLOSE
    - CLS
    - COLOR (Anweisung)
    - COLOR (Funktion)
    - COM
    - COMMAND
    - COMMON
    - CONDBROADCAST
    - CONDCREATE
    - CONDDESTROY
    - CONDSIGNAL
    - CONDWAIT
    - CONS
    - CONST
    - CONST (Klausel)
    - CONSTRUCTOR (Klassen)
    - CONSTRUCTOR (Module)
    - CONTINUE
    - COS
    - CPTR
    - CSHORT
    - CSIGN
    - CSNG
    - CSRLIN
    - CUBYTE
    - CUINT
    - CULNG
    - CULNGINT
    - CUNSG
    - CURDIR
    - CUSHORT
    - CUSTOM
    - CVA_ARG
    - CVA_COPY
    - CVA_END
    - CVA_START
    - CVD
    - CVI
    - CVL
    - CVLONGINT
    - CVS
    - CVSHORT
  - D
    - DATA
    - DATE
    - DATEADD
    - DATEDIFF
    - DATEPART
    - DATESERIAL
    - DATEVALUE
    - DAY
    - DEALLOCATE
    - DECLARE
    - DEFBYTE
    - DEFDBL
    - DEFINE (Meta)
    - DEFINED
    - DEFINT
    - DEFLNG
    - DEFLONGINT
    - DEFSHORT
    - DEFSNG
    - DEFSTR
    - DEFUBYTE
    - DEFUINT
    - DEFULONGINT
    - DEFUSHORT
    - DEFxxx
    - DELETE
    - DESTRUCTOR (Klassen)
    - DESTRUCTOR (Module)
    - DIM
    - DIR
    - DO ... LOOP
    - DOUBLE
    - DRAW (Grafik)
    - DRAW STRING
    - DYLIBFREE
    - DYLIBLOAD
    - DYLIBSYMBOL
    - DYNAMIC (Meta)
    - DYNAMIC (Schlüsselwort)
  - E
    - ELSE
    - ELSEIF
    - ENCODING
    - END
    - ENDIF
    - ENDMACRO (Meta)
    - ENUM
    - ENVIRON
    - EOF
    - EQV
    - ERASE
    - ERFN
    - ERL
    - ERMN
    - ERR (Anweisung)
    - ERR (Funktion)
    - ERROR (Anweisung)
    - ERROR (Meta)
    - ESCAPE
    - EXEC
    - EXEPATH
    - EXIT
    - EXP
    - EXPLICIT
    - EXPORT
    - EXTENDS
    - EXTERN (Module)
    - EXTERN ... END EXTERN
  - F
    - FALSE
    - FIELD
    - FILEATTR
    - FILECOPY
    - FILEDATETIME
    - FILEEXISTS
    - FILELEN
    - FIX
    - FLIP
    - FOR
    - FOR ... NEXT
    - FORMAT
    - FRAC
    - FRE
    - FREEFILE
    - FUNCTION
  - G
    - GET (Datei)
    - GET (Grafik)
    - GETJOYSTICK
    - GETKEY
    - GETMOUSE
    - GOSUB
    - GOSUB (Schlüsselwort)
    - GOTO
  - H
    - HEX
    - HIBYTE
    - HIWORD
    - HOUR
  - I
    - IF (Meta)
    - IF ... THEN
    - IFDEF (Meta)
    - IFNDEF (Meta)
    - IIF
    - IMAGECONVERTROW
    - IMAGECREATE
    - IMAGEDESTROY
    - IMAGEINFO
    - IMP
    - IMPLEMENTS
    - IMPORT
    - INCLIB (Meta)
    - INCLUDE (Meta)
    - INKEY
    - INP
    - INPUT (Anweisung)
    - INPUT (Datei)
    - INPUT (Dateimodus)
    - INPUT (Funktion)
    - INSTR
    - INSTRREV
    - INT
    - INTEGER
    - IS
    - IS (Vererbung)
    - ISDATE
    - ISREDIRECTED
  - K
    - KILL
  - L
    - LANG (Meta)
    - LBOUND
    - LCASE
    - LEFT
    - LEN
    - LET
    - LIB
    - LIBPATH (Meta)
    - LINE (Grafik)
    - LINE (Meta)
    - LINE INPUT
    - LINE INPUT (Datei)
    - LOBYTE
    - LOC
    - LOCAL
    - LOCATE (Anweisung)
    - LOCATE (Funktion)
    - LOCK
    - LOF
    - LOG
    - LONG
    - LONGINT
    - LOOP
    - LOWORD
    - LPOS
    - LPRINT (Anweisung)
    - LPRINT USING
    - LPT
    - LSET
    - LTRIM
  - M
    - MACRO (Meta)
    - MID (Anweisung)
    - MID (Funktion)
    - MINUTE
    - MKD
    - MKDIR
    - MKI
    - MKL
    - MKLONGINT
    - MKS
    - MKSHORT
    - MOD
    - MONTH
    - MONTHNAME
    - MULTIKEY
    - MUTEXCREATE
    - MUTEXDESTROY
    - MUTEXLOCK
    - MUTEXUNLOCK
  - N
    - NAKED
    - NAME
    - NAMESPACE
    - NEW
    - NEXT
    - NOGOSUB (Schlüsselwort)
    - NOKEYWORD
    - NOT
    - NOW
  - O
    - OBJECT
    - OCT
    - OFFSETOF
    - ON ... GOSUB
    - ON ... GOTO
    - ON ERROR
    - ONCE
    - OPEN (Anweisung)
    - OPEN (Funktion)
    - OPEN COM
    - OPEN CONS
    - OPEN ERR
    - OPEN LPT
    - OPEN PIPE
    - OPEN SCRN
    - OPERATOR
    - OPTION
    - Option()
    - OR (Methode)
    - OR (Operator)
    - ORELSE
    - OUT
    - OUTPUT
    - OVERLOAD
    - OVERRIDE
  - P
    - PAINT
    - PALETTE
    - PALETTE GET
    - PASCAL
    - PCOPY
    - PEEK
    - PIPE
    - PMAP
    - POINT
    - POINTCOORD
    - POINTER
    - POKE
    - POS
    - PRAGMA (Meta)
    - PRESERVE
    - PRESET (Grafik)
    - PRESET (Methode)
    - PRINT (Anweisung)
    - PRINT (Datei)
    - PRINT (Meta)
    - PRINT USING
    - PRIVATE (Klausel)
    - PRIVATE (Schlüsselwort)
    - PRIVATE (UDT)
    - PROCPTR
    - PROPERTY
    - PROTECTED
    - PSET (Grafik)
    - PSET (Methode)
    - PTR
    - PUBLIC (Klausel)
    - PUBLIC (UDT)
    - PUT (Datei)
    - PUT (Grafik)
  - R
    - RANDOM
    - RANDOMIZE
    - READ
    - REALLOCATE
    - REDIM
    - REM
    - RESET
    - RESTORE
    - RESUME
    - RETURN
    - RGB
    - RGBA
    - RIGHT
    - RMDIR
    - RND
    - RSET
    - RTRIM
    - RUN
  - S
    - SADD
    - SCOPE
    - SCREEN (Anweisung)
    - SCREEN (Funktion)
    - SCREENCONTROL
    - SCREENCOPY
    - SCREENEVENT
    - SCREENGLPROC
    - SCREENINFO
    - SCREENLIST
    - SCREENLOCK
    - SCREENPTR
    - SCREENRES
    - SCREENSET
    - SCREENSYNC
    - SCREENUNLOCK
    - SCRN
    - SECOND
    - SEEK (Anweisung)
    - SEEK (Funktion)
    - SELECT CASE
    - SETDATE
    - SETENVIRON
    - SETMOUSE
    - SETTIME
    - SGN
    - SHARED
    - SHELL
    - SHL
    - SHORT
    - SHR
    - SIN
    - SINGLE
    - SIZEOF
    - SLEEP
    - SPACE
    - SPC
    - SQR
    - STATIC (Anweisung)
    - STATIC (Klausel)
    - STATIC (Meta)
    - STATIC (Schlüsselwort)
    - STATIC (UDT)
    - STDCALL
    - STEP
    - STICK
    - STOP
    - STR
    - STRIG
    - STRING (Datentyp)
    - STRING (Funktion)
    - STRPTR
    - SUB
    - SWAP
    - SYSTEM
  - T
    - TAB
    - TAN
    - THEN
    - THIS
    - THREADCALL
    - THREADCREATE
    - THREADDETACH
    - THREADWAIT
    - TIME
    - TIMER
    - TIMESERIAL
    - TIMEVALUE
    - TO
    - TRANS
    - TRIM
    - TRUE
    - TYPE (Forward Referencing)
    - TYPE (Funktion)
    - TYPE (UDT)
    - TYPEOF
  - U
    - UBOUND
    - UBYTE
    - UCASE
    - UINTEGER
    - ULONG
    - ULONGINT
    - UNDEF (Metabefehl)
    - UNION
    - UNLOCK
    - UNSIGNED
    - UNTIL
    - USHORT
    - USING (Namespace)
  - V
    - VAL
    - VAL64
    - VALINT
    - VALLNG
    - VALUINT
    - VALULNG
    - VAR
    - VARPTR
    - VA_ARG
    - VA_FIRST
    - VA_NEXT
    - VIEW (Grafik)
    - VIEW (Text)
    - VIRTUAL
  - W
    - WAIT
    - WBIN
    - WCHR
    - WEEKDAY
    - WEEKDAYNAME
    - WEND
    - WHEX
    - WHILE
    - WHILE ... WEND
    - WIDTH (Anweisung)
    - WIDTH (Funktion)
    - WINDOW
    - WINDOWTITLE
    - WINPUT
    - WITH
    - WOCT
    - WRITE (Anweisung)
    - WRITE (Datei)
    - WSPACE
    - WSTR
    - WSTRING (Datentyp)
    - WSTRING (Funktion)
  - X
    - XOR (Methode)
    - XOR (Operator)
  - Y
    - YEAR
  - Z
    - ZSTRING
  - Metabefehle
    - __DATE_ISO__
    - __DATE__
    - __FB_64BIT__
    - __FB_ARGC__
    - __FB_ARGV__
    - __FB_BACKEND__
    - __FB_BIGENDIAN__
    - __FB_BUILD_DATE__
    - __FB_CYGWIN__
    - __FB_DARWIN__
    - __FB_DEBUG__
    - __FB_DOS__
    - __FB_ERR__
    - __FB_FPMODE__
    - __FB_FPU__
    - __FB_FREEBSD__
    - __FB_GCC__
    - __FB_LANG__
    - __FB_LINUX__
    - __FB_MAIN__
    - __FB_MIN_VERSION__
    - __FB_MT__
    - __FB_NETBSD__
    - __FB_OPENBSD__
    - __FB_OPTION_BYVAL__
    - __FB_OPTION_DYNAMIC__
    - __FB_OPTION_ESCAPE__
    - __FB_OPTION_EXPLICIT__
    - __FB_OPTION_GOSUB__
    - __FB_OPTION_PRIVATE__
    - __FB_OUT_DLL__
    - __FB_OUT_EXE__
    - __FB_OUT_LIB__
    - __FB_OUT_OBJ__
    - __FB_PCOS__
    - __FB_SIGNATURE__
    - __FB_SSE__
    - __FB_UNIX__
    - __FB_VECTORIZE__
    - __FB_VERSION__
    - __FB_VER_MAJOR__
    - __FB_VER_MINOR__
    - __FB_VER_PATCH__
    - __FB_WIN32__
    - __FB_XBOX__
    - __FILE_NQ__
    - __FILE__
    - __FUNCTION_NQ__
    - __FUNCTION__
    - __LINE__
    - __PATH__
    - __TIME__
- BASIC-Grundlagen
- Operatoren in FreeBASIC
- Prozeduren in FreeBASIC
- Die Gfxlib
- Verschiedene Themen
- FreeBASIC thematische Übersicht
Alle Ordner öffnen
Alle Ordner schließen

Syntax: KILL (Dateiname)
Typ: Funktion
Kategorie: System

KILL löscht eine Datei von einem Datenträger.

'Dateiname' ist ein STRING, der den Namen einer Datei enthält, die gelöscht werden soll. Er muss ihre Erweiterung enthalten und kann mit einer Pfadangabe versehen sein. Wird kein Arbeitspfad angegeben, so sucht KILL die Datei im aktuellen Arbeitsverzeichnis; siehe CURDIR. Die Verwendung von Wildcards ist nicht möglich (siehe DIR zu Wildcards).
Der Rückgabewert der Funktion ist entweder 0, wenn der Löschvorgang erfolgreich abgeschlossen wurde, oder die Fehlernummer 2, wenn die Datei nicht existiert, bzw. 3, wenn die Datei nicht gelöscht werden kann.

Der Rückgabewert kann verworfen werden; KILL wird dann wie eine Anweisung eingesetzt.

Beispiel:

SELECT CASE KILL("file.ext")

  CASE 0 : PRINT "Die Datei wurde gelöscht."

  CASE 2 : PRINT "Fehler: Die Datei existiert nicht!"

  CASE 3 : PRINT "Fehler: Unzureichende Zugriffsrechte, oder es handelt sich um einen Ordner!"

END SELECT

SLEEP

Achtung: Die zu löschende Datei wird nicht in den Papierkorb verschoben; sie wird unwiederbringlich gelöscht!

Unterschiede zu QB:
KILL kann in FreeBASIC auch als Funktion eingesetzt werden.

Plattformbedingte Unterschiede:

Auf manchen Plattformen kann KILL möglicherweise Ordner und schreibgeschützte Dateien löschen. Ob dies möglich ist oder nicht, ist zur Zeit nicht festgelegt. Überprüfen Sie ggf. zuvor die Attribute der Datei und entscheiden Sie dementsprechend, ob Sie die Datei löschen wollen.
Unter Linux muss der Dateiname 'case sensitive' erfolgen. Windows und DOS sind 'case insensitive'.
Das Trennzeichen für den Dateipfad ist unter Linux der vorwärtsgerichtete Slash /. Windows verwendet den Backslash \, erlaubt aber auch den Slash. DOS verwendet den Backslash.

Siehe auch:
MKDIR, RMDIR, CHDIR, CURDIR, SHELL, Betriebssystem-Anweisungen

Zusätzliche Informationen und Funktionen

Der Referenzeintrag wurde am 30.07.2007 von nemored angelegt.
Die aktuellste Version wurde am 27.12.2012 von nemored gespeichert.

Versionen

Um die Aufklappnavigation links benutzen zu können, müssen Sie JavaScript aktivieren. Ohne JavaScript können Sie die Referenzeinträge nur über die Liste aller Einträge erreichen.