База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

strtof — преобразуване на текст във float

strtof прочита началото на низ като float. Указателят endptr позволява да се установи липса на преобразуване и наличие на оставащ текст.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);

strtof от <stdlib.h> пропуска началните интервали и преобразува префикс на низа във float. Десетичният разделител зависи от локала.

Когато endptr != NULL, функцията записва указател към първия необработен знак. end == text означава, че не е извършено преобразуване; само стойността нула не доказва наличие на грешка. За пълна обработка трябва да е изпълнено и *end == '\0'.

Според N3096 отчитането на грешки в диапазона зависи от math_errhandling: при препълване се задава ERANGE, ако е включен MATH_ERRNO; задаването му при недостатъчен диапазон зависи от реализацията. Задайте errno на нула, преди да го проверите.

Примери

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "  12.5kg";
    char *end;
    float value = strtof(text, &end);

    if (end == text) {
        puts("no conversion");
        return 1;
    }

    printf("value=%.1f; rest=%s\n", (double)value, end);
    return 0;
}

Резултат

value=12.5; rest=kg

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници