atoi.c File Reference

Parse a number in a string. More...

#include "config.h"
#include <errno.h>
#include <limits.h>
#include <stdlib.h>
#include "atoi.h"

Include dependency graph for atoi.c:

Go to the source code of this file.

Functions
static const char *	str_atol_clamp (const char *str, long *dst, long lmin, long lmax)
	Convert ASCII string to a long and clamp.
static const char *	str_atoull_clamp (const char *str, unsigned long long *dst, unsigned long long ullmax)
	Convert ASCII string to an unsigned long long and clamp.
const char *	mutt_str_atol (const char *str, long *dst)
	Convert ASCII string to a long.
const char *	mutt_str_atos (const char *str, short *dst)
	Convert ASCII string to a short.
const char *	mutt_str_atoi (const char *str, int *dst)
	Convert ASCII string to an integer.
const char *	mutt_str_atoui (const char *str, unsigned int *dst)
	Convert ASCII string to an unsigned integer.
const char *	mutt_str_atoul (const char *str, unsigned long *dst)
	Convert ASCII string to an unsigned long.
const char *	mutt_str_atous (const char *str, unsigned short *dst)
	Convert ASCII string to an unsigned short.
const char *	mutt_str_atoull (const char *str, unsigned long long *dst)
	Convert ASCII string to an unsigned long long.

Detailed Description

Parse a number in a string.

Authors

• Richard Russon
• Pietro Cerutti

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file atoi.c.

Function Documentation

str_atol_clamp()

static const char * str_atol_clamp ( const char * str, long * dst, long lmin, long lmax )

static

Convert ASCII string to a long and clamp.

Parameters

[in]	str	String to read
[in]	lmin	Lower bound
[in]	lmax	Upper bound
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

This is a strtol() wrapper with range checking. errno may be set on error, e.g. ERANGE

Definition at line 53 of file atoi.c.

{
  if (dst)
  {
    *dst = 0;
  }
 
  if (!str || (*str == '\0'))
  {
    return NULL;
  }
 
  char *e = NULL;
  errno = 0;
  long res = strtol(str, &e, 10);
  if ((e == str) || (((res == LONG_MIN) || (res == LONG_MAX)) && (errno == ERANGE)) ||
      (res < lmin) || (res > lmax))
  {
    return NULL;
  }
 
  if (dst)
  {
    *dst = res;
  }
 
  return e;
}

Here is the caller graph for this function:

str_atoull_clamp()

static const char * str_atoull_clamp ( const char * str, unsigned long long * dst, unsigned long long ullmax )

static

Convert ASCII string to an unsigned long long and clamp.

Parameters

[in]	str	String to read
[in]	ullmax	Upper bound
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

This is a strtoull() wrapper with range checking. errno may be set on error, e.g. ERANGE

Definition at line 98 of file atoi.c.

{
  if (dst)
  {
    *dst = 0;
  }
 
  if (!str || (*str == '\0'))
  {
    return str;
  }
 
  char *e = NULL;
  errno = 0;
  unsigned long long res = strtoull(str, &e, 10);
  if ((e == str) || ((res == ULLONG_MAX) && (errno == ERANGE)) || (res > ullmax))
  {
    return NULL;
  }
 
  if (dst)
  {
    *dst = res;
  }
 
  return e;
}

Here is the caller graph for this function:

mutt_str_atol()

const char * mutt_str_atol	(	const char *	str,
		long *	dst )

Convert ASCII string to a long.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

This is a strtol() wrapper with range checking. errno may be set on error, e.g. ERANGE

Definition at line 142 of file atoi.c.

{
  return str_atol_clamp(str, dst, LONG_MIN, LONG_MAX);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_atos()

const char * mutt_str_atos	(	const char *	str,
		short *	dst )

Convert ASCII string to a short.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

This is a strtol() wrapper with range checking. If dst is NULL, the string will be tested only (without conversion).

errno may be set on error, e.g. ERANGE

Definition at line 164 of file atoi.c.

{
  long l = 0;
  const char *res = str_atol_clamp(str, &l, SHRT_MIN, SHRT_MAX);
  if (dst)
  {
    *dst = res ? l : 0;
  }
  return res;
}

Here is the call graph for this function:

mutt_str_atoi()

const char * mutt_str_atoi	(	const char *	str,
		int *	dst )

Convert ASCII string to an integer.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

This is a strtol() wrapper with range checking. If dst is NULL, the string will be tested only (without conversion). errno may be set on error, e.g. ERANGE

Definition at line 191 of file atoi.c.

{
  long l = 0;
  const char *res = str_atol_clamp(str, &l, INT_MIN, INT_MAX);
  if (dst)
  {
    *dst = res ? l : 0;
  }
  return res;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_atoui()

const char * mutt_str_atoui	(	const char *	str,
		unsigned int *	dst )

Convert ASCII string to an unsigned integer.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

Note

This function's return value differs from the other functions. They return -1 if there is input beyond the number.

Definition at line 217 of file atoi.c.

{
  unsigned long long l = 0;
  const char *res = str_atoull_clamp(str, &l, UINT_MAX);
  if (dst)
  {
    *dst = res ? l : 0;
  }
  return res;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_atoul()

const char * mutt_str_atoul	(	const char *	str,
		unsigned long *	dst )

Convert ASCII string to an unsigned long.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

Note

This function's return value differs from the other functions. They return -1 if there is input beyond the number.

Definition at line 243 of file atoi.c.

{
  unsigned long long l = 0;
  const char *res = str_atoull_clamp(str, &l, ULONG_MAX);
  if (dst)
  {
    *dst = res ? l : 0;
  }
  return res;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_atous()

const char * mutt_str_atous	(	const char *	str,
		unsigned short *	dst )

Convert ASCII string to an unsigned short.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

Note

This function's return value differs from the other functions. They return -1 if there is input beyond the number.

Definition at line 269 of file atoi.c.

{
  unsigned long long l = 0;
  const char *res = str_atoull_clamp(str, &l, USHRT_MAX);
  if (dst)
  {
    *dst = res ? l : 0;
  }
  return res;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_atoull()

const char * mutt_str_atoull	(	const char *	str,
		unsigned long long *	dst )

Convert ASCII string to an unsigned long long.

Parameters

[in]	str	String to read
[out]	dst	Store the result

Return values

ptr

endptr

Condition	Description
endptr == NULL	No conversion happened, or overflow
endptr[0] == '\0'	str was fully converted
endptr[0] != '\0'	endptr points to first non converted char in str

Note

This function's return value differs from the other functions. They return -1 if there is input beyond the number.

Definition at line 295 of file atoi.c.

{
  return str_atoull_clamp(str, dst, ULLONG_MAX);
}

Here is the call graph for this function:

Here is the caller graph for this function: