Namespaces
Variants

strfromf, strfromd, strfroml

From cppreference.net
< c ‎ | string ‎ | byte
Определено в заголовочном файле <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

Смотрите также

выводит форматированный вывод в stdout , файловый поток или буфер
(функция)
преобразует байтовую строку в значение с плавающей запятой
(функция)