8.3.2 LN

(1) Specification format

scalar-function-LN ::= LN(target-data)
 
  target-data ::= value-expression

To Page Top

(2) Explanation of specification format

target-data:

Specifies the numeric data whose natural logarithm is to be determined.

The following rules apply:

• Specify the target data in the form of a value expression. For details about value expressions, see 7.20 Value expression.

• Specify numeric data for the target data. For details about numeric data, see (1) Numeric data in 6.2.1 List of data types.

• Specify a positive value for the target data. Values less than or equal to 0 result in an error.

• You cannot specify a dynamic parameter by itself for the target data.

To Page Top

(3) Rules

1. The data type of the execution result is the DOUBLE PRECISION type.

2. The NOT NULL constraint does not apply to the value of the execution result (the null value is allowed).

3. If the target data has the null value, the execution result will be a null value.

To Page Top

(4) Example

Example:

Determine the natural logarithm of the values in columns C1 to C3 in table T1.

SELECT LN("C1"),LN("C2"),LN("C3") FROM "T1"

To Page Top