AT&T UNIX™PC Unix System V Users Manual - tenox

PASTE (3T) (AT&T UNIX PC only ) PASTE ( 3T )
Pb_empty empties the paste buffer file and closes it, It is intended
to be called after the paste buffer file has been read,
Pb_name returns a pointer to a static area containing the name of
the paste buffer file.
Pb_puts appends a null terminated text string to the paste buffer �,
file in ADF format. It has the same interface as [puts .
Pb_weof writes an end of file code to the paste buffer file, and
closes the file. It is intended to be called after the paste buffer file
has been written.
Pb_gets reads the next string from the paste buffer file and converts
it to text. It has the same interface as [g ets . Pb_gets
always returns EOF after 511 bytes have been read. To read
larger blocks of text, pb_gbuf must be used.
Pb_gbuf reads a paste buffer file entry and converts it to text. It
puts the results into the buffer passed to it. Pb_gbuf calls the
passed function to store the buffer at the end of the paste entry,
or when the buffer becomes full. When this function is called, it is
passed the buffer address, and the number of bytes in the buffer.
This function should return a negative value on error.
If a NULL pointer is passed in place of the function, then
pb_gbuf returns a null-terminated string, stored in the passed
buffer. Note that pb_gbuf can only be called once, and the paste
buffer file should be marked empty after the call.
The three functions ad/_gtwrd, ad/_gtxcd, and ad/_gttok are utilities
used by pb_gbuf to interpret the ADF format. Applications
that wish to access the ADF formatted files directly might use
them.
ad/_gtwrd scans the input string pointed to by sptr and pulls out
the next word. It stores this word (null-terminated) to the buffer
pointed to by dptr, and returns an updated input pointer.
Ad/_gtxcd pulls out the embedded text code from the input string
pointed to by sptr , and also returns an updated input pointer.
This text code is stored null-terminated in the buffer pointed to by
dptr . Ad/_gtxcd should be called when a "\" is encountered in
the input line in a text field, and sptr should be pointing to the
character following the "\."
Ad/_gttok converts a word (a null-terminated string) to a token
(integer) and returns the token. The conversion is driven by the
passed keyword table. The keyword table structure is defined in
the include file pbf.h.
EXAMPLE
To implement the cut operation:
paste_file = pb_open ();
if (paste_file == NULL)
message (MT_ERROR, "wp.hlp", "Paste",
"Unable to open or create paste buffer file");
- 2-