Return to muxstring.9 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man9

Annotation of researchv10dc/man/adm/man9/muxstring.9, revision 1.1

1.1     ! root        1: .TH MUXSTRING 9.3
        !             2: .CT 2 comm_term
        !             3: .SH NAME
        !             4: strinsure, strinsert, strdelete, strzero, setmuxbuf, getmuxbuf, movstring \- dynamic strings in mux
        !             5: .SH SYNOPSIS
        !             6: .B #include <jerq.h>
        !             7: .PP
        !             8: .B strinsure(s, n);  String *s;
        !             9: .PP
        !            10: .B "strinsert(d, i, s); String *d, *s;
        !            11: .PP
        !            12: .B "strdelete(d, i, j); String *d;
        !            13: .PP
        !            14: .B strzero(d); String *d;
        !            15: .PP
        !            16: .B setmuxbuf(s); String *s;
        !            17: .PP
        !            18: .B getmuxbuf(d); String *d;
        !            19: .PP
        !            20: .B movstring(n, sp, dp); char *sp, *dp;
        !            21: .SH DESCRIPTION
        !            22: These functions manipulate strings represented
        !            23: in the following form.
        !            24: .IP
        !            25: .EX
        !            26: .ta \w'struct 'u
        !            27: struct String {
        !            28:        char *s;
        !            29:        short n;
        !            30:        short size;
        !            31: };
        !            32: .EE
        !            33: .LP
        !            34: The string proper occupies the first 
        !            35: .B n
        !            36: characters of a data block of
        !            37: .L size
        !            38: characters pointed to by
        !            39: .BR s .
        !            40: Initially both
        !            41: .B size
        !            42: and
        !            43: .B s
        !            44: should be 0.
        !            45: Strings are always counted, not terminated by
        !            46: .BR \e0 .
        !            47: The functions obtain space as needed from
        !            48: .IR gcalloc  ;
        !            49: see
        !            50: .IR alloc (9.3).
        !            51: Thus a
        !            52: .B String
        !            53: structure should never be copied.
        !            54: .PP
        !            55: .I Strinsure
        !            56: arranges that 
        !            57: .IB s ->size\(>= n.
        !            58: It must be called before any operation that could
        !            59: overflow the current size.
        !            60: .PP
        !            61: .I Strinsert
        !            62: inserts a copy of source
        !            63: .I s
        !            64: into destination
        !            65: .I d
        !            66: beginning at character 
        !            67: .I i
        !            68: (counted from 0),
        !            69: adding
        !            70: .IB s ->n
        !            71: to
        !            72: .IB d ->n .
        !            73: .PP
        !            74: .I Strdelete
        !            75: removes characters
        !            76: .I i
        !            77: through
        !            78: .IR j \-1
        !            79: from string
        !            80: .I d,
        !            81: subtracting
        !            82: .IR j \- i,
        !            83: which must be nonnegative, from
        !            84: .IB d ->n .
        !            85: .PP
        !            86: .IB Strzero
        !            87: frees the memory associated with
        !            88: .I d
        !            89: and sets both
        !            90: .IB d ->n
        !            91: and
        !            92: .IB d ->size
        !            93: to zero.
        !            94: .PP
        !            95: .I Setmuxbuf
        !            96: copies string 
        !            97: .I s
        !            98: into the snarf buffer maintained by
        !            99: .IR mux (9.1);
        !           100: .I getmuxbuf
        !           101: copies from the snarf buffer into
        !           102: .I d.
        !           103: .PP
        !           104: .I Movstr
        !           105: copies a block of
        !           106: .I n
        !           107: characters beginning at
        !           108: .I sp
        !           109: to a block beginning at
        !           110: .I dp.
        !           111: If
        !           112: .I n
        !           113: is negative it copies
        !           114: .RI \- n
        !           115: characters ending at
        !           116: .IR sp \- 1
        !           117: to a block ending at
        !           118: .IR dp \-1.
        !           119: Notice that
        !           120: .I movstring 
        !           121: does not operate on
        !           122: .BR String s.
        !           123: .SH SEE ALSO
        !           124: .IR libc (9.3)

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