| CREATE v1.40 - create empty file(s) |
| Revised 2-Jan-99. Copyright (c) 1996-99 by Rune Berg. TextTools Freeware. |
Usage | Description | Example | Options | Return Codes | Version History | tt_r6
| Usage | Top | Next |
create [log logfile] [options] file [...]
| Description | Top | Previous | Next |
create creates empty file(s), as named by the file argument(s).
For each file created, create prints the following message:
create: file created
If file already exists, create will print an error message and exit (but see -o and -w options).
If file can not be created, create will print an error message and exit.
If you don't specify logfile, create writes error messages to standard error.
| Example | Top | Previous | Next |
For example (if files "xyz.txt" and "data.tst" do not already exist), the command:
create xyz.txt data.tst
creates two files, "xyz.txt" and "data.tst", both empty, and prints these messages to standard error (or logfile, if given):
create: xyz.txt created
create: data.tst created
| Options | Top | Previous | Next |
create recognizes the following command line options:
| Option | Function |
|---|---|
| -o | Overwrite (truncate to length 0) a file that already exists, then continue. |
| -w | Warn if file already exists, don't create it, continue. (This is an alternative to the -o option.) |
| -q | Quiet mode, suppress creation reports and warnings. (Does not affect return codes.) |
| -n | Write a carriage-return and newline char. to each created file. |
| -z | Write a DOS end-of-file char. (hex 1a) to each created file. |
| -v | Print version banner and usage info to standard error (or logfile, if given), then exit. |
| Return Codes | Top | Previous | Next |
create returns with one of the following codes ("error levels"):
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Skipped creating existing file (warning, see -w option) |
| 102 | Incorrect command line arguments |
| 104 | Error opening file |
| 105 | I/O error |
| 107 | File name clash |
| 109 | File already exists |
| Version History | Top | Previous |
These are the released versions:
| Version | Date | Changes |
|---|---|---|
| 1.01 | 25-Feb-96 | n/a |
| 1.10 | 26-Sep-96 | * New options: -w -q |
| 1.20 | 26-Sep-96 | * New options: -n -z |
| 1.20 | 13-Apr-97 | * Available as Win32 version. |
| 1.30 | 13-Jul-97 | * Now gives proper return codes. |
| 1.40 | 2-jan-99 | * Win32 version now gives coloured response texts. |
| End of document |