GetTextBufferBlock(3W)           UNIX System V           GetTextBufferBlock(3W)


                                Text Buffer Utilities

NAME
       GetTextBufferBlock

SYNOPSIS
      #include <textbuff.h>
        ...
      extern char * GetTextBufferBlock(text, start_location, end_location)
      TextBuffer * text;
      TextLocation start_location;
      TextLocation end_location;

DESCRIPTION
      The GetTextBufferBlock function is used to retrieve a text block from the
      text TextBuffer.  The block is defined as the characters between
      startlocation and endlocation inclusive.  It returns a pointer to a
      string containing the copy.  If the parameters are invalid NULL is
      returned.

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

NOTE
      The storage for the copy is allocated by this routine.  It is the
      responsibility of the caller to free this storage when it becomes
      dispensible.



























10/89                                                                    Page 1