Return to image.2 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / icon / man / man2

Annotation of 43BSD/contrib/icon/man/man2/image.2, revision 1.1.1.1

1.1       root        1: .so tmac.ilib
                      2: .TH IMAGE 2 "The University of Arizona \- 6/28/83"
                      3: .SH NAME
                      4: Image \- generalized string image of Icon value
                      5: .SH SYNOPSIS
                      6: .nf
                      7: \*MImage(x)\fR
                      8: \*MImagex(x)\fR
                      9: .fi
                     10: .SH DESCRIPTION
                     11: The procedure \*MImage(x)\fR produces a string
                     12: image of the value \*Mx\fR. The value produced is a generalization of
                     13: the value produced by the Icon function \*Mimage(x)\fR, providing detailed
                     14: information about structures.
                     15: .PP
                     16: Tags are used to uniquely identify
                     17: structures. A tag consists of a letter identifying the type followed
                     18: by an integer. The tag letters are \*ML\fR for lists, \*MR\fR for
                     19: records, and \*MT\fR for tables. The first time a structure is encountered,
                     20: it is imaged as the tag followed by a colon, followed by a representation
                     21: of the structure. If the same structure is encountered again, only the
                     22: tag is given.
                     23: .PP
                     24: An example is
                     25: .DS
                     26: a := \^["x"]
                     27: push(a,\*ba)
                     28: t := table()
                     29: push(a,\*bt)
                     30: t\^[a] := t
                     31: t\^["x"] := \^[]
                     32: t\^[t] := a
                     33: write(Image(t))
                     34: .DE
                     35: which produces
                     36: .DS
                     37: T1:\^["x"\->L1:\^[],\*bL2:\^[T1,\*bL2,\*b"x"]\->T1,\*bT1\->L2]
                     38: .DE
                     39: Note that a table is represented as a list of entry and assigned
                     40: values separated by \*M\->\fRs.
                     41: .LP
                     42: The procedure \*MImagex(x)\fR is similar to \*MImage(x)\fR, except that
                     43: newlines and spaces are inserted to that the printed result is
                     44: displayed on multiple lines with indentation. There are other formatting
                     45: details that differ between the two procedures.
                     46: For the example given above, the result of
                     47: .DS
                     48: write(Imagex(t))
                     49: .DE
                     50: is
                     51: .DS
                     52: T1:{
                     53:    "x"
                     54:    \-\-\-
                     55: L1:[]
                     56:    ]
                     57: \-\-\-\-\-\-
                     58: L2:[
                     59:    T1
                     60:    L2
                     61:    "x"
                     62:    ]
                     63: \-\-\-
                     64: T1
                     65: \-\-\-\-\-\-
                     66: T1
                     67: \-\-\-
                     68: L2
                     69: \-\-\-\-\-\-
                     70: ]
                     71: .DE
                     72: .SH AUTHOR
                     73: Ralph E. Griswold

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.