RFC: man-page for strfrom functions

Hi all,

The strfrom class of functions convert a floating-point value into string. It is recently introduced in Glibc (see commit 6962682ffe5e) and will be in version 2.25.

I've prepared a patch to add strfrom.3 in the man-pages but I'd like to discuss a point for the contribution beforehand:

- strfrom* is similar to snprintf() except for the format string. For instance, it doesn't have the length modifier and accept just a subset of conversion specifiers.

That said, I've doubt if wouldn't be better to place strfrom documentation at snprintf man-page (which is actually printf's) rather than on its own page.

The ISO/IEC TS 18661-1 specifies the strfrom() class of functions that convert a float-point value to string.

The strfromd(), strfromf(), and strfroml() functions are introduced (commit 6962682ffe5e) in GNU C Library 2.25.

Signed-off-by Wainer dos Santos Moschetta <[email protected]>

---
 man3/strfrom.3  | 220 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 man3/strfromd.3 |   1 +
 man3/strfromf.3 |   1 +
 man3/strfroml.3 |   1 +
 4 files changed, 223 insertions(+)
 create mode 100644 man3/strfrom.3
 create mode 100644 man3/strfromd.3
 create mode 100644 man3/strfromf.3
 create mode 100644 man3/strfroml.3

man3/strfrom.3 new file +22 -0

new file mode 100644
index 0000000..fdc15cc
@@ -0,0 +1,220 @@
+.\" Copyright (c) 2016, IBM Corporation.
+.\" Written by Wainer dos Santos Moschetta <[email protected]>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of
+.\" this manual under the conditions for verbatim copying, provided that
+.\" the entire resulting derived work is distributed under the terms of
+.\" a permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume.
+.\" no responsibility for errors or omissions, or for damages resulting.
+.\" from the use of the information contained herein.  The author(s) may.
+.\" not have taken the same level of care in the production of this.
+.\" manual, which is licensed free of charge, as they might when working.
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by

man3/strfrom.3 new file +18 -0

+.sp
+.BI "int strfromf (char * restrict " str ", size_t " n ", const char * restrict " format ", float "fp ");"
+.sp
+.BI "int strfroml (char * restrict " str ", size_t " n ", const char * restrict " format ", long double " fp ");"
+.sp
+.in -4
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.ad l
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ():
+.RS 4
+__STDC_WANT_IEC_60559_BFP_EXT__
+.RE
+.ad b

man3/strfrom.3 new file +18 -0

+.I n
+characters are stored into
+.IR str .
+.sp
+The terminating null character ('\\0') is written if and only if
+.I n
+is sufficiently large, otherwise the written string is truncated at
+.I n
+characters.
+.sp
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are equivalent to
+.sp
+.in +4

man3/strfrom.3 new file +7 -0

+.BR a ,
+.BR A ,
+.BR e ,
+.BR E ,
+.BR f ,
+.BR F ,
+.BR g ,

man3/strfrom.3 new file +19 -0

+.B F
+(or
+.BR A ,
+.BR E ,
+.BR G )
+is the conversion specifier, the conversion is to "NAN" or "-NAN".
+.sp
+Likewise if
+.I fp
+is infinity, it is converted to [-]inf or [-]INF.
+.in
+.sp
+A malformed
+.I format
+string results in undefined behavior.
+.SH RETURN VALUE
+The
+.BR strfromd (),
+.BR strfromf (),

man3/strfrom.3 new file +12 -0

+.B POSIX Safety Concepts
+section in GNU C Library manual.
+.sp
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ()

man3/strfrom.3 new file +13 -0

+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char *s = (char *) malloc (ssize);
+strfromf (s, ssize, "%.2f", 12.3456);
+.fi
+.in
+.sp
+To convert the 12.345e19 value as a double type to string using scientific notation with zero digits of precision, resulting in "1E+20":
+.sp

The ISO/IEC TS 18661-1 specifies the strfrom() class of functions that convert a float-point value to string.

The strfromd(), strfromf(), and strfroml() functions are introduced (commit 6962682ffe5e) in GNU C Library 2.25.

Signed-off-by Wainer dos Santos Moschetta <[email protected]>

---
 man3/strfromd.3 | 255 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 man3/strfromd.3

man3/strfromd.3 new file +199 -0

new file mode 100644
index 0000000..4b1aced
@@ -0,0 +1,255 @@
+.\" Copyright (c) 2016, IBM Corporation.
+.\" Written by Wainer dos Santos Moschetta <[email protected]>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of
+.\" this manual under the conditions for verbatim copying, provided that
+.\" the entire resulting derived work is distributed under the terms of
+.\" a permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume.
+.\" no responsibility for errors or omissions, or for damages resulting.
+.\" from the use of the information contained herein.  The author(s) may.
+.\" not have taken the same level of care in the production of this.
+.\" manual, which is licensed free of charge, as they might when working.
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.\" References consulted:
+.\"   Glibc 2.25 source code and manual.
+.\"   C99 standard document.
+.\"   ISO/IEC TS 18661-1 technical specification.
+.\"   snprintf and other man.3 pages.
+.\"
+.TH STRFROMD 3 2016-12-02 "GNU C Library"
+.SH NAME
+strfromd, strfromf, strfroml \- convert a floating-point value into
+a string.
+.SH SYNOPSIS
+.B #include <stdlib.h>
+.sp
+.BI "int strfromd (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", double " fp ");"
+.br
+.BI "int strfromf (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", float "fp ");"
+.br
+.BI "int strfroml (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", long double " fp ");"
+.sp
+.in -4
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.ad l
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ():
+.RS 4
+__STDC_WANT_IEC_60559_BFP_EXT__
+.RE
+.ad b
+.SH DESCRIPTION
+The
+.BR strfrom ()
+class of functions converts a floating-point value
+.I fp
+into a string of characters
+.IR str ,
+with a configurable
+.IR format
+string.
+At most
+.I n
+characters are stored into
+.IR str .
+.sp
+The terminating null character ('\\0') is written if and only if
+.I n
+is sufficiently large, otherwise the written string is truncated at
+.I n
+characters.
+.sp
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are equivalent to
+.sp
+.in +4
+.BI "snprintf (str,  n, format, fp)"
+.in
+.sp
+except for the
+.I format
+string.
+.SS Format of the format string
+The
+.I format
+string must start with the character %.
+This is followed by an optional precision which starts with period
+character (.), followed by an optional decimal integer.
+If no integer is specified after the period character, the precision used
+is zero.
+Finally, it should have one of the conversion specifiers
+.BR a ,
+.BR A ,
+.BR e ,
+.BR E ,
+.BR f ,
+.BR F ,
+.BR g ,
+or
+.BR G .
+.sp
+The conversion specifier is applied based on the floating-point type
+indicated by the function suffix.
+Therefore, unlike
+.BR snprintf (),
+the format string does not have a length modifier character.
+See
+.BR snprintf (3)
+for a detailed description of these conversion specifiers.
+.sp
+The implementation conforms to the C99 standard on conversion of NaN and
+infinity values:
+.sp
+.in +4
+If
+.I fp
+is a NaN, +NaN, or -NaN, and
+.BR f
+(or
+.BR a ,
+.BR e ,
+.BR g )
+is the conversion specifier, the conversion is to "nan", "nan", or "-nan",
+respectively.
+If
+.B F
+(or
+.BR A ,
+.BR E ,
+.BR G )
+is the conversion specifier, the conversion is to "NAN" or "-NAN".
+.sp
+Likewise if
+.I fp
+is infinity, it is converted to [-]inf or [-]INF.
+.in
+.sp
+A malformed
+.I format
+string results in undefined behavior.
+.SH RETURN VALUE
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions return the number of characters that would have been written in
+.I str
+if
+.I n
+had enough space,
+not counting the terminating null character.
+Thus, a return value of
+.I n
+or greater means that the output was truncated.
+.SH VERSIONS
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are available in glibc since version 2.25.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7)
+and the
+.B POSIX Safety Concepts
+section in GNU C Library manual.
+.sp
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ()
+T}	Thread safety	MT-Safe locale
+\^	Asynchronous signal safety	AS-Unsafe heap
+\^	Asynchronous cancellation safety	AC-Unsafe mem
+.TE
+.sp

man3/strfromd.3 new file +23 -0

+strfromf(s, ssize, "%f", 12.1);
+.fi
+.in
+.sp
+To convert the value 12.3456 as a float type to a string using
+decimal notation with two digits of precision, resulting in "12.35":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char *s = (char *) malloc(ssize);
+strfromf(s, ssize, "%.2f", 12.3456);
+.fi
+.in
+.sp
+To convert the value 12.345e19 as a double type to a string using
+scientific notation with zero digits of precision, resulting in "1E+20":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__

Hello Wainer,

Just a few more questions and comments.

Quoted 220 lines · Wainer dos Santos Moschetta

The ISO/IEC TS 18661-1 specifies the strfrom() class of functions that convert a float-point value to string.

The strfromd(), strfromf(), and strfroml() functions are introduced (commit 6962682ffe5e) in GNU C Library 2.25.

Signed-off-by Wainer dos Santos Moschetta <[email protected]>

---
 man3/strfromd.3 | 255 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 man3/strfromd.3

man3/strfromd.3 new file +202 -0

new file mode 100644
index 0000000..4b1aced
@@ -0,0 +1,255 @@
+.\" Copyright (c) 2016, IBM Corporation.
+.\" Written by Wainer dos Santos Moschetta <[email protected]>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of
+.\" this manual under the conditions for verbatim copying, provided that
+.\" the entire resulting derived work is distributed under the terms of
+.\" a permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume.
+.\" no responsibility for errors or omissions, or for damages resulting.
+.\" from the use of the information contained herein.  The author(s) may.
+.\" not have taken the same level of care in the production of this.
+.\" manual, which is licensed free of charge, as they might when working.
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.\" References consulted:
+.\"   Glibc 2.25 source code and manual.
+.\"   C99 standard document.
+.\"   ISO/IEC TS 18661-1 technical specification.
+.\"   snprintf and other man.3 pages.
+.\"
+.TH STRFROMD 3 2016-12-02 "GNU C Library"
+.SH NAME
+strfromd, strfromf, strfroml \- convert a floating-point value into
+a string.
+.SH SYNOPSIS
+.B #include <stdlib.h>
+.sp
+.BI "int strfromd (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", double " fp ");"
+.br
+.BI "int strfromf (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", float "fp ");"
+.br
+.BI "int strfroml (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", long double " fp ");"
+.sp
+.in -4
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.ad l
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ():
+.RS 4
+__STDC_WANT_IEC_60559_BFP_EXT__
+.RE
+.ad b
+.SH DESCRIPTION
+The
+.BR strfrom ()
+class of functions converts a floating-point value
+.I fp
+into a string of characters
+.IR str ,
+with a configurable
+.IR format
+string.
+At most
+.I n
+characters are stored into
+.IR str .
+.sp
+The terminating null character ('\\0') is written if and only if
+.I n
+is sufficiently large, otherwise the written string is truncated at
+.I n
+characters.
+.sp
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are equivalent to
+.sp
+.in +4
+.BI "snprintf (str,  n, format, fp)"
+.in
+.sp
+except for the
+.I format
+string.
+.SS Format of the format string
+The
+.I format
+string must start with the character %.
+This is followed by an optional precision which starts with period
+character (.), followed by an optional decimal integer.
+If no integer is specified after the period character, the precision used
+is zero.
+Finally, it should have one of the conversion specifiers
+.BR a ,
+.BR A ,
+.BR e ,
+.BR E ,
+.BR f ,
+.BR F ,
+.BR g ,
+or
+.BR G .
+.sp
+The conversion specifier is applied based on the floating-point type
+indicated by the function suffix.
+Therefore, unlike
+.BR snprintf (),
+the format string does not have a length modifier character.
+See
+.BR snprintf (3)
+for a detailed description of these conversion specifiers.
+.sp
+The implementation conforms to the C99 standard on conversion of NaN and
+infinity values:
+.sp
+.in +4
+If
+.I fp
+is a NaN, +NaN, or -NaN, and
+.BR f
+(or
+.BR a ,
+.BR e ,
+.BR g )
+is the conversion specifier, the conversion is to "nan", "nan", or "-nan",
+respectively.
+If
+.B F
+(or
+.BR A ,
+.BR E ,
+.BR G )
+is the conversion specifier, the conversion is to "NAN" or "-NAN".
+.sp
+Likewise if
+.I fp
+is infinity, it is converted to [-]inf or [-]INF.
+.in
+.sp
+A malformed
+.I format
+string results in undefined behavior.
+.SH RETURN VALUE
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions return the number of characters that would have been written in
+.I str
+if
+.I n
+had enough space,
+not counting the terminating null character.
+Thus, a return value of
+.I n
+or greater means that the output was truncated.
+.SH VERSIONS
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are available in glibc since version 2.25.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7)
+and the
+.B POSIX Safety Concepts
+section in GNU C Library manual.
+.sp
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ()
+T}	Thread safety	MT-Safe locale
+\^	Asynchronous signal safety	AS-Unsafe heap
+\^	Asynchronous cancellation safety	AC-Unsafe mem
+.TE
+.sp
+Note: these attributes are preliminary.
+.SH CONFORMING TO
+C99, ISO/IEC TS 18661-1.

man3/strfromd.3 line 209

Quoted 7 lines

man3/strfromd.3 new file +7 -0

+.SH NOTES
+The behavior of
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions depends on the

Is not s/depends on/take account of/ more accurate?

Quoted 4 lines

man3/strfromd.3 new file +3 -0

+.B LC_NUMERIC
+category of the current locale.
+

man3/strfromd.3 line 222

Quoted 10 lines

man3/strfromd.3 new file +10 -0

+.SH EXAMPLES
+To convert the value 12.1 as a float type to a string using decimal
+notation, resulting in "12.100000":q	
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char *s = (char *) malloc(ssize);

Why do you use malloc() in these examples, rather than just using (say) a char[10]? (Sorry, I should have asked this before...)

Quoted 24 lines

man3/strfromd.3 new file +23 -0

+strfromf(s, ssize, "%f", 12.1);
+.fi
+.in
+.sp
+To convert the value 12.3456 as a float type to a string using
+decimal notation with two digits of precision, resulting in "12.35":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char *s = (char *) malloc(ssize);
+strfromf(s, ssize, "%.2f", 12.3456);
+.fi
+.in
+.sp
+To convert the value 12.345e19 as a double type to a string using
+scientific notation with zero digits of precision, resulting in "1E+20":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__

man3/strfromd.3 line 255

Quoted 10 lines

man3/strfromd.3 new file +10 -0

+#include <stdlib.h>
+int ssize = 10;
+char *s = (char *) malloc(ssize);
+strfromd(s, ssize, "%.E", 12.345e19);
+.fi
+.in
+.SH SEE ALSO
+.BR atof (3),
+.BR snprintf (3),
+.BR strtod (3)

Cheers,

Michael

The ISO/IEC TS 18661-1 specifies the strfrom() class of functions that convert a float-point value to string.

The strfromd(), strfromf(), and strfroml() functions are introduced (commit 6962682ffe5e) in GNU C Library 2.25.

Signed-off-by Wainer dos Santos Moschetta <[email protected]>

---
 man3/strfromd.3 | 255 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 man3/strfromd.3

man3/strfromd.3 new file +255 -0

new file mode 100644
index 0000000..ea3b140
@@ -0,0 +1,255 @@
+.\" Copyright (c) 2016, IBM Corporation.
+.\" Written by Wainer dos Santos Moschetta <[email protected]>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\"
+.\" Permission is granted to copy and distribute modified versions of
+.\" this manual under the conditions for verbatim copying, provided that
+.\" the entire resulting derived work is distributed under the terms of
+.\" a permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume.
+.\" no responsibility for errors or omissions, or for damages resulting.
+.\" from the use of the information contained herein.  The author(s) may.
+.\" not have taken the same level of care in the production of this.
+.\" manual, which is licensed free of charge, as they might when working.
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
+.\"
+.\" References consulted:
+.\"   Glibc 2.25 source code and manual.
+.\"   C99 standard document.
+.\"   ISO/IEC TS 18661-1 technical specification.
+.\"   snprintf and other man.3 pages.
+.\"
+.TH STRFROMD 3 2016-12-02 "GNU C Library"
+.SH NAME
+strfromd, strfromf, strfroml \- convert a floating-point value into
+a string.
+.SH SYNOPSIS
+.B #include <stdlib.h>
+.sp
+.BI "int strfromd (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", double " fp ");"
+.br
+.BI "int strfromf (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", float "fp ");"
+.br
+.BI "int strfroml (char *restrict " str ", size_t " n ",
+.br
+.BI "              const char *restrict " format ", long double " fp ");"
+.sp
+.in -4
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.ad l
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ():
+.RS 4
+__STDC_WANT_IEC_60559_BFP_EXT__
+.RE
+.ad b
+.SH DESCRIPTION
+The
+.BR strfrom ()
+class of functions converts a floating-point value
+.I fp
+into a string of characters
+.IR str ,
+with a configurable
+.IR format
+string.
+At most
+.I n
+characters are stored into
+.IR str .
+.sp
+The terminating null character ('\\0') is written if and only if
+.I n
+is sufficiently large, otherwise the written string is truncated at
+.I n
+characters.
+.sp
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are equivalent to
+.sp
+.in +4
+.BI "snprintf (str,  n, format, fp)"
+.in
+.sp
+except for the
+.I format
+string.
+.SS Format of the format string
+The
+.I format
+string must start with the character %.
+This is followed by an optional precision which starts with period
+character (.), followed by an optional decimal integer.
+If no integer is specified after the period character, the precision used
+is zero.
+Finally, it should have one of the conversion specifiers
+.BR a ,
+.BR A ,
+.BR e ,
+.BR E ,
+.BR f ,
+.BR F ,
+.BR g ,
+or
+.BR G .
+.sp
+The conversion specifier is applied based on the floating-point type
+indicated by the function suffix.
+Therefore, unlike
+.BR snprintf (),
+the format string does not have a length modifier character.
+See
+.BR snprintf (3)
+for a detailed description of these conversion specifiers.
+.sp
+The implementation conforms to the C99 standard on conversion of NaN and
+infinity values:
+.sp
+.in +4
+If
+.I fp
+is a NaN, +NaN, or -NaN, and
+.BR f
+(or
+.BR a ,
+.BR e ,
+.BR g )
+is the conversion specifier, the conversion is to "nan", "nan", or "-nan",
+respectively.
+If
+.B F
+(or
+.BR A ,
+.BR E ,
+.BR G )
+is the conversion specifier, the conversion is to "NAN" or "-NAN".
+.sp
+Likewise if
+.I fp
+is infinity, it is converted to [-]inf or [-]INF.
+.in
+.sp
+A malformed
+.I format
+string results in undefined behavior.
+.SH RETURN VALUE
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions return the number of characters that would have been written in
+.I str
+if
+.I n
+had enough space,
+not counting the terminating null character.
+Thus, a return value of
+.I n
+or greater means that the output was truncated.
+.SH VERSIONS
+The
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions are available in glibc since version 2.25.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7)
+and the
+.B POSIX Safety Concepts
+section in GNU C Library manual.
+.sp
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR strfromd (),
+.BR strfromf (),
+.BR strfroml ()
+T}	Thread safety	MT-Safe locale
+\^	Asynchronous signal safety	AS-Unsafe heap
+\^	Asynchronous cancellation safety	AC-Unsafe mem
+.TE
+.sp
+Note: these attributes are preliminary.
+.SH CONFORMING TO
+C99, ISO/IEC TS 18661-1.
+.SH NOTES
+The behavior of
+.BR strfromd (),
+.BR strfromf (),
+and
+.BR strfroml ()
+functions take account of the
+.B LC_NUMERIC
+category of the current locale.
+
+.SH EXAMPLES
+To convert the value 12.1 as a float type to a string using decimal
+notation, resulting in "12.100000":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char s[ssize];
+strfromf(s, ssize, "%f", 12.1);
+.fi
+.in
+.sp
+To convert the value 12.3456 as a float type to a string using
+decimal notation with two digits of precision, resulting in "12.35":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char s[ssize];
+strfromf(s, ssize, "%.2f", 12.3456);
+.fi
+.in
+.sp
+To convert the value 12.345e19 as a double type to a string using
+scientific notation with zero digits of precision, resulting in "1E+20":
+.sp
+.in +4
+.nf
+#define __STDC_WANT_IEC_60559_BFP_EXT__
+#include <stdlib.h>
+int ssize = 10;
+char s[ssize];
+strfromd(s, ssize, "%.E", 12.345e19);
+.fi
+.in
+.SH SEE ALSO
+.BR atof (3),
+.BR snprintf (3),
+.BR strtod (3)