*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> a64l (3)              
Title
Content
Arch
Section
 

a64l(3)

Contents


NAME    [Toc]    [Back]

       a64l, l64a - convert long integer and base-64 ASCII string

SYNOPSIS    [Toc]    [Back]

       #include <stdlib.h>

       long a64l(
               const char *s ); char *l64a(
               long l );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       a64l(), l64a(): XSH4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies a pointer to a character string that  is  to  be
       converted  to  a  long  integer.  Specifies a long integer
       that is to be converted to a character string.

DESCRIPTION    [Toc]    [Back]

       These functions are used to  maintain  numbers  stored  in
       base-64  ASCII  characters. The a64l() function converts a
       character string to a long integer.  The  l64a()  function
       converts a long integer to a character string.

       On  Tru64  UNIX systems, for which the data type long contains
 64 bits, only the low-order 32  bits  are  used  for
       these operations.

       Each  character  used to store a long integer represents a
       numeric value from 0 through 63. Up to six characters  may
       be used to represent a long integer.

       The  characters  are  translated  as follows: A period (.)
       represents 0.  A slash (/) represents 1.   The  numbers  0
       through  9  represent  2  through 11.  Uppercase letters A
       through Z represent 12 through 37.   Lowercase  letters  a
       through z represent 38 through 63.

       The a64l() function takes a pointer to a base-64 representation,
 in which the first digit is the least significant,
       and  returns  a  corresponding  long  value. If the string
       pointed to by the  s  parameter  exceeds  six  characters,
       a64l()  uses  only the first six. If the first six characters
 of the string contain a null terminator, a64l()  uses
       only characters preceding the null terminator. A character
       string is translated from left to  right  with  the  least
       significant  number  on  the  left  and  each character is
       translated as a 6-bit base-64 number. The resulting  value
       is sign-extended.

       The  l64a()  function  takes  a long integer and returns a
       pointer to a corresponding base-64 notation of  the  least
       significant 32 bits.

       [Tru64  UNIX]  In  applications  that  are  compiled in an
       environment that excludes the _XOPEN_SOURCE_EXTENDED standard
  definitions,  the  behavior of the l64a() and a64l()
       functions differs from that described in this  section  as
       follows:  Conversion  operations  use  64  bits.  Up to 12
       characters can be used to represent a long integer.

NOTES    [Toc]    [Back]

       The value returned by l64a() is a pointer to a thread-specific
  buffer whose contents will be overwritten on subsequent
 calls from the same thread.

       [Tru64 UNIX]  The a64l() and l64a() functions belong to  a
       small  set  of libc functions that are handled differently
       when compiled in  the  X/Open  UNIX  environment.  In  the
       X/Open  UNIX  environment,  calls  to  these functions are
       internally renamed by prepending _E to the function  name.
       The  renaming  is  done only when there is an incompatible
       conflict between an existing version of the  function  and
       the version that conforms to the X/Open UNIX standard. The
       renaming strategy supports binary compatibility by  allowing
 applications to compile in the X/Open UNIX environment
       and also link with site-specific and third-party libraries
       that  use  the  old  versions of the same libc interfaces.
       However, internal renaming of the calls affects how  these
       calls are identified during debugging sessions. Therefore,
       when you are debugging a module that includes  the  a64l()
       and/or      l64a()     functions     and     for     which
       _XOPEN_SOURCE_EXTENDED has been  defined,  use  _Ea64l  to
       refer to the a64l() call and _El64a to refer to the l64a()
       call.  See  standards(5)  for  information  on  when   the
       _XOPEN_SOURCE_EXTENDED macro is defined.

RETURN VALUES    [Toc]    [Back]

       On  successful completion, the a64l() function returns the
       long value resulting from conversion of the input  string.
       If  a  string  pointed  to  by the s parameter is an empty
       string, a64l() returns zero (0).

       The l64a() function returns a pointer to the corresponding
       base-64  notation.  If the l parameter is zero (0), l64a()
       returns a pointer to an empty string.

ERRORS    [Toc]    [Back]

       No errors are defined for this function.

SEE ALSO    [Toc]    [Back]

      
      
       Standards: standards(5)



                                                          a64l(3)
[ Back ]
 Similar pages
Name OS Title
a64l NetBSD convert between a long integer and a base-64 ASCII string
l64a NetBSD convert between a long integer and a base-64 ASCII string
a64l IRIX convert between long integer and base-64 ASCII string
l64a_r NetBSD convert between a long integer and a base-64 ASCII string
atoll FreeBSD convert ASCII string to long or long long integer
atol FreeBSD convert ASCII string to long or long long integer
atoll OpenBSD convert ASCII string to long long integer
atoll NetBSD convert ASCII string to long long integer
atol OpenBSD convert ASCII string to long integer
atol NetBSD convert ASCII string to long integer
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service