NWltoa

Converts a long 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 NWltoa  ( 
     nuint32   value,  
     pnstr     buf,  
     nuint     radix); 
  
  

Pascal Syntax

  uses netwin32 
   
  Function NWltoa 
    (value : nint32; 
     buf : pnstr; 
     radix : nuint 
  ) : pnstr; 
  
  

Parameters

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

Return Values

Returns a pointer to the string.

Remarks

NWltoa converts the digits of the specified value parameter to a NULL-terminated character string and stores the results in the buf 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.

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

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

See Also

NWitoa, NWultoa, NWutoa