# (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)