Function Entry: VL-FILE-COPY

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: VL-FILE-COPY

Name

vl-file-copy

Class

Visual LISP File Function

Syntax

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

Arguments and Values

  • source-filename: source pathname string
  • destination-filename: destination pathname string
  • append: optional append flag

Description

Copies a file or appends the contents of one file to another.

Return Values

Integer byte count or nil.

Side Effects

Creates or modifies the destination file.

Exceptional Situations

Errors are reported for missing source files, inaccessible destinations, or invalid pathnames.

Availability

  • AutoCAD 2026: documented (per Autodesk reference page).
  • BricsCAD V26: presumed compatible (no contradicting page found).
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Notes

  • Autodesk documents that the function does not overwrite an existing destination file unless append is non-nil.
  • Autodesk documents several nil cases including missing source, directory source, existing destination, invalid output name, or write-protected destination.