# (open filename mode) [GstarCAD 2012](../../../Index.md) → [Developer Reference](../../%28Developer%20Reference%29.md) → [AutoLISP Reference](../%28AutoLISP%20Reference%29.md) → [LISP Functions](%28LISP%20Functions%29.md) <a id="237"></a> ## (open filename mode) --- Open that file. --- This function makes a file's *filename* accessible for input and output functions. The *filename* argument represents the path and filename of the file to open. The **open** function returns a file descriptor (an 8-digit hexadecimal number) for the opened file, which should be stored as a variable using the [setq](%28setq%20symbol1%20statement1%20-symbol2%20statement2-%20...%29.md) function. Once you have the file descriptor, you must refer to the file using the file descriptor-not the filename! The *mode* argument has three options, which must be in lowercase: | Mode | Meaning | | --- | --- | | "r" | Open the file as read-only; returns nil if the file does not exist. | | "w" | Open the file for writing; overwrites existing data; creates a new file if non-existent. | | "a" | Open the file for writing; append to existing data; creates a new file if non-existent. | ### Examples | Code | Returns | | --- | --- | | (setq n (**open** "existing.txt" "w")) | \<File: #2190dec2\> | | (setq n (**open** "noexist.lsp" "r")) | nil | | (setq n (**open** "\\\\sample\\\\exiting.txt" "a") | \<File: #2190c2c3\> | ### NOTES - In append mode, new data is added to the end of the existing file. - LISP only reads ASCII files (no binary files) using sequential access (no random access). - To separate subdirectory names, you use either two backslashes ( \\\\ ) or a single forward slash ( / ). **Tell me about...** [(close file-descriptor)](%28close%20file-descriptor%29.md) [(read-line \[file-descriptor\])](%28read-line%20-file-descriptor-%29.md) [(write-line string \[file-descriptor\])](%28write-line%20string%20-file-descriptor-%29.md) [LISP Compatibility](../LISP%20Compatibility.md) [Programming Overview of LISP (LISt Processing) Language](../Programming%20Overview%20of%20LISP%20%28LISt%20Processing%29%20Language.md) <a id="holding"></a> ## Other versions with matching text [GstarCAD 2011](../../../../2011/Developer%20Reference/AutoLISP%20Reference/LISP%20Functions/%28open%20filename%20mode%29.md)