PutGet.mesa
written by Bill Paxton, May 1981
last edit by Paxton. October 21, 1982 1:55 pm
Russ Atkinson, July 22, 1983 10:24 am
DIRECTORY
FS,
Rope,
RopeEdit,
IO,
TextNode;
PutGet: CEDAR DEFINITIONS = BEGIN
Ref: TYPE = TextNode.Ref;
ROPE: TYPE = Rope.ROPE;
Offset: TYPE = TextNode.Offset;
MaxLen: Offset = LAST[Offset];
-- **** File Input/Output
ToFile: PROC [fileName: ROPE, node: Ref, start: Offset ← 0, flatten, textOnly: BOOLFALSE]
RETURNS [dataLen, count: Offset];
ToFileC: PROC [file: FS.OpenFile, node: Ref,
start: Offset ← 0, flatten, textOnly: BOOLFALSE]
RETURNS [dataLen, count: Offset];
-- write the node on the specified file
-- starts writing at given address in file
-- returns dataLen = number of data bytes at start of file,
-- and count = the total number of bytes written
FromFile: PROC [fileName: ROPE, start: Offset ← 0, len: Offset ← MaxLen] RETURNS [Ref];
FromFileC: PROC [file: FS.OpenFile, start: Offset ← 0, len: Offset ← MaxLen] RETURNS [Ref];
-- create node from the contents of a file
-- starts reading at given start address in file
-- pretends that start+len is the end of the file
-- if file was not created by ToFile (i.e., password not correct)
-- then returns a single node containing contents of the file
FromFileError: ERROR;
WriteMesaFilePlain: PROC [fileName: ROPE, root: Ref];
This is like WriteFilePlain, but adds initial dashes to comments if necessary.
WriteFilePlain: PROC [fileName: ROPE, root: Ref];
WriteFileCPlain: PROC [file: FS.OpenFile, root: Ref];
-- gives text of file with CR after each node and TABs before according to nesting
-- **** Input/Output using ropes instead of files
ToRope: PROC [node: Ref, flatten, textOnly: BOOLFALSE]
RETURNS [dataLen, count: Offset, output: ROPE];
-- resulting rope contains same representation of node as would be put on file
FromRope: PROC [rope: ROPE, start: Offset ← 0, len: Offset ← MaxLen] RETURNS [Ref];
-- reads rope to construct node
WriteRopePlain: PROC [root: Ref] RETURNS [output: ROPE];
-- **** IO Operations ****
ToStream: PROC [stream: IO.STREAM, node: Ref, flatten, textOnly: BOOLFALSE]
RETURNS [dataLen, count: Offset];
-- does a series of IO.PutBlock's
-- returns number of bytes written
FromStream: PROC [stream: IO.STREAM, len: Offset ← MaxLen] RETURNS [Ref];
-- reads up to len chars from stream (via GetBlock's) to construct a node
END.