ecvt

Nach oben zu stdlib.h - Index

Header-Datei

stdlib.h

Kategorie

Konvertierungsroutinen, mathematische Routinen

Prototyp

char *ecvt(double value, int ndig, int *dec, int *sign);

Beschreibung

Konvertiert eine Gleitkommazahl in einen String.

ecvt konvertiert einen Wert value beginnend mit der am weitesten links stehenden signifikanten Ziffer in einen nullterminierten String von ndig Ziffern. Die Position des Dezimalzeichens bezogen auf den String-Anfang wird indirekt durch dec angegeben (ein negativer Wert für dec gibt an, dass das Dezimalzeichen links von den zurückgegebenen Ziffern steht). Der String enthält selbst kein Dezimalzeichen. Ist value ein negativer Wert, hat das word, auf das sign zeigt, einen Wert ungleich Null, andernfalls den Wert 0. Die niedrigwertige Ziffer gibt einen gerundeten Wert wieder.

Rückgabewert

Der Rückgabewert von ecvt zeigt auf statische Daten für den Ziffern-String, dessen Inhalt mit jedem Aufruf von ecvt und fcvt überschrieben wird.

Beispiel

 #include <stdlib.h>
 #include <stdio.h>
 int main(void)
 {
    char *string;
    double value;
    int dec, sign;
    int ndig = 10;
    value = 9,876;
    string = ecvt(value, ndig, &dec, &sign);
    printf("string = %s      dec = %d sign = %d\n", string, dec, sign);
    value = -123.45;
    ndig= 15;
    string = ecvt(value,ndig,&dec,&sign);
    printf("string = %s dec = %d sign = %d\n", string, dec, sign);
    value = 0.6789e5; /* Wissenschaftliche Notation */
    ndig = 5;
    string = ecvt(value,ndig,&dec,&sign);
    printf("string = %s         dec = %d sign = %d\n", string, dec, sign);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+