[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
 INTPOS()
 Converts a signed integer into an unsigned integer
------------------------------------------------------------------------------
 Syntax
     INTPOS(<nSigned|cHexSigned>,[<l32Bit>])
         --> nUnsigned
 Arguments
     <nUnsigned|cHexUnsigned>  Designates either a numeric value or
     hexadecimal digit string to convert into a 16-bit or 32-bit unsigned
     integer.
     <l32Bit>  If this optional parameter is designated as .T., the
     function processes the designated value as a 32-bit signed integer.  The
     default value is a 16-bit signed integer (.F.).
 Returns
     INTPOS() returns an unsigned 16-bit or 32-bit integer.
 Description
     This function converts signed 16-bit or 32-bit integers into the
     corresponding unsigned number.  Based on the optional parameter and the
     logical value it is assigned, you can work with 16-bit or 32-bit values.
     For the 16-bit variant, all values in the 0 to 32767 range are
     unchanged.  However, all negative values from -1 to -32768 are changed.
     When the optional parameter is designated as .T., the range of values
     stretches from -2147483648 to +2147483647.
 Note
     .  This function returns a 0 result for invalid paramerters.
 Examples
     .  Show simple conversions:
        ? INTPOS(-1)               // 65535
        ? INTPOS(-2)               // 65534
        ? INTPOS(30000)            // 30000
        ? INTPOS(60000)            // 60000
     Warning!  When working with 16-bit values INTPOS(0) = INTPOS(65536):
        ? INTPOS(0)                // 0
        ? INTPOS(65536)            // 0
     .  Show values larger than 65536 in 16-bit mode.  For example,
        the difference between 90000 and 65536 is 24464:
        ? INTPOS(90000)            // 24464
     .  However, in 32-bit mode:
        ? INTPOS(90000, .T.)       // 90000
        ? INTPOS(-1, .T.)          // 4294967295
                                   // (largest 32-bit number)
        ? INTPOS(-60000, .T.)      // 4294907296
        ? INTPOS(-90000, .T.)      // 4294877296
See Also:
INTNEG()
NUMAND()
NUMOR()
NUMXOR()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson