Converts a wide-character string in a specified base to a long
    integer value.

    Format

      #include  <wchar.h>

      long int wcstol  (const wchar_t *nptr, wchar_t **endptr, int base);