Referenz - NAME

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: NAME (NameAlt, NameNeu)
Typ: Funktion
Kategorie: System

NAME benennt eine Datei um.

'NameAlt' ist ein STRING, der den Namen der Datei enthält, die umbenannt werden soll.
'NameNeu' ist ein STRING, der den neuen Dateinamen enthält, den die Datei erhalten soll.
Der Rückgabewert ist 0, wenn die Datei erfolgreich umbenannt werden konnte, oder -1, wenn ein Fehler aufgetreten ist (z. B. weil die Datei 'NameAlt' nicht existiert oder weil bereits eine Datei namens 'NameNeu' existiert).

FreeBASIC geht davon aus, dass sich die Datei 'NameAlt' im aktuellen Arbeitsverzeichnis befindet (siehe CURDIR). Ist dies nicht der Fall, muss 'NameAlt' eine Pfadangabe enthalten. Diese darf absolut oder relativ sein.
Enthält 'NameNeu' eine andere Pfadangabe als 'NameAlt', so wird die Datei in den bei 'NameNeu' angegeben Ordner verschoben. Das bedeutet auch, dass bei einer Pfadangabe in 'NameAlt' auch 'NameNeu' dieselbe Pfadangabe enthalten muss, wenn die Datei nicht verschoben werden soll.

Beispiel:

' Benenne die Datei "dsc001.jpg" zu "landscape.jpg" um:

NAME "dsc001.jpg", "landscape.jpg"



' Verschiebe die Datei Dialog.bas von C:\BASIC\Projekt\ nach C:\BASIC\Beispiele\

' ohne sie umzubenennen

IF NAME ("C:\BASIC\Projekt\Dialog.bas", "C:\BASIC\Beispiele\Dialog.bas") <> 0 THEN

  PRINT "Fehler: Die Datei konnte nicht verschoben werden."

END IF

SLEEP

Unterschiede zu QB:

In QB lautet die Syntax NAME NameAlt AS NameNeu.
In FreeBASIC kann NAME auch als Funktion verwendet werden.

Da FreeBASIC ein 32bit-Compiler ist, werden auch lange Dateinamen bis zu 255 Zeichen unterstützt.

Plattformbedingte Unterschiede:

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:
KILL, CURDIR, Betriebssystem-Anweisungen

Zusätzliche Informationen und Funktionen

Der Referenzeintrag wurde am 22.07.2007 von Jojo 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.