BLISTRFRG        (Clipper Summer '87)
------------------------------------------------------------------------------

  Function : Clipper S'87 fragmentation string

  Syntax   : cValue = BLISTRFRG([cString])

  Return   : Fragmentation as a string

  This function returns a string containing a summary of Clipper's dynamic
  memory to show the degree of fragmentation. Each character position
  represents up to 512 bytes, and adjacent equal characters represent
  contiguous blocks larger than 512 bytes.

  The optional parameter is a five character string in the form "ffuua" as
  described below. The first two characters (ff) are used to represent
  free blocks and the next two characters (uu) to represent used blocks,
  with the final character (a) used to represent the next allocation
  point. The returned string contains a map of both the near heap and the
  far heap (FREE POOL), separated by a ',' character. The layout and
  meaning of the display is detailed in the discussion of the function
  BLIDISFRG().

  Example  :
  * Get the string showing memory fragmentation
  * Use 'f' for all free blocks, 'u' for all used
  *
  TMPSTRFRG = BLISTRFRG("ffuua")
  ? "The state of dynamic memory is currently"
  ? TMPSTRFRG