Skip to contentSkip to conversation

wprintf.3: SYNOPSIS: Use 'restrict' in prototypes

PATCH In review Alejandro Colomar 2 participants 2 messages Mar 13, 2021 – Mar 14, 2021 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 wprintf.3: SYNOPSIS: Use 'restrict' in prototypes

POSIX uses 'restrict' in *wprintf() (see [v]fwprintf(3p)). Let's use it here too.

---

Hi Michael,

I found this last one, which I didn't find through the glibc sources because they have a bit of a mess with *printf() functions. I checked that POSIX requires 'restrict'.

At this point, I still have a few patches about prototypes (not restrict), but I'll buffer them for now.

Cheers,

Alex

 man3/wprintf.3 | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)
man3/wprintf.3 +10 -8
index 676fe1ed7..76acfbb34 100644
@@ -22,15 +22,17 @@ wide-character output conversion
 .B #include <stdio.h>
 .B #include <wchar.h>
 .PP
-.BI "int wprintf(const wchar_t *" format ", ...);"
-.BI "int fwprintf(FILE *" stream ", const wchar_t *" format ", ...);"
-.BI "int swprintf(wchar_t *" wcs ", size_t " maxlen ,
-.BI "             const wchar_t *" format ", ...);"
+.BI "int wprintf(const wchar_t *restrict " format ", ...);"
+.BI "int fwprintf(FILE *restrict " stream ,
+.BI "             const wchar_t *restrict " format ", ...);"
+.BI "int swprintf(wchar_t *restrict " wcs ", size_t " maxlen ,
+.BI "             const wchar_t *restrict " format ", ...);"
 .PP
-.BI "int vwprintf(const wchar_t *" format ", va_list " args );
-.BI "int vfwprintf(FILE *" stream ", const wchar_t *" format ", va_list " args );
-.BI "int vswprintf(wchar_t *" wcs ", size_t " maxlen ,
-.BI "             const wchar_t *" format ", va_list " args );
+.BI "int vwprintf(const wchar_t *restrict " format ", va_list " args );
+.BI "int vfwprintf(FILE *restrict " stream ,
+.BI "             const wchar_t *restrict " format ", va_list " args );
+.BI "int vswprintf(wchar_t *restrict " wcs ", size_t " maxlen ,
+.BI "             const wchar_t *restrict " format ", va_list " args );
 .fi
 .PP
 .RS -4
Signature · 1 line
2.30.1.721.g45526154a5
#1 lore raw

Hello Alex,

Quoted 2 lines · Alejandro Colomar

POSIX uses 'restrict' in *wprintf() (see [v]fwprintf(3p)). Let's use it here too.

Thanks! Patch applied.

Cheers,

Michael

Quoted 50 lines

---

Hi Michael,

I found this last one, which I didn't find through the glibc sources because they have a bit of a mess with *printf() functions. I checked that POSIX requires 'restrict'.

At this point, I still have a few patches about prototypes (not restrict), but I'll buffer them for now.

Cheers,

Alex

 man3/wprintf.3 | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)
man3/wprintf.3 +10 -8
index 676fe1ed7..76acfbb34 100644
@@ -22,15 +22,17 @@ wide-character output conversion
 .B #include <stdio.h>
 .B #include <wchar.h>
 .PP
-.BI "int wprintf(const wchar_t *" format ", ...);"
-.BI "int fwprintf(FILE *" stream ", const wchar_t *" format ", ...);"
-.BI "int swprintf(wchar_t *" wcs ", size_t " maxlen ,
-.BI "             const wchar_t *" format ", ...);"
+.BI "int wprintf(const wchar_t *restrict " format ", ...);"
+.BI "int fwprintf(FILE *restrict " stream ,
+.BI "             const wchar_t *restrict " format ", ...);"
+.BI "int swprintf(wchar_t *restrict " wcs ", size_t " maxlen ,
+.BI "             const wchar_t *restrict " format ", ...);"
 .PP
-.BI "int vwprintf(const wchar_t *" format ", va_list " args );
-.BI "int vfwprintf(FILE *" stream ", const wchar_t *" format ", va_list " args );
-.BI "int vswprintf(wchar_t *" wcs ", size_t " maxlen ,
-.BI "             const wchar_t *" format ", va_list " args );
+.BI "int vwprintf(const wchar_t *restrict " format ", va_list " args );
+.BI "int vfwprintf(FILE *restrict " stream ,
+.BI "             const wchar_t *restrict " format ", va_list " args );
+.BI "int vswprintf(wchar_t *restrict " wcs ", size_t " maxlen ,
+.BI "             const wchar_t *restrict " format ", va_list " args );
 .fi
 .PP
 .RS -4
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/