STDDEV_SAMP

The STDDEV_SAMP function returns the sample standard deviation (/n-1) of a set of numbers.


                   .-ALL------.                          
>>-STDDEV_SAMP--(--+----------+--numeric-expression--)---------><
                   '-DISTINCT-'

The formula used to calculate the sample standard deviation is:

STDDEV_SAMP = SQRT(VAR_SAMP)

where SQRT(VAR_SAMP) is the square root of the sample variance.

numeric-expression: The argument values must be any built-in numeric data type.

If the argument is DECFLOAT(n), the result of the function is DECFLOAT(34). Otherwise, the data type of the result is double-precision floating point.

The function is applied to the set of values derived from the argument values by the elimination of null values. If DISTINCT is specified, duplicate values are eliminated.

The result can be null. If the function is applied to the empty set or a set with only one row, the result is a null value. Otherwise, the result is the standard deviation of the values in the set.

The order in which the values are added is undefined, but every intermediate result must be within the range of the result data type.

Notes

Start of change Results involving DECFLOAT special values: If the data type of the argument is decimal floating-point and a special value of sNaN or -sNaN, or both +Infinity and -Infinity are included in the aggregation, an error or warning is returned. Otherwise, if +NaN or -NaN is found, the result is +NaN or -NaN. If +Infinity or -Infinity is found, the result is +Infinity or -Infinity. End of change

Example

Using the EMPLOYEE table, set the host variable DEV (double-precision floating point) to the sample standard deviation of the salaries for those employees in department A00.
```
   SELECT STDDEV_SAMP(SALARY)
     INTO :DEV
     FROM EMPLOYEE
     WHERE WORKDEPT = 'A00';
```
Results in DEV being set to approximately 10892.37.