Return to ch11c.t CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / X / doc / Xlib

Annotation of 43BSD/contrib/X/doc/Xlib/ch11c.t, revision 1.1.1.1

1.1       root        1: .NH 2
                      2: Cut Buffer Operations
                      3: .PP
                      4: .IN "Cut Buffers"
                      5: .IN "Paste Buffers"
                      6: X provides areas of memory in which bytes can be stored for implementing
                      7: cut and paste between windows.
                      8: It is up to applications to agree what the representation of the
                      9: data in the buffers are.
                     10: The data is most often ascii text.
                     11: Eight such buffers are provided, which can be accessed as a ring,
                     12: or as explicit buffers, numbered 0 through 7.
                     13: .FD
                     14: .IN "Definitions" "XStoreBytes"
                     15: .IN "XStoreBytes"
                     16: XStoreBytes (bytes, length)
                     17:        char *bytes;    /* NOT necessarily ascii or null-terminated */
                     18:        int length;     /* number of bytes */
                     19: .FN
                     20: \fIXStoreBytes\fP stores an arbitrary string of \fIbytes\fP
                     21: in cut buffer number 0.
                     22: The cut buffer's contents may be retrieved later by
                     23: .IN "XFetchBytes"
                     24: any client calling \fIXFetchBytes\fP.
                     25: .PP
                     26: The number of bytes to be stored is given in the parameter \fIlength\fP.
                     27: Note that the cut buffer's contents need not be text, so null bytes 
                     28: are not special.
                     29: .FD
                     30: .IN "Definitions" "XFetchBytes"
                     31: .IN "XFetchBytes"
                     32: char *XFetchBytes (nbytes)
                     33:        int *nbytes;    /* RETURN */
                     34: .FN
                     35: \fIXFetchBytes\fP retrieves the contents of cut buffer 0.
                     36: If the buffer contains data,
                     37: it returns the number of bytes in the \fInbytes\fP argument,
                     38: otherwise it returns NULL and sets \fInbytes\fP to 0.
                     39: The appropriate amount of storage is ``malloc'ed'' and the pointer returned;
                     40: the client must free this storage when finished with it.
                     41: .PP
                     42: Note that the cut buffer does not necessarily contain text, so it may
                     43: contain embedded null bytes and may not terminate with a null byte.
                     44: .FD
                     45: .IN "Definitions" "XRotateBuffers"
                     46: .IN "XRotateBuffers"
                     47: XRotateBuffers (n)
                     48:        int n;
                     49: .FN
                     50: Rotates the cut buffers by n.
                     51: Buffer 0 becomes buffer n, buffer 1 becomes n+1 mod 8, and so on.
                     52: This cut buffer numbering is global to the display.
                     53: .FD
                     54: .IN "Definitions" "XStoreBuffer"
                     55: .IN "XStoreBuffer"
                     56: XStoreBuffer (bytes, nbytes, buffer)
                     57:        char *bytes;    /* NOT necessarily ascii or null-terminated */
                     58:        int nbytes;     /* number of bytes */
                     59:        int buffer;
                     60: .FN
                     61: \fIXStoreBuffer\fP is just like \fIXStoreBytes\fP,
                     62: except that it stores in the
                     63: specified \fIbuffer\fP instead of in buffer 0.
                     64: .FD
                     65: .IN "Definitions" "XFetchBuffer"
                     66: .IN "XFetchBuffer"
                     67: char *XFetchBuffer (nbytes, buffer)
                     68:        int *nbytes;    /* RETURN */
                     69:        int buffer;
                     70: .FN
                     71: \fIXFetchBuffer\fP is just like \fIXFetchBytes\fP,
                     72: except that it fetches the contents
                     73: of the specified \fIbuffer\fP instead of buffer 0. 

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