mirror of
https://gitlab.freedesktop.org/libbsd/libbsd.git
synced 2025-01-09 11:17:37 +01:00
Import strtoi() and strtou() functions from NetBSD
This commit is contained in:
Guillem Jover
parent
ef5faeb575
commit
e13b1a337a
6
COPYING
6
COPYING
@ -3,7 +3,7 @@ Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
|
|||||||
Files:
|
Files:
|
||||||
*
|
*
|
||||||
Copyright:
|
Copyright:
|
||||||
Copyright © 2004-2006, 2008-2017 Guillem Jover <guillem@hadrons.org>
|
Copyright © 2004-2006, 2008-2018 Guillem Jover <guillem@hadrons.org>
|
||||||
License: BSD-3-clause
|
License: BSD-3-clause
|
||||||
|
|
||||||
Files:
|
Files:
|
||||||
@ -110,6 +110,8 @@ Files:
|
|||||||
man/setmode.3bsd
|
man/setmode.3bsd
|
||||||
man/strmode.3bsd
|
man/strmode.3bsd
|
||||||
man/strnstr.3bsd
|
man/strnstr.3bsd
|
||||||
|
man/strtoi.3bsd
|
||||||
|
man/strtou.3bsd
|
||||||
man/unvis.3bsd
|
man/unvis.3bsd
|
||||||
man/vis.3bsd
|
man/vis.3bsd
|
||||||
man/wcslcpy.3bsd
|
man/wcslcpy.3bsd
|
||||||
@ -121,6 +123,8 @@ Files:
|
|||||||
src/setmode.c
|
src/setmode.c
|
||||||
src/strmode.c
|
src/strmode.c
|
||||||
src/strnstr.c
|
src/strnstr.c
|
||||||
|
src/strtoi.c
|
||||||
|
src/strtou.c
|
||||||
src/unvis.c
|
src/unvis.c
|
||||||
Copyright:
|
Copyright:
|
||||||
Copyright © 1980, 1982, 1986, 1989-1994
|
Copyright © 1980, 1982, 1986, 1989-1994
|
||||||
|
|||||||
@ -13,6 +13,7 @@ nobase_include_HEADERS = \
|
|||||||
bsd/bsd.h \
|
bsd/bsd.h \
|
||||||
bsd/err.h \
|
bsd/err.h \
|
||||||
bsd/getopt.h \
|
bsd/getopt.h \
|
||||||
|
bsd/inttypes.h \
|
||||||
bsd/libutil.h \
|
bsd/libutil.h \
|
||||||
bsd/md5.h \
|
bsd/md5.h \
|
||||||
bsd/nlist.h \
|
bsd/nlist.h \
|
||||||
|
|||||||
49
include/bsd/inttypes.h
Normal file
49
include/bsd/inttypes.h
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
/*
|
||||||
|
* Copyright © 2018 Guillem Jover <guillem@hadrons.org>
|
||||||
|
*
|
||||||
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
* modification, are permitted provided that the following conditions
|
||||||
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
* 3. The name of the author may not be used to endorse or promote products
|
||||||
|
* derived from this software without specific prior written permission.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
||||||
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||||
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
||||||
|
* THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||||||
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
||||||
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
||||||
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
||||||
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifdef LIBBSD_OVERLAY
|
||||||
|
#include_next <inttypes.h>
|
||||||
|
#else
|
||||||
|
#include <inttypes.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifndef LIBBSD_INTTYPES_H
|
||||||
|
#define LIBBSD_INTTYPES_H
|
||||||
|
|
||||||
|
#ifdef LIBBSD_OVERLAY
|
||||||
|
#include <sys/cdefs.h>
|
||||||
|
#else
|
||||||
|
#include <bsd/sys/cdefs.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
__BEGIN_DECLS
|
||||||
|
intmax_t strtoi(const char *__restrict nptr, char **__restrict endptr,
|
||||||
|
int base, intmax_t lo, intmax_t hi, int *rstatus);
|
||||||
|
uintmax_t strtou(const char *__restrict nptr, char **__restrict endptr,
|
||||||
|
int base, uintmax_t lo, uintmax_t hi, int *rstatus);
|
||||||
|
__END_DECLS
|
||||||
|
|
||||||
|
#endif
|
||||||
@ -212,7 +212,9 @@ dist_man_MANS = \
|
|||||||
strnstr.3bsd \
|
strnstr.3bsd \
|
||||||
strnunvis.3bsd \
|
strnunvis.3bsd \
|
||||||
strnvis.3bsd \
|
strnvis.3bsd \
|
||||||
|
strtoi.3bsd \
|
||||||
strtonum.3bsd \
|
strtonum.3bsd \
|
||||||
|
strtou.3bsd \
|
||||||
strunvis.3bsd \
|
strunvis.3bsd \
|
||||||
strvis.3bsd \
|
strvis.3bsd \
|
||||||
strvisx.3bsd \
|
strvisx.3bsd \
|
||||||
|
|||||||
@ -94,6 +94,7 @@ be prefixed with
|
|||||||
.It In bitstring.h
|
.It In bitstring.h
|
||||||
.It In err.h
|
.It In err.h
|
||||||
.It In getopt.h
|
.It In getopt.h
|
||||||
|
.It In inttypes.h
|
||||||
.It In libutil.h
|
.It In libutil.h
|
||||||
.It In md5.h
|
.It In md5.h
|
||||||
.It In netinet/ip_icmp.h
|
.It In netinet/ip_icmp.h
|
||||||
@ -214,7 +215,9 @@ This function is provided by
|
|||||||
.Xr strlcpy 3bsd ,
|
.Xr strlcpy 3bsd ,
|
||||||
.Xr strmode 3bsd ,
|
.Xr strmode 3bsd ,
|
||||||
.Xr strnstr 3bsd ,
|
.Xr strnstr 3bsd ,
|
||||||
|
.Xr strtoi 3bsd ,
|
||||||
.Xr strtonum 3bsd ,
|
.Xr strtonum 3bsd ,
|
||||||
|
.Xr strtou 3bsd ,
|
||||||
.Xr timeradd 3bsd ,
|
.Xr timeradd 3bsd ,
|
||||||
.Xr timeval 3bsd ,
|
.Xr timeval 3bsd ,
|
||||||
.Xr tree 3bsd ,
|
.Xr tree 3bsd ,
|
||||||
|
|||||||
238
man/strtoi.3bsd
Normal file
238
man/strtoi.3bsd
Normal file
@ -0,0 +1,238 @@
|
|||||||
|
.\" $NetBSD: strtoi.3,v 1.7 2017/07/03 21:32:50 wiz Exp $
|
||||||
|
.\"
|
||||||
|
.\" Copyright (c) 1990, 1991, 1993
|
||||||
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
|
.\"
|
||||||
|
.\" This code is derived from software contributed to Berkeley by
|
||||||
|
.\" Chris Torek and the American National Standards Committee X3,
|
||||||
|
.\" on Information Processing Systems.
|
||||||
|
.\"
|
||||||
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
.\" modification, are permitted provided that the following conditions
|
||||||
|
.\" are met:
|
||||||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer.
|
||||||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
|
.\" 3. Neither the name of the University nor the names of its contributors
|
||||||
|
.\" may be used to endorse or promote products derived from this software
|
||||||
|
.\" without specific prior written permission.
|
||||||
|
.\"
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||||
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
.\" SUCH DAMAGE.
|
||||||
|
.\"
|
||||||
|
.\" from: @(#)strtol.3 8.1 (Berkeley) 6/4/93
|
||||||
|
.\"
|
||||||
|
.\" Created by Kamil Rytarowski, based on ID:
|
||||||
|
.\" NetBSD: strtol.3,v 1.31 2015/03/11 09:57:35 wiz Exp
|
||||||
|
.\"
|
||||||
|
.Dd November 13, 2015
|
||||||
|
.Dt STRTOI 3bsd
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm strtoi
|
||||||
|
.Nd convert string value to an intmax_t integer
|
||||||
|
.Sh LIBRARY
|
||||||
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
|
.Lb libbsd
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.In inttypes.h
|
||||||
|
(See
|
||||||
|
.Xr libbsd 7
|
||||||
|
for include usage.)
|
||||||
|
.Ft intmax_t
|
||||||
|
.Fo strtoi
|
||||||
|
.Fa "const char * restrict nptr"
|
||||||
|
.Fa "char ** restrict endptr"
|
||||||
|
.Fa "int base"
|
||||||
|
.Fa "intmax_t lo"
|
||||||
|
.Fa "intmax_t hi"
|
||||||
|
.Fa "int *rstatus"
|
||||||
|
.Fc
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
The
|
||||||
|
.Fn strtoi
|
||||||
|
function
|
||||||
|
converts the string in
|
||||||
|
.Fa nptr
|
||||||
|
to an
|
||||||
|
.Ft intmax_t
|
||||||
|
value.
|
||||||
|
The
|
||||||
|
.Fn strtoi
|
||||||
|
function uses internally
|
||||||
|
.Xr strtoimax 3
|
||||||
|
and ensures that the result is always in the range [
|
||||||
|
.Fa lo ..
|
||||||
|
.Fa hi
|
||||||
|
].
|
||||||
|
In adddition it always places
|
||||||
|
.Dv 0
|
||||||
|
on success or a conversion status in the
|
||||||
|
.Fa rstatus
|
||||||
|
argument, avoiding the
|
||||||
|
.Dv errno
|
||||||
|
gymnastics the other functions require.
|
||||||
|
The
|
||||||
|
.Fa rstatus
|
||||||
|
argument can be
|
||||||
|
.Dv NULL
|
||||||
|
if conversion status is to be ignored.
|
||||||
|
.Pp
|
||||||
|
The string may begin with an arbitrary amount of white space
|
||||||
|
(as determined by
|
||||||
|
.Xr isspace 3 )
|
||||||
|
followed by a single optional
|
||||||
|
.Ql +
|
||||||
|
or
|
||||||
|
.Ql -
|
||||||
|
sign.
|
||||||
|
If
|
||||||
|
.Fa base
|
||||||
|
is zero or 16,
|
||||||
|
the string may then include a
|
||||||
|
.Ql 0x
|
||||||
|
or
|
||||||
|
.Ql 0X
|
||||||
|
prefix,
|
||||||
|
and the number will be read in base 16; otherwise,
|
||||||
|
.\" if the
|
||||||
|
.\" .Fa base
|
||||||
|
.\" is zero or 2,
|
||||||
|
.\" the string may then include a
|
||||||
|
.\" .Ql 0b
|
||||||
|
.\" or
|
||||||
|
.\" .Ql 0B
|
||||||
|
.\" prefix,
|
||||||
|
.\" and the number will be read in base 2; otherwise,
|
||||||
|
a zero
|
||||||
|
.Fa base
|
||||||
|
is taken as 10 (decimal) unless the next character is
|
||||||
|
.Ql 0 ,
|
||||||
|
in which case it is taken as 8 (octal).
|
||||||
|
.Pp
|
||||||
|
The remainder of the string is converted to a
|
||||||
|
.Em intmax_t
|
||||||
|
value in the obvious manner,
|
||||||
|
stopping at the first character which is not a valid digit
|
||||||
|
in the given base.
|
||||||
|
(In bases above 10, the letter
|
||||||
|
.Ql A
|
||||||
|
in either upper or lower case
|
||||||
|
represents 10,
|
||||||
|
.Ql B
|
||||||
|
represents 11, and so forth, with
|
||||||
|
.Ql Z
|
||||||
|
representing 35.)
|
||||||
|
.Pp
|
||||||
|
If
|
||||||
|
.Fa endptr
|
||||||
|
is non-nil,
|
||||||
|
.Fn strtoi
|
||||||
|
stores the address of the first invalid character in
|
||||||
|
.Fa *endptr .
|
||||||
|
If there were no digits at all, however,
|
||||||
|
.Fn strtoi
|
||||||
|
stores the original value of
|
||||||
|
.Fa nptr
|
||||||
|
in
|
||||||
|
.Fa *endptr .
|
||||||
|
(Thus, if
|
||||||
|
.Fa *nptr
|
||||||
|
is not
|
||||||
|
.Ql \e0
|
||||||
|
but
|
||||||
|
.Fa **endptr
|
||||||
|
is
|
||||||
|
.Ql \e0
|
||||||
|
on return, the entire string was valid.)
|
||||||
|
.Sh RETURN VALUES
|
||||||
|
The
|
||||||
|
.Fn strtoi
|
||||||
|
function
|
||||||
|
always returns the closest value in the range specified by
|
||||||
|
the
|
||||||
|
.Fa lo
|
||||||
|
and
|
||||||
|
.Fa hi
|
||||||
|
arguments.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Va errno
|
||||||
|
value is guaranteed to be left unchanged.
|
||||||
|
.Pp
|
||||||
|
Errors are stored as the conversion status in the
|
||||||
|
.Fa rstatus
|
||||||
|
argument.
|
||||||
|
.Sh EXAMPLES
|
||||||
|
The following example will always return a number in
|
||||||
|
.Dv [1..99]
|
||||||
|
range no matter what the input is, and warn if the conversion failed.
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
int e;
|
||||||
|
intmax_t lval = strtoi(buf, NULL, 0, 1, 99, &e);
|
||||||
|
if (e)
|
||||||
|
warnc(e, "conversion of `%s' to a number failed, using %jd",
|
||||||
|
buf, lval);
|
||||||
|
.Ed
|
||||||
|
.Sh ERRORS
|
||||||
|
.Bl -tag -width Er
|
||||||
|
.It Bq Er ECANCELED
|
||||||
|
The string did not contain any characters that were converted.
|
||||||
|
.It Bq Er EINVAL
|
||||||
|
The
|
||||||
|
.Ar base
|
||||||
|
is not between 2 and 36 and does not contain the special value 0.
|
||||||
|
.It Bq Er ENOTSUP
|
||||||
|
The string contained non-numeric characters that did not get converted.
|
||||||
|
In this case,
|
||||||
|
.Fa endptr
|
||||||
|
points to the first unconverted character.
|
||||||
|
.It Bq Er ERANGE
|
||||||
|
The given string was out of range; the value converted has been clamped;
|
||||||
|
or the range given was invalid, i.e.
|
||||||
|
.Fa lo
|
||||||
|
>
|
||||||
|
.Fa hi .
|
||||||
|
.El
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr atof 3 ,
|
||||||
|
.Xr atoi 3 ,
|
||||||
|
.Xr atol 3 ,
|
||||||
|
.Xr atoll 3 ,
|
||||||
|
.Xr strtod 3 ,
|
||||||
|
.Xr strtoimax 3 ,
|
||||||
|
.Xr strtol 3 ,
|
||||||
|
.Xr strtoll 3 ,
|
||||||
|
.Xr strtou 3bsd ,
|
||||||
|
.Xr strtoul 3 ,
|
||||||
|
.Xr strtoull 3 ,
|
||||||
|
.Xr strtoumax 3
|
||||||
|
.Sh STANDARDS
|
||||||
|
The
|
||||||
|
.Fn strtoi
|
||||||
|
function is a
|
||||||
|
.Nx
|
||||||
|
extension.
|
||||||
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Fn strtoi
|
||||||
|
function first appeared in
|
||||||
|
.Nx 7 .
|
||||||
|
.Ox
|
||||||
|
introduced the
|
||||||
|
.Fn strtonum 3bsd
|
||||||
|
function for the same purpose, but the interface makes it impossible to
|
||||||
|
properly differentiate illegal returns.
|
||||||
|
.Sh BUGS
|
||||||
|
Ignores the current locale.
|
||||||
238
man/strtou.3bsd
Normal file
238
man/strtou.3bsd
Normal file
@ -0,0 +1,238 @@
|
|||||||
|
.\" $NetBSD: strtou.3,v 1.7 2017/07/03 21:32:50 wiz Exp $
|
||||||
|
.\"
|
||||||
|
.\" Copyright (c) 1990, 1991, 1993
|
||||||
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
|
.\"
|
||||||
|
.\" This code is derived from software contributed to Berkeley by
|
||||||
|
.\" Chris Torek and the American National Standards Committee X3,
|
||||||
|
.\" on Information Processing Systems.
|
||||||
|
.\"
|
||||||
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
.\" modification, are permitted provided that the following conditions
|
||||||
|
.\" are met:
|
||||||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer.
|
||||||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
|
.\" 3. Neither the name of the University nor the names of its contributors
|
||||||
|
.\" may be used to endorse or promote products derived from this software
|
||||||
|
.\" without specific prior written permission.
|
||||||
|
.\"
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||||
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
.\" SUCH DAMAGE.
|
||||||
|
.\"
|
||||||
|
.\" from: @(#)strtoul.3 8.1 (Berkeley) 6/4/93
|
||||||
|
.\"
|
||||||
|
.\" Created by Kamil Rytarowski, based on ID:
|
||||||
|
.\" NetBSD: strtoul.3,v 1.29 2015/03/10 13:00:58 christos Exp
|
||||||
|
.\"
|
||||||
|
.Dd November 13, 2015
|
||||||
|
.Dt STRTOU 3bsd
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm strtou
|
||||||
|
.Nd convert a string to an uintmax_t integer
|
||||||
|
.Sh LIBRARY
|
||||||
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
|
.Lb libbsd
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.In inttypes.h
|
||||||
|
(See
|
||||||
|
.Xr libbsd 7
|
||||||
|
for include usage.)
|
||||||
|
.Ft uintmax_t
|
||||||
|
.Fo strtou
|
||||||
|
.Fa "const char * restrict nptr"
|
||||||
|
.Fa "char ** restrict endptr"
|
||||||
|
.Fa "int base"
|
||||||
|
.Fa "uintmax_t lo"
|
||||||
|
.Fa "uintmax_t hi"
|
||||||
|
.Fa "int *rstatus"
|
||||||
|
.Fc
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
The
|
||||||
|
.Fn strtou
|
||||||
|
function converts the string in
|
||||||
|
.Fa nptr
|
||||||
|
to an
|
||||||
|
.Ft uintmax_t
|
||||||
|
value.
|
||||||
|
The
|
||||||
|
.Fn strtou
|
||||||
|
function uses internally
|
||||||
|
.Xr strtoumax 3
|
||||||
|
and ensures that the result is always in the range [
|
||||||
|
.Fa lo ..
|
||||||
|
.Fa hi
|
||||||
|
].
|
||||||
|
In adddition it always places
|
||||||
|
.Dv 0
|
||||||
|
on success or a conversion status in the
|
||||||
|
.Fa rstatus
|
||||||
|
argument, avoiding the
|
||||||
|
.Dv errno
|
||||||
|
gymnastics the other functions require.
|
||||||
|
The
|
||||||
|
.Fa rstatus
|
||||||
|
argument can be
|
||||||
|
.Dv NULL
|
||||||
|
if conversion status is to be ignored.
|
||||||
|
.Pp
|
||||||
|
The string may begin with an arbitrary amount of white space
|
||||||
|
(as determined by
|
||||||
|
.Xr isspace 3 )
|
||||||
|
followed by a single optional
|
||||||
|
.Ql +
|
||||||
|
or
|
||||||
|
.Ql -
|
||||||
|
sign.
|
||||||
|
If
|
||||||
|
.Fa base
|
||||||
|
is zero or 16,
|
||||||
|
the string may then include a
|
||||||
|
.Ql 0x
|
||||||
|
or
|
||||||
|
.Ql 0X
|
||||||
|
prefix,
|
||||||
|
and the number will be read in base 16; otherwise,
|
||||||
|
.\" if the
|
||||||
|
.\" .Fa base
|
||||||
|
.\" is zero or 2,
|
||||||
|
.\" the string may then include a
|
||||||
|
.\" .Ql 0b
|
||||||
|
.\" or
|
||||||
|
.\" .Ql 0B
|
||||||
|
.\" prefix,
|
||||||
|
.\" and the number will be read in base 2; otherwise,
|
||||||
|
a zero
|
||||||
|
.Fa base
|
||||||
|
is taken as 10 (decimal) unless the next character is
|
||||||
|
.Ql 0 ,
|
||||||
|
in which case it is taken as 8 (octal).
|
||||||
|
.Pp
|
||||||
|
The remainder of the string is converted to an
|
||||||
|
.Em uintmax_t
|
||||||
|
value in the obvious manner,
|
||||||
|
stopping at the end of the string
|
||||||
|
or at the first character that does not produce a valid digit
|
||||||
|
in the given base.
|
||||||
|
(In bases above 10, the letter
|
||||||
|
.Ql A
|
||||||
|
in either upper or lower case
|
||||||
|
represents 10,
|
||||||
|
.Ql B
|
||||||
|
represents 11, and so forth, with
|
||||||
|
.Ql Z
|
||||||
|
representing 35.)
|
||||||
|
.Pp
|
||||||
|
If
|
||||||
|
.Fa endptr
|
||||||
|
is non-nil,
|
||||||
|
.Fn strtou
|
||||||
|
stores the address of the first invalid character in
|
||||||
|
.Fa *endptr .
|
||||||
|
If there were no digits at all, however,
|
||||||
|
.Fn strtou
|
||||||
|
stores the original value of
|
||||||
|
.Fa nptr
|
||||||
|
in
|
||||||
|
.Fa *endptr .
|
||||||
|
(Thus, if
|
||||||
|
.Fa *nptr
|
||||||
|
is not
|
||||||
|
.Ql \e0
|
||||||
|
but
|
||||||
|
.Fa **endptr
|
||||||
|
is
|
||||||
|
.Ql \e0
|
||||||
|
on return, the entire string was valid.)
|
||||||
|
.Sh RETURN VALUES
|
||||||
|
The
|
||||||
|
.Fn strtou
|
||||||
|
function
|
||||||
|
always returns the closest value in the range specified by
|
||||||
|
the
|
||||||
|
.Fa lo
|
||||||
|
and
|
||||||
|
.Fa hi
|
||||||
|
arguments.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Va errno
|
||||||
|
value is guaranteed to be left unchanged.
|
||||||
|
.Pp
|
||||||
|
Errors are stored as the conversion status in the
|
||||||
|
.Fa rstatus
|
||||||
|
argument.
|
||||||
|
.Sh EXAMPLES
|
||||||
|
The following example will always return a number in
|
||||||
|
.Dv [1..99]
|
||||||
|
range no matter what the input is, and warn if the conversion failed.
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
int e;
|
||||||
|
uintmax_t lval = strtou(buf, NULL, 0, 1, 99, &e);
|
||||||
|
if (e)
|
||||||
|
warnc(e, "conversion of `%s' to a number failed, using %ju",
|
||||||
|
buf, lval);
|
||||||
|
.Ed
|
||||||
|
.Sh ERRORS
|
||||||
|
.Bl -tag -width Er
|
||||||
|
.It Bq Er ECANCELED
|
||||||
|
The string did not contain any characters that were converted.
|
||||||
|
.It Bq Er EINVAL
|
||||||
|
The
|
||||||
|
.Ar base
|
||||||
|
is not between 2 and 36 and does not contain the special value 0.
|
||||||
|
.It Bq Er ENOTSUP
|
||||||
|
The string contained non-numeric characters that did not get converted.
|
||||||
|
In this case,
|
||||||
|
.Fa endptr
|
||||||
|
points to the first unconverted character.
|
||||||
|
.It Bq Er ERANGE
|
||||||
|
The given string was out of range; the value converted has been clamped; or
|
||||||
|
the range given was invalid, i.e.
|
||||||
|
.Fa lo
|
||||||
|
>
|
||||||
|
.Fa hi .
|
||||||
|
.El
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr atof 3 ,
|
||||||
|
.Xr atoi 3 ,
|
||||||
|
.Xr atol 3 ,
|
||||||
|
.Xr atoll 3 ,
|
||||||
|
.Xr strtod 3 ,
|
||||||
|
.Xr strtoi 3bsd ,
|
||||||
|
.Xr strtoimax 3 ,
|
||||||
|
.Xr strtol 3 ,
|
||||||
|
.Xr strtoll 3 ,
|
||||||
|
.Xr strtoul 3 ,
|
||||||
|
.Xr strtoull 3 ,
|
||||||
|
.Xr strtoumax 3
|
||||||
|
.Sh STANDARDS
|
||||||
|
The
|
||||||
|
.Fn strtou
|
||||||
|
function is a
|
||||||
|
.Nx
|
||||||
|
extension.
|
||||||
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Fn strtou
|
||||||
|
function first appeared in
|
||||||
|
.Nx 7 .
|
||||||
|
.Ox
|
||||||
|
introduced the
|
||||||
|
.Fn strtonum 3bsd
|
||||||
|
function for the same purpose, but the interface makes it impossible to
|
||||||
|
properly differentiate illegal returns.
|
||||||
|
.Sh BUGS
|
||||||
|
Ignores the current locale.
|
||||||
@ -104,7 +104,9 @@ libbsd_la_SOURCES = \
|
|||||||
stringlist.c \
|
stringlist.c \
|
||||||
strmode.c \
|
strmode.c \
|
||||||
strnstr.c \
|
strnstr.c \
|
||||||
|
strtoi.c \
|
||||||
strtonum.c \
|
strtonum.c \
|
||||||
|
strtou.c \
|
||||||
timeconv.c \
|
timeconv.c \
|
||||||
unvis.c \
|
unvis.c \
|
||||||
vis.c \
|
vis.c \
|
||||||
|
|||||||
@ -145,6 +145,9 @@ LIBBSD_0.9 {
|
|||||||
|
|
||||||
pidfile_fileno;
|
pidfile_fileno;
|
||||||
|
|
||||||
|
strtoi;
|
||||||
|
strtou;
|
||||||
|
|
||||||
nvis;
|
nvis;
|
||||||
snvis;
|
snvis;
|
||||||
stravis;
|
stravis;
|
||||||
|
|||||||
97
src/strtoi.c
Normal file
97
src/strtoi.c
Normal file
@ -0,0 +1,97 @@
|
|||||||
|
/* $NetBSD: _strtoi.h,v 1.2 2015/01/18 17:55:22 christos Exp $ */
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* Copyright (c) 1990, 1993
|
||||||
|
* The Regents of the University of California. All rights reserved.
|
||||||
|
*
|
||||||
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
* modification, are permitted provided that the following conditions
|
||||||
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
* 3. Neither the name of the University nor the names of its contributors
|
||||||
|
* may be used to endorse or promote products derived from this software
|
||||||
|
* without specific prior written permission.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||||
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
* SUCH DAMAGE.
|
||||||
|
*
|
||||||
|
* Original version ID:
|
||||||
|
* NetBSD: src/lib/libc/locale/_wcstoul.h,v 1.2 2003/08/07 16:43:03 agc Exp
|
||||||
|
*
|
||||||
|
* Created by Kamil Rytarowski, based on ID:
|
||||||
|
* NetBSD: src/common/lib/libc/stdlib/_strtoul.h,v 1.7 2013/05/17 12:55:56 joe…
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <sys/cdefs.h>
|
||||||
|
|
||||||
|
#include <stddef.h>
|
||||||
|
#include <assert.h>
|
||||||
|
#include <errno.h>
|
||||||
|
#include <inttypes.h>
|
||||||
|
|
||||||
|
#define _DIAGASSERT(t)
|
||||||
|
|
||||||
|
intmax_t
|
||||||
|
strtoi(const char *__restrict nptr,
|
||||||
|
char **__restrict endptr, int base,
|
||||||
|
intmax_t lo, intmax_t hi, int *rstatus)
|
||||||
|
{
|
||||||
|
int serrno;
|
||||||
|
intmax_t im;
|
||||||
|
char *ep;
|
||||||
|
int rep;
|
||||||
|
|
||||||
|
_DIAGASSERT(hi >= lo);
|
||||||
|
|
||||||
|
_DIAGASSERT(nptr != NULL);
|
||||||
|
/* endptr may be NULL */
|
||||||
|
|
||||||
|
if (endptr == NULL)
|
||||||
|
endptr = &ep;
|
||||||
|
|
||||||
|
if (rstatus == NULL)
|
||||||
|
rstatus = &rep;
|
||||||
|
|
||||||
|
serrno = errno;
|
||||||
|
errno = 0;
|
||||||
|
|
||||||
|
im = strtoimax(nptr, endptr, base);
|
||||||
|
|
||||||
|
*rstatus = errno;
|
||||||
|
errno = serrno;
|
||||||
|
|
||||||
|
if (*rstatus == 0) {
|
||||||
|
/* No digits were found */
|
||||||
|
if (nptr == *endptr)
|
||||||
|
*rstatus = ECANCELED;
|
||||||
|
/* There are further characters after number */
|
||||||
|
else if (**endptr != '\0')
|
||||||
|
*rstatus = ENOTSUP;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (im < lo) {
|
||||||
|
if (*rstatus == 0)
|
||||||
|
*rstatus = ERANGE;
|
||||||
|
return lo;
|
||||||
|
}
|
||||||
|
if (im > hi) {
|
||||||
|
if (*rstatus == 0)
|
||||||
|
*rstatus = ERANGE;
|
||||||
|
return hi;
|
||||||
|
}
|
||||||
|
|
||||||
|
return im;
|
||||||
|
}
|
||||||
97
src/strtou.c
Normal file
97
src/strtou.c
Normal file
@ -0,0 +1,97 @@
|
|||||||
|
/* $NetBSD: _strtoi.h,v 1.2 2015/01/18 17:55:22 christos Exp $ */
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* Copyright (c) 1990, 1993
|
||||||
|
* The Regents of the University of California. All rights reserved.
|
||||||
|
*
|
||||||
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
* modification, are permitted provided that the following conditions
|
||||||
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
* 3. Neither the name of the University nor the names of its contributors
|
||||||
|
* may be used to endorse or promote products derived from this software
|
||||||
|
* without specific prior written permission.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||||
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
* SUCH DAMAGE.
|
||||||
|
*
|
||||||
|
* Original version ID:
|
||||||
|
* NetBSD: src/lib/libc/locale/_wcstoul.h,v 1.2 2003/08/07 16:43:03 agc Exp
|
||||||
|
*
|
||||||
|
* Created by Kamil Rytarowski, based on ID:
|
||||||
|
* NetBSD: src/common/lib/libc/stdlib/_strtoul.h,v 1.7 2013/05/17 12:55:56 joe…
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <sys/cdefs.h>
|
||||||
|
|
||||||
|
#include <stddef.h>
|
||||||
|
#include <assert.h>
|
||||||
|
#include <errno.h>
|
||||||
|
#include <inttypes.h>
|
||||||
|
|
||||||
|
#define _DIAGASSERT(t)
|
||||||
|
|
||||||
|
uintmax_t
|
||||||
|
strtou(const char *__restrict nptr,
|
||||||
|
char **__restrict endptr, int base,
|
||||||
|
uintmax_t lo, uintmax_t hi, int *rstatus)
|
||||||
|
{
|
||||||
|
int serrno;
|
||||||
|
uintmax_t im;
|
||||||
|
char *ep;
|
||||||
|
int rep;
|
||||||
|
|
||||||
|
_DIAGASSERT(hi >= lo);
|
||||||
|
|
||||||
|
_DIAGASSERT(nptr != NULL);
|
||||||
|
/* endptr may be NULL */
|
||||||
|
|
||||||
|
if (endptr == NULL)
|
||||||
|
endptr = &ep;
|
||||||
|
|
||||||
|
if (rstatus == NULL)
|
||||||
|
rstatus = &rep;
|
||||||
|
|
||||||
|
serrno = errno;
|
||||||
|
errno = 0;
|
||||||
|
|
||||||
|
im = strtoumax(nptr, endptr, base);
|
||||||
|
|
||||||
|
*rstatus = errno;
|
||||||
|
errno = serrno;
|
||||||
|
|
||||||
|
if (*rstatus == 0) {
|
||||||
|
/* No digits were found */
|
||||||
|
if (nptr == *endptr)
|
||||||
|
*rstatus = ECANCELED;
|
||||||
|
/* There are further characters after number */
|
||||||
|
else if (**endptr != '\0')
|
||||||
|
*rstatus = ENOTSUP;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (im < lo) {
|
||||||
|
if (*rstatus == 0)
|
||||||
|
*rstatus = ERANGE;
|
||||||
|
return lo;
|
||||||
|
}
|
||||||
|
if (im > hi) {
|
||||||
|
if (*rstatus == 0)
|
||||||
|
*rstatus = ERANGE;
|
||||||
|
return hi;
|
||||||
|
}
|
||||||
|
|
||||||
|
return im;
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue
Block a user