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 |