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

CKTIS / C

strtod — преобразуване на началото на низ в double

strtod преобразува началото на низ в double. Чрез endptr може да се установи, че не е извършено преобразуване, и да се прегледа оставащият текст.

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

Синтаксис

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

strtod пропуска началните интервали и преобразува префикс от низ, завършващ с нулев знак. Десетичният разделител зависи от локала.

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

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

Примери

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

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

    if (end == text) {
        puts("no conversion");
        return EXIT_FAILURE;
    }
    printf("value=%.1f; suffix=%s\n", value, end);
    return EXIT_SUCCESS;
}

Резултат

value=12.5; suffix=kg

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

Източници