strfromf, strfromd, strfroml
|
Определено в заголовочном файле
<stdlib.h>
|
||
|
int
strfromf
(
char
*
restrict
s,
size_t
n,
const
char
*
restrict
format,
float
fp
)
;
|
(начиная с C23) | |
|
int
strfromd
(
char
*
restrict
s,
size_t
n,
const
char
*
restrict
format,
double
fp
)
;
|
(начиная с C23) | |
|
int
strfroml
(
char
*
restrict
s,
size_t
n,
const
char
*
restrict
format,
long
double
fp
)
;
|
(начиная с C23) | |
Преобразует значение с плавающей запятой в байтовую строку.
Функции эквивалентны
snprintf
(
s, n, format, fp
)
, за исключением того, что строка формата может содержать только символ
%
, необязательную точность, не содержащую звёздочку
*
, и один из спецификаторов преобразования
a
,
A
,
e
,
E
,
f
,
F
,
g
, или
G
, которые применяются к типу
double
,
float
, или
long
double
), указанному суффиксом функции (а не модификатором длины). Использование этих функций с любой другой строкой формата приводит к неопределённому поведению.
Содержание |
Параметры
| s | - | указатель на строку символов для записи |
| n | - | может быть записано до n - 1 символов плюс нулевой терминатор |
| format | - | указатель на байтовую строку с нулевым окончанием, определяющую способ интерпретации данных |
| fp | - | преобразуемое значение с плавающей точкой |
Возвращаемое значение
Количество символов, которое было бы записано, если бы n было достаточно большим, не учитывая завершающий нулевой символ. Таким образом, вывод с нулевым завершением был полностью записан тогда и только тогда, когда возвращаемое значение является неотрицательным и меньше n .
Пример
#include <stdio.h> #include <stdlib.h> int main() { char buffer[32]; int written; const char* format[] = {"%a", "%A", "%e", "%E", "%f", "%F", "%g", "%G"}; for (size_t fmt = 0; fmt != sizeof format / sizeof format[0]; ++fmt) { written = strfromf(buffer, sizeof buffer, format[fmt], 3.1415f); printf("strfromf(... %s ...) = %2i, buffer: \"%s\"\n", format[fmt], written, buffer); } puts(""); for (size_t fmt = 0; fmt != sizeof format / sizeof format[0]; ++fmt) { written = strfromd(buffer, sizeof buffer, format[fmt], 3.1415); printf("strfromd(... %s ...) = %2i, buffer: \"%s\"\n", format[fmt], written, buffer); } puts(""); for (size_t fmt = 0; fmt != sizeof format / sizeof format[0]; ++fmt) { written = strfroml(buffer, sizeof buffer, format[fmt], 3.1415); printf("strfroml(... %s ...) = %2i, buffer: \"%s\"\n", format[fmt], written, buffer); } }
Вывод:
strfromf(... %a ...) = 13, buffer: "0x1.921cacp+1" strfromf(... %A ...) = 13, buffer: "0X1.921CACP+1" strfromf(... %e ...) = 12, buffer: "3.141500e+00" strfromf(... %E ...) = 12, buffer: "3.141500E+00" strfromf(... %f ...) = 8, buffer: "3.141500" strfromf(... %F ...) = 8, buffer: "3.141500" strfromf(... %g ...) = 6, buffer: "3.1415" strfromf(... %G ...) = 6, buffer: "3.1415" strfromd(... %a ...) = 20, buffer: "0x1.921cac083126fp+1" strfromd(... %A ...) = 20, buffer: "0X1.921CAC083126FP+1" strfromd(... %e ...) = 12, buffer: "3.141500e+00" strfromd(... %E ...) = 12, buffer: "3.141500E+00" strfromd(... %f ...) = 8, buffer: "3.141500" strfromd(... %F ...) = 8, buffer: "3.141500" strfromd(... %g ...) = 6, buffer: "3.1415" strfromd(... %G ...) = 6, buffer: "3.1415" strfroml(... %a ...) = 20, buffer: "0xc.90e5604189378p-2" strfroml(... %A ...) = 20, buffer: "0XC.90E5604189378P-2" strfroml(... %e ...) = 12, buffer: "3.141500e+00" strfroml(... %E ...) = 12, buffer: "3.141500E+00" strfroml(... %f ...) = 8, buffer: "3.141500" strfroml(... %F ...) = 8, buffer: "3.141500" strfroml(... %g ...) = 6, buffer: "3.1415" strfroml(... %G ...) = 6, buffer: "3.1415"
Справочник
- Стандарт C23 (ISO/IEC 9899:2024):
-
- 7.24.1.3 Функции strfromd, strfromf и strfroml
Смотрите также
|
(C99)
(C11)
(C11)
(C11)
(C11)
|
выводит форматированный вывод в
stdout
, файловый поток или буфер
(функция) |
|
(C99)
(C99)
|
преобразует байтовую строку в значение с плавающей запятой
(функция) |