Compute x
to the power of y
.
gentype pow(gentype x,
gentype y)
float n pown(float n x,
int n y)
float pown(float x,
int y)
double n pown(double n x,
int n y)
double pown(double x,
int y)
gentype powr(gentype x,
gentype y)
gentype half_powr(gentype x,
gentype y)
gentype native_powr(gentype x,
gentype y)
half n pown(half n x,
int n y)
half pown(half x,
int y)
Description
pow
Computes x
to the power of y
.
pown
Computes x
to the power of y
, where y
is an integer.
powr
Computes x
to the power of y
, where x
is ≥ 0.
half_powr
Computes x
to the power of y
, where x
is ≥ 0.
native_powr
Computes x
to the power of y
, where x
is ≥ 0.
The range of x
and y
are implementationdefined.
The maximum error is implementationdefined.
Notes
General information about builtin math functions: The builtin math functions are categorized into the following:

A list of builtin functions that have scalar or vector argument versions, and,

A list of builtin functions that only take scalar float arguments.
The vector versions of the math functions operate componentwise. The description is percomponent.
The builtin math functions are not affected by the prevailing rounding mode in the calling environment, and always return the same value as they would if called with the round to nearest even rounding mode.
The builtin math functions take scalar or vector arguments. For any specific use of these function, the actual type has to be the same for all arguments and the return type unless otherwise specified.
The generic type name gentype
is used to indicate that the function can take float
, float2
, float3
, float4
, float8
, float16
, double
, double2
, double3
, double4
, double8
, or double16
as the type for the arguments.
If extended with cl_khr_fp16
, generic type name gentype
may indicate half
and half{234816}
as arguments and return values.
The generic type name gentypef
is used to indicate that the function can take float
, float2
, float3
, float4
, float8
, or float16
as the type for the arguments.
The generic type name gentyped
is used to indicate that the function can take double
, double2
, double3
, double4
, double8
, or double16
as the type for the arguments.
A subset of Math functions (table 6.8) are defined with the half_
prefix.
These functions are implemented with a minimum of 10bits of accuracy i.e.
an ULP value ≤ 8192 ulp.
A subset of Math functions (table 6.8) are defined with the native_
prefix.
These functions may map to one or more native device instructions and will typically have better performance compared to the corresponding functions (without the native__
prefix).
The accuracy (and in some cases the input range(s)) of these functions is implementationdefined.
For the half and native forms, we use the generic type name gentype to indicate that the functions (table 6.9) can take float
, float2
, float3
, float4
, float8
or float16
as the type for the arguments.
Support for denormal values is optional for half_
functions.
The half_
functions may return any result allowed by section 7.5.3, even when cldenormsarezero
(see section 5.8.4.2) is not in force.
Support for denormal values is implementationdefined for native_
functions.