CopyTextBufferBlock(3W)          UNIX System V          CopyTextBufferBlock(3W)


                                Text Buffer Utilities

NAME
       CopyTextBufferBlock

SYNOPSIS
      #include <textbuff.h>
        ...
      extern int CopyTextBufferBlock(text, buffer, start_position,
                 end_position)
      TextBuffer * text;
      char * buffer;
      TextPosition start_position;
      TextPosition end_position;

DESCRIPTION
      The CopyTextBufferBlock function is used to retrieve a text block from
      the text TextBuffer.  The block is defined as the characters between
      startposition and endposition inclusive.  It returns the number of
      bytes copied; if the parameters are invalid the return value is zero (0).

SEE ALSO
      GetTextBufferLocation(3W), GetTextBufferChar(3W), GetTextBufferLine(3W)

NOTE
      The storage for the copy is allocated by the caller.  It is the
      responsibility of the caller to ensure that enough storage is allocated
      to copy end_position - start_position + 1 bytes.


























10/89                                                                    Page 1