Función escalar POWER

La función POWER devuelve el resultado de elevar el primer argumento a la potencia del segundo argumento.

Read syntax diagramSkip visual syntax diagramPOWER(expression1, expression2)

El esquema es SYSIBM. (La versión SYSFUN de la función POWER continúa estando disponible.)

expression1
Una expresión que devuelve un valor de cualquier tipo de datos numérico interno.
expression2
Una expresión que devuelve un valor de cualquier tipo de datos numérico interno.

Si el valor de expresión1 es igual a cero, expresión2 debe ser mayor que o igual a cero. Si ambos argumentos son 0, el resultado es 1. Si el valor de expresión1 es menor que cero, la expresión2 debe ser un valor entero.

El resultado de la función es:
  • INTEGER si ambos argumentos son INTEGER o SMALLINT
  • BIGINT si un argumento es BIGINT y el otro argumento es BIGINT, INTEGER o SMALLINT
  • DECFLOAT(34) si uno de los argumentos es una coma flotante decimal. Si uno de los dos argumentos es DECFLOAT y se cumple como verdadero una de las siguientes sentencias, el resultado será NAN y una condición de operación no válida:
    • Ambos argumentos son cero
    • El segundo argumento tiene una parte fraccionaria distinta de cero
    • El segundo argumento tiene más de 9 dígitos
    • El segundo argumento es INFINITY
  • DOUBLE en caso contrario
Si el argumento es un valor de coma flotante decimal especial, se aplicarán las normas para las operaciones aritméticas generales para la coma flotante decimal. Consulte Reglas de operación aritmética general para coma flotante decimal en Expresiones.

El resultado puede ser nulo; si cualquier argumento es nulo, el resultado es el valor nulo.

Ejemplo

Suponga que la variable del lenguaje principal HPOWER es un entero con un valor de 3.
   VALUES POWER(2,:HPOWER)
Devuelve el valor 8.