ECVT(3)

NAZWA
ecvt, fcvt - konwersja liczby zmiennoprzecinkowej na łańcuch

SKŁADNIA
#include <stdlib.h>

char *ecvt(double number, int ndigits, int *restrict decpt,
           int *restrict sign);
char *fcvt(double number, int ndigits, int *restrict decpt,
           int *restrict sign);

    Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

ecvt(), fcvt():
    Since glibc 2.17
        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200809L))
            || /* Glibc >= 2.20 */ _DEFAULT_SOURCE
            || /* Glibc <= 2.19 */ _SVID_SOURCE
    Glibc versions 2.12 to 2.16:
        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200112L))
            || _SVID_SOURCE
    Before glibc 2.12:
        _SVID_SOURCE || _XOPEN_SOURCE >= 500

OPIS
Funkcja ecvt() przekształca liczbę number na łańcuch cyfr ndigits zakończony znakiem NULL (gdzie ndigits jest ograniczone do wartości zależnej od systemu określonej przez precyzję typu double) i zwraca wskaźnik do tego łańcucha. Najbardziej znacząca cyfra jest różna od zera, chyba że number wynosi zero. Najmniej znacząca cyfra jest zaokrąglana. Łańcuch nie zawiera kropki dziesiętnej, jednak pozycja kropki dziesiętnej względem początku łańcucha znajduje się w zmiennej *decpt. Ujemna wartość *decpt oznacza, że kropka dziesiętna znajduje się na lewo od początku łańcucha. Jeśli znak liczby number jest ujemny, to *sign przyjmuje wartość różną od zera, a w przeciwnym przypadku 0. Gdy number jest zerem, nie jest określone czy *decpt będzie równe 0 czy 1.

Funkcja fcvt() działa tak samo jak ecvt(), z wyjątkiem tego, że ndigits określa liczbę cyfr po kropce dziesiętnej.

WARTOŚĆ ZWRACANA
Zarówno funkcja ecvt(), jak i fcvt() zwracają wskaźnik do statycznego łańcucha zawierającego reprezentację ASCII liczby number. Łańcuch statyczny jest nadpisywany po każdym wywołaniu ecvt() lub fcvt().

ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
Interfejs | Atrybut | Wartość
ecvt() | Bezpieczeństwo wątkowe | MT-Unsafe race:ecvt
fcvt() | Bezpieczeństwo wątkowe | MT-Unsafe race:fcvt

ZGODNE Z
Oznaczona jako przestarzała w POSIX.1-2001. POSIX.1-2008 usuwa opis funkcji ecvt() i fcvt(), rekomendując używanie zamiast nich funkcji sprintf(3) (chociaż preferowane może być używanie snprintf(3)).

UWAGI
Ne wszystkie języki używają kropki jako separatora części całkowitej od części ułamkowej liczby.

ZOBACZ TAKŻE
ecvt_r(3), gcvt(3), qecvt(3), setlocale(3), sprintf(3)

O STRONIE
Angielska wersja tej strony pochodzi z wydania 5.13 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Adam Byrtek <alpha@irc.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Robert Luberda <robert@debian.org> Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 (https://www.gnu.org/licenses/gpl-3.0.html) lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres manpages-pl-list@lists.sourceforge.net.