vl-file-copy (AutoLISP)

Kopiert den Inhalt einer Datei oder hängt ihn an eine andere Datei an.

Unterstützte Plattformen: Windows und macOS

Signatur

(vl-file-copy source-file destination-file [append])

source-file

Typ: Zeichenfolge

Name der zu kopierenden Datei. Wenn Sie keinen vollständigen Pfadnamen angeben, sucht vl-file-copy im AutoCAD-Vorgabeverzeichnis für Zeichnungen.

destination-file

Typ: Zeichenfolge

Name der Zieldatei. Wenn Sie keinen Pfadnamen angeben, schreibt vl-file-copy im AutoCAD-Vorgabeverzeichnis für Zeichnungen.

append

Typ: T oder Null

Wenn angegeben und nicht Null, wird source-file an destination-file angehängt (d. h., an das Ende der Zieldatei kopiert).

Rückgabewerte

Typ: Ganzzahl oder Null

Ein numerischer Wert, wenn der Kopiervorgang erfolgreich war; andernfalls Null.

Einige typische Gründe für die Rückgabe von Null sind:

• source-file kann nicht gelesen werden.
• source-file ist ein Verzeichnis.
• append? fehlt oder Null und destination-file sind vorhanden.
• destination-file kann nicht für die Ausgabe geöffnet werden (d. h., es handelt sich um einen ungültigen Dateinamen oder eine schreibgeschützte Datei).
• source-file entspricht destination-file.

Anmerkungen

Kopieren Sie den Inhalt einer Datei, oder hängen Sie ihn an eine andere Datei an. Die Funktion vl-file-copy überschreibt keine vorhandenen Dateien; es werden nur Daten an diese angehängt.

Versionsinformationen

Versionen:

• AutoCAD R14 and later on Windows
• AutoCAD 2011 and later on Mac OS

Verlauf

AutoCAD 2021

• Für die Argumente source-file und destination-file wurden zuvor ASCII-Zeichenfolgen akzeptiert, nun werden aber Unicode-Textzeichenfolgen akzeptiert.
• Die Systemvariable LISPSYS steuert, welche AutoLISP-Engine verwendet wird und wie sich die Funktion verhält.
  • 0 – ASCII-Zeichenunterstützung (altes Verhalten)
  • 1 oder 2 – Unicode-Zeichenunterstützung
  Anmerkung: Nachdem der Wert der Systemvariablen LISPSYS geändert wurde, muss AutoCAD neu gestartet werden, damit die Änderung wirksam wird.

Beispiele

Windows

Kopieren Sie autoexec.bat in newauto.bat:

(vl-file-copy "c:/autoexec.bat" "c:/newauto.bat")
1417

Kopieren Sie test.bat in newauto.bat:

(vl-file-copy "c:/test.bat" "c:/newauto.bat")
nil

Der Kopiervorgang schlägt fehl, da newauto.bat bereits vorhanden ist und das Argument append nicht angegeben wurde.

Wiederholen Sie den vorherigen Befehl, geben Sie jedoch append an:

(vl-file-copy "c:/test.bat" "c:/newauto.bat" T)
185

Der Kopiervorgang ist erfolgreich, da T für das Argument append angegeben wurde.

Mac OS

Kopieren Sie oldstart.sh in newstart.sh:

(vl-file-copy "/oldstart.sh" "/newstart.sh")
1417

Kopieren Sie start.sh in newstart.sh:

(vl-file-copy "/start.sh" "/newstart.sh")
nil

Der Kopiervorgang schlägt fehl, da newstart.sh bereits vorhanden ist und das Argument append nicht angegeben wurde.

Wiederholen Sie den vorherigen Befehl, geben Sie jedoch append an:

(vl-file-copy "/start.sh" "/newstart.sh" T)
185

Der Kopiervorgang ist erfolgreich, da T für das Argument append angegeben wurde.