YggDID.mesa
Copyright Ó 1988 by Xerox Corporation. All rights reserved.
Bob Hagmann May 9, 1988 4:25:42 pm PDT
Definition of the document identifier (DID)
DIRECTORY
Basics USING [Comparison],
IO USING [STREAM],
Rope USING [ROPE];
YggDID: CEDAR DEFINITIONS
~ BEGIN
Types
DID: TYPE ~ REF DIDRep;
DIDRep: TYPE;
document identifier (DID)
FirstDID: DID;
LastDID: DID;
Roots
RootPath: Rope.ROPE;
RootPathToRoots: Rope.ROPE;
Procedures
StreamsForDID: PROC [did: DID] RETURNS [contents, attributes, links: IO.STREAM];
Get streams for the DID. Any or all of these objects may be NIL. For objects with few links, the links are stored in the attributes. For objects with small contents, the contents are stored in the attributes. If there are no attributes, there is no file for them.
ValidateDID: PROC [did: DID] RETURNS [ok: BOOL];
Compare the did and stableDID.
CompareDIDs: PROC [did: DID, stableDID: LONG POINTER] RETURNS [Basics.Comparison];
Compare the did and stableDID.
EqualDIDs: PROC [did1: DID, did2: DID] RETURNS [equal: BOOL];
Compare the did and stableDID.
SizeForDID: PROC [did: DID] RETURNS [bytes: INT];
Return the size of the did. The size in in bytes rounded up to the next word.
StabilizeDID: PROC [did: DID, buffer: LONG POINTER];
Take a DID and write it to a buffer.
VolatilizeDID: PROC [buffer: LONG POINTER] RETURNS [did: DID];
Take a buffer and construct a DID.
END.