UN-Compress a String to a Clipper Numeric value
──────────────────────────────────────────────────────────────────────────────

 Syntax

        <numeric> := GT_UnCompN(<string>,<size>)

 Arguments:

      <str>     - Character String to uncompress
      <size>    - Number of Bytes of string to uncompress (1/2/4/8)

 Returns:

      <numeric> - Clipper value uncompressed

 Description:

      This function works hand-in-hand with GT_CompN(), this function
      uncompress's strings that have previously been compressed.


 Examples:

      #include "gt_compn.h"

         s_w := GT_CompN( w, GT_BYTE)
         s_x := GT_CompN( x, GT_INT )
         s_y := GT_CompN( y, GT_LONG)
         s_z := GT_CompN( z, GT_DOUBLE)

         * Display the Values that were Stored

         ? GT_UnCompN( s_w, GT_BYTE)
         ? GT_UnCompN( s_x, GT_INT )
         ? GT_UnCompN( s_y, GT_LONG)
         ? GT_UnCompN( s_z, GT_DOUBLE)


 Source: GT_UCMPN.C

 Author:  Brian Dukes