Función escalar LN
La función LN devuelve el logaritmo natural de un número. Las funciones EXP y LN son operaciones opuestas.
El esquema es SYSIBM. (La versión SYSFUN de la función LN continúa estando disponible.)
- expresión
- Expresión que devuelve un valor de cualquier tipo de datos numérico incorporado. Si el valor es un valor de tipo de datos de coma flotante decimal, la operación se realiza en el valor de coma flotante decimal; de otro modo, el valor se convierte en un valor de coma flotante de precisión doble para que lo procese la función. El valor del argumento debe ser superior a cero (SQLSTATE 22003).
Si el argumento es DECFLOAT(n), el resultado es DECFLOAT(n); en caso contrario, el resultado es un número de coma flotante de precisión doble. El resultado puede ser nulo; si el argumento es nulo, el resultado es el valor nulo.
Notas
- Resultados que implican
valores especiales de DECFLOAT: para valores de coma flotante decimal, los
valores especiales se tratan como se indica a continuación:
- LN(NaN) devuelve NaN.
- LN(-NaN) devuelve -NaN.
- LN(Infinity) devuelve Infinity.
- LN(-Infinity) devuelve NaN y un aviso.
- LN(sNaN) devuelve NaN y un aviso.
- LN(-sNaN) devuelve -NaN y un aviso.
- LN(DECFLOAT('0') devuelve -Infinity.
- Alternativas de sintaxis: Por compatibilidad con otros dialectos SQL, se puede especificar LOG en lugar de LN. Sin embargo, debido a que algunos gestores de bases de datos y aplicaciones utilizan LOG para indicar un logaritmo común en lugar de un logaritmo natural, utilice NL en lugar de LOG siempre que sea posible.
Ejemplo
Supongamos que NATLOG es una variable del lenguaje principal DECIMAL(4,2) con un valor de 31,62.
VALUES LN(:NATLOG)