convdc

(convdc|convds expr [formato])

Convierte un número real a su representación de cadena.

Argumentos

expr
Un número real.

formato
Un entero con la cantidad de dígitos a la derecha del punto decimal o una cadena con los especificadores siguientes:

Especificador Significado

0
Posición de dígito. Si el valor formateado tiene un dígito en la posición donde 0 aparece en la cadena de formato, entonces ese dígito se copia en la cadena de salida. De lo contrario se almacena un 0.

# Posición de dígito. Si el valor formateado tiene un dígito en la posición donde # aparece en la cadena de formato, entonces ese dígito se copia en la cadena de salida. De lo contrario no se almacena nada.

.
Punto decimal. El primer carácter . (punto) en la cadena de formato determina la localización del separador decimal en el valor formateado; cualquier otro carácter punto se ignora. En la salida del lanzamiento siempre se utiliza el punto como separador decimal, independientemente de la configuración regional del sistema.

E+ Notación científica. Si cualesquiera de las cadenas E+, E-, e+, e- están contenidas en la cadena de formato, el número se formatea usando la notación científica. Un grupo de hasta cuatro caracteres 0 pueden seguir inmediatemente a las cadenas E para determinar la cantidad mínima de dígitos en el exponente. Los formatos E+ y e+ causan la salida del signo + para los exponentes positivos y del signo - para los exponentes negativos. Los formatos E- y e- imprimen el carácter del signo solo para los exponentes negativos.

'xx' Los caracteres entre apóstofes se imprimen tales y cuales, y no afectan el formateo.

;
Los puntos y comas separan la cadena de formato en secciones, de izquierda a derecha, para los números positivos, ceros y negativos.

Especificador	Significado
0	Posición de dígito. Si el valor formateado tiene un dígito en la posición donde 0 aparece en la cadena de formato, entonces ese dígito se copia en la cadena de salida. De lo contrario se almacena un 0.
#	Posición de dígito. Si el valor formateado tiene un dígito en la posición donde # aparece en la cadena de formato, entonces ese dígito se copia en la cadena de salida. De lo contrario no se almacena nada.
.	Punto decimal. El primer carácter . (punto) en la cadena de formato determina la localización del separador decimal en el valor formateado; cualquier otro carácter punto se ignora. En la salida del lanzamiento siempre se utiliza el punto como separador decimal, independientemente de la configuración regional del sistema.
E+	Notación científica. Si cualesquiera de las cadenas E+, E-, e+, e- están contenidas en la cadena de formato, el número se formatea usando la notación científica. Un grupo de hasta cuatro caracteres 0 pueden seguir inmediatemente a las cadenas E para determinar la cantidad mínima de dígitos en el exponente. Los formatos E+ y e+ causan la salida del signo + para los exponentes positivos y del signo - para los exponentes negativos. Los formatos E- y e- imprimen el carácter del signo solo para los exponentes negativos.
'xx'	Los caracteres entre apóstofes se imprimen tales y cuales, y no afectan el formateo.
;	Los puntos y comas separan la cadena de formato en secciones, de izquierda a derecha, para los números positivos, ceros y negativos.

Valor de Retorno

Una cadena con el número real formateado.

Observaciones

Si se omite el argumento formato, la conversión utiliza un formato de número general con 15 dígitos de precisión. Si éstos dígitos no bastaran, automáticamente se aplica la notación científica.

Ejemplos

(convdc 34.4567 2)                   retorna "34.46"
(convdc 34.4567 "0.###")        retorna "34.457"
(convdc 0.34567 "0.###e+")    retorna "3.457e-1"
(convdc 44.56 "000.###")       retorna "044.56"
(convdc 44.56 "000.000")       retorna "044.560"