NAME¶
Symbolic_Math_Constants - The following symbolic constants are available.
BUILT-IN MATH CONSTANTS¶
The following symbolic constants are available. Their values are of type
float and are accurate within the precision of a single precision
floating-point number.
Constant Name |
Description |
MAXFLOAT |
Value of maximum non-infinite single-precision floating-point
number. |
HUGE_VALF |
A positive float constant expression. HUGE_VALF evaluates to
+infinity. Used as an error value returned by the
mathFunctions(3clc). |
INFINITY |
A constant expression of type float representing positive or
unsigned infinity. |
NAN |
A constant expression of type float representing a quiet
NaN. |
If double precision is supported by the device, the following symbolic constant
will also be available:
Constant Name |
Description |
HUGE_VAL |
A positive double constant expression. HUGE_VAL evaluates to
+infinity. Used as an error value returned by the built-in math
functions. |
The following constants are also available. They are of type
float and
are accurate within the precision of the
float type.
Constant Name |
Description |
M_E_F |
Value of e |
M_LOG2E_F |
Value of log<sub>2</sub>e |
M_LOG10E_F |
Value of log<sub>10</sub>e |
M_LN2_F |
Value of log<sub>e</sub>2 |
M_LN10_F |
Value of log<sub>e</sub>10 |
M_PI_F |
Value of pi |
M_PI_2_F |
Value of pi / 2 |
M_PI_4_F |
Value of pi / 4 |
M_1_PI_F |
Value of 1 / pi |
M_2_PI_F |
Value of 2 / pi |
M_2_SQRTPI_F |
Value of 2 / (square root of pi) |
M_SQRT2_F |
Value of square root of 2 |
M_SQRT1_2_F |
Value of 1 / (square root of 2) |
If double precision is supported by the device, the following macros and
constants are also available. They are of type
double and are accurate
within the precision of the
double type.
Constant Name |
Description |
M_E |
Value of e |
M_LOG2E |
Value of log<sub>2</sub>e |
M_LOG10E |
Value of log<sub>10</sub>e |
M_LN2 |
Value of log<sub>e</sub>2 |
M_LN10 |
Value of log<sub>e</sub>10 |
M_PI |
Value of pi |
M_PI_2 |
Value of pi / 2 |
M_PI_4 |
Value of pi / 4 |
M_1_PI |
Value of 1 / pi |
M_2_PI |
Value of 2 / pi |
M_2_SQRTPI |
Value of 2 / (square root of pi) |
M_SQRT2 |
Value of square root of 2 |
M_SQRT1_2 |
Value of 1 / (square root of 2) |
The following constants are also available. They are of type
half and are
accurate within the precision of the
half type. An application that
wants to use
half and
halfn types will need to
include the #pragma OPENCL EXTENSION
cl_khr_fp16(3clc) : enable
directive.
Constant |
Description |
M_E_H |
Value of e |
M_LOG2E_H |
Value of log<sub>2</sub>e |
M_LOG10E_H |
Value of log<sub>10</sub>e |
M_LN2_H |
Value of log<sub>e</sub>2 |
M_LN10_H |
Value of log<sub>e</sub>10 |
M_PI_H |
Value of pi |
M_PI_2_H |
Value of pi / 2 |
M_PI_4_H |
Value of pi / 4 |
M_1_PI_H |
Value of 1 / pi |
M_2_PI_H |
Value of 2 / pi |
M_2_SQRTPI_H |
Value of 2 / (square root of pi) |
M_SQRT2_H |
Value of square root of 2 |
M_SQRT1_2_H |
Value of 1 / (square root of 2) |
SPECIFICATION¶
OpenCL Specification[1]
SEE ALSO¶
mathFunctions(3clc),
FP_CONTRACT(3clc),
macroLimits(3clc)
AUTHORS¶
The Khronos Group
COPYRIGHT¶
Copyright © 2007-2011 The Khronos Group Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and/or associated documentation files (the
"Materials"), to deal in the Materials without restriction,
including without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Materials, and to permit
persons to whom the Materials are furnished to do so, subject to the condition
that this copyright notice and permission notice shall be included in all
copies or substantial portions of the Materials.
NOTES¶
- 1.
- OpenCL Specification
page 251, section 6.12.2 - Table at end of Math
Functions