NWitoa

Converts an integer to a string

NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform Localization (LOC*.*)
Service:Internationalization

Syntax

  #include <nwlocale.h> 
   
  pnstr N_API NWitoa  ( 
     nint   value,  
     pnstr   string,  
     nuint   radix); 
  
  

Pascal Syntax

  uses netwin32 
   
  Function NWitoa 
    (value : nint; 
     str : pnstr; 
     radix : nuint 
  ) : pnstr; 
  
  

Parameters

value
(IN) Specifies the integer to be converted.
string
(OUT) Points to the string result.
radix
(IN) Specifies the base of the value parameter (range 2-36).

Return Values

Returns a pointer to the string.

Remarks

NWitoa converts the digits of the specified value parameter to a NULL-terminated character string and stores the results in the string parameter.

If the radix parameter equals 10 and the value parameter is negative, the first character of the returned string is the minus sign. Otherwise, the value is treated as an unsigned value.

NWitoa returns NULL if an invalid value is passed into the radix parameter.

The string parameter must be pointing to a buffer large enough to contain the number being converted.

See Also

NWltoa, NWultoa, NWutoa