[PATCH 22/24] strtol.3, strtoul.3: SYNOPSIS: Use 'restrict' in prototypes

Alejandro Colomar
2021-03-10T18:33:10Z

Both POSIX and glibc use 'restrict' in strtol(), strtoll(), strtoul(), strtoull().
Let's use it here too.

.../glibc$ grep_glibc_prototype strtol
stdlib/stdlib.h:176:
extern long int strtol (const char *__restrict __nptr,
char **__restrict __endptr, int __base)
__THROW __nonnull ((1));
.../glibc$ grep_glibc_prototype strtoll
stdlib/stdlib.h:199:
__extension__
extern long long int strtoll (const char *__restrict __nptr,
char **__restrict __endptr, int __base)
__THROW __nonnull ((1));
.../glibc$ grep_glibc_prototype strtoul
stdlib/stdlib.h:180:
extern unsigned long int strtoul (const char *__restrict __nptr,
char **__restrict __endptr, int __base)
__THROW __nonnull ((1));
.../glibc$ grep_glibc_prototype strtoull
stdlib/stdlib.h:204:
__extension__
extern unsigned long long int strtoull (const char *__restrict __nptr,
char **__restrict __endptr, int __base)
__THROW __nonnull ((1));
.../glibc$

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
man3/strtol.3 | 7 ++++---
man3/strtoul.3 | 8 ++++----
2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/man3/strtol.3 b/man3/strtol.3
index 8f4a5e54c..148586b99 100644
--- a/man3/strtol.3
+++ b/man3/strtol.3
@@ -36,9 +36,10 @@ strtol, strtoll, strtoq \- convert a string to a long integer
.nf
.B #include <stdlib.h>
.PP
-.BI "long strtol(const char *" nptr ", char **" endptr ", int " base );
-.BI "long long strtoll(const char *" nptr ", char **" endptr \
-", int " base );
+.BI "long strtol(const char *restrict " nptr ,
+.BI " char **restrict " endptr ", int " base );
+.BI "long long strtoll(const char *restrict " nptr ,
+.BI " char **restrict " endptr ", int " base );
.fi
.PP
.RS -4
diff --git a/man3/strtoul.3 b/man3/strtoul.3
index b0a5c34fe..c6a55e732 100644
--- a/man3/strtoul.3
+++ b/man3/strtoul.3
@@ -37,10 +37,10 @@ strtoul, strtoull, strtouq \- convert a string to an unsigned long integer
.nf
.B #include <stdlib.h>
.PP
-.BI "unsigned long strtoul(const char *" nptr ", char **" endptr \
-", int " base );
-.BI "unsigned long long strtoull(const char *" nptr ", char **" endptr ,
-.BI " int " base );
+.BI "unsigned long strtoul(const char *restrict " nptr ,
+.BI " char **restrict " endptr ", int " base );
+.BI "unsigned long long strtoull(const char *restrict " nptr ,
+.BI " char **restrict " endptr ", int " base );
.fi
.PP
.RS -4
--
2.30.1.721.g45526154a5