www.delorie.com/djgpp/doc/libc/libc_36.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

a64l

Syntax

 
#include <stdlib.h>

long a64l(const char *string);

Description

This function takes a pointer to a radix-64 representation, with the first digit the least significant, and returns the corresponding long value.

If string contains more than six characters, only the first six are used. If the first six characters of string contain a null terminator, only those characters before the null terminator are used. a64l will scan the string from left to right, with the least significant digit on the left, decoding each character as a 6-bit radix-64 number.

The radix-64 representation used by this function is described in the documentation for the l64a function (see section l64a).

Return Value

Returns the long value resulting from the conversion of the contents of string, or 0L if string is NULL, points to an empty string, or points to an invalid string (i.e. one not generated by a previous call to l64a). If the result would overflow a long, the conversion of `/2BIG/' (1144341633L) is returned.

Portability

ANSI/ISO C No
POSIX 1003.2-1992; 1003.1-2001 (see note 1)

Notes:

  1. This function is new to the Posix 1003.1-200x draft

  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2004   by DJ Delorie     Updated Apr 2004