CREATE v1.41 - create empty file(s) |
Documentation revised 21 Oct 00 - Copyright (c) 1996-2000 by Rune Berg. TextTools Freeware. |
Contents:
Usage | Top || Next |
create [log logfile] [options] file [...]
See Understanding The Usage Section for details.
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, do not 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/missing command line arguments |
104 | Error opening file |
105 | I/O Error |
107 | File name clash |
109 | File already exists. |
For more details, see TextTools General Features.
Version History | Top || Previous |
These are the released versions of create:
Version | Date | Changes |
---|---|---|
1.01 | 25-Feb-96 | n/a |
1.10 | 26-Sep-96 |
|
1.20 | 26-Sep-96 |
|
1.20 | 13-Apr-97 |
|
1.30 | 13-Jul-97 |
|
1.40 | 2-jan-99 |
|
1.41 | 21-Oct-00 |
|
End of document |