CUDA MATH API

vRelease Version | July 2019

API Reference Manual

 TABLE OF CONTENTS

Chapter 1. Modules.............................................................................................. 1
1.1. Half Precision Intrinsics..................................................................................2
Half Arithmetic Functions.................................................................................. 2
Half2 Arithmetic Functions................................................................................ 2
Half Comparison Functions.................................................................................2
Half2 Comparison Functions............................................................................... 2
Half Precision Conversion And Data Movement.........................................................2
Half Math Functions......................................................................................... 2
Half2 Math Functions....................................................................................... 2
1.1.1. Half Arithmetic Functions..........................................................................2
__habs...................................................................................................... 2
__hadd...................................................................................................... 3
__hadd_sat................................................................................................. 3
__hdiv....................................................................................................... 3
__hfma...................................................................................................... 4
__hfma_relu................................................................................................4
__hfma_sat................................................................................................. 4
__hmul...................................................................................................... 5
__hmul_sat................................................................................................. 5
__hneg...................................................................................................... 6
__hsub...................................................................................................... 6
__hsub_sat................................................................................................. 6
1.1.2. Half2 Arithmetic Functions........................................................................ 6
__h2div..................................................................................................... 7
__habs2..................................................................................................... 7
__hadd2.....................................................................................................7
__hadd2_sat................................................................................................7
__hfma2.................................................................................................... 8
__hfma2_relu.............................................................................................. 8
__hfma2_sat............................................................................................... 9
__hmul2.....................................................................................................9
__hmul2_sat.............................................................................................. 10
__hneg2................................................................................................... 10
__hsub2....................................................................................................10
__hsub2_sat...............................................................................................10
1.1.3. Half Comparison Functions....................................................................... 11
__heq...................................................................................................... 11
__hequ.....................................................................................................12
__hge...................................................................................................... 12
__hgeu.....................................................................................................13

[Link]
CUDA Math API vRelease Version | ii
 __hgt.......................................................................................................13
__hgtu..................................................................................................... 14
__hisinf.................................................................................................... 14
__hisnan................................................................................................... 15
__hle....................................................................................................... 15
__hleu..................................................................................................... 16
__hlt....................................................................................................... 16
__hltu......................................................................................................17
__hmax.................................................................................................... 17
__hmax_nan.............................................................................................. 17
__hmin.....................................................................................................18
__hmin_nan...............................................................................................18
__hne...................................................................................................... 18
__hneu.....................................................................................................19
1.1.4. Half2 Comparison Functions......................................................................19
__hbeq2................................................................................................... 19
__hbequ2..................................................................................................20
__hbge2................................................................................................... 20
__hbgeu2.................................................................................................. 21
__hbgt2....................................................................................................21
__hbgtu2.................................................................................................. 22
__hble2.................................................................................................... 23
__hbleu2.................................................................................................. 23
__hblt2.................................................................................................... 24
__hbltu2................................................................................................... 24
__hbne2................................................................................................... 25
__hbneu2..................................................................................................25
__heq2.....................................................................................................26
__hequ2................................................................................................... 26
__hge2..................................................................................................... 27
__hgeu2................................................................................................... 27
__hgt2..................................................................................................... 28
__hgtu2....................................................................................................28
__hisnan2................................................................................................. 29
__hle2..................................................................................................... 29
__hleu2.................................................................................................... 30
__hlt2...................................................................................................... 30
__hltu2.................................................................................................... 31
__hmax2...................................................................................................31
__hmax2_nan............................................................................................. 31
__hmin2................................................................................................... 32
__hmin2_nan............................................................................................. 32
__hne2.....................................................................................................32

[Link]
CUDA Math API vRelease Version | iii
 __hneu2................................................................................................... 33
1.1.5. Half Precision Conversion And Data Movement............................................... 33
__double2half............................................................................................ 33
__float22half2_rn........................................................................................ 34
__float2half...............................................................................................34
__float2half2_rn......................................................................................... 35
__float2half_rd...........................................................................................35
__float2half_rn...........................................................................................36
__float2half_ru...........................................................................................36
__float2half_rz........................................................................................... 37
__floats2half2_rn........................................................................................ 37
__half22float2............................................................................................ 38
__half2float...............................................................................................38
__half2half2.............................................................................................. 38
__half2int_rd............................................................................................. 39
__half2int_rn............................................................................................. 39
__half2int_ru............................................................................................. 40
__half2int_rz............................................................................................. 40
__half2ll_rd............................................................................................... 41
__half2ll_rn............................................................................................... 41
__half2ll_ru............................................................................................... 42
__half2ll_rz............................................................................................... 42
__half2short_rd.......................................................................................... 43
__half2short_rn.......................................................................................... 43
__half2short_ru.......................................................................................... 44
__half2short_rz.......................................................................................... 44
__half2uint_rd............................................................................................45
__half2uint_rn............................................................................................45
__half2uint_ru............................................................................................46
__half2uint_rz............................................................................................ 46
__half2ull_rd............................................................................................. 47
__half2ull_rn............................................................................................. 47
__half2ull_ru............................................................................................. 48
__half2ull_rz..............................................................................................48
__half2ushort_rd.........................................................................................49
__half2ushort_rn......................................................................................... 49
__half2ushort_ru......................................................................................... 50
__half2ushort_rz......................................................................................... 50
__half_as_short.......................................................................................... 51
__half_as_ushort......................................................................................... 51
__halves2half2........................................................................................... 51
__high2float.............................................................................................. 52
__high2half............................................................................................... 52

[Link]
CUDA Math API vRelease Version | iv
 __high2half2.............................................................................................. 53
__highs2half2............................................................................................. 53
__int2half_rd............................................................................................. 54
__int2half_rn............................................................................................. 54
__int2half_ru............................................................................................. 55
__int2half_rz............................................................................................. 55
__ldca..................................................................................................... 56
__ldca..................................................................................................... 56
__ldcg......................................................................................................56
__ldcg......................................................................................................56
__ldcs...................................................................................................... 57
__ldcs...................................................................................................... 57
__ldcv......................................................................................................57
__ldcv......................................................................................................57
__ldg....................................................................................................... 58
__ldg....................................................................................................... 58
__ldlu...................................................................................................... 58
__ldlu...................................................................................................... 58
__ll2half_rd............................................................................................... 59
__ll2half_rn............................................................................................... 59
__ll2half_ru............................................................................................... 60
__ll2half_rz............................................................................................... 60
__low2float............................................................................................... 61
__low2half................................................................................................ 61
__low2half2...............................................................................................61
__lowhigh2highlow...................................................................................... 62
__lows2half2..............................................................................................62
__shfl_down_sync........................................................................................63
__shfl_down_sync........................................................................................64
__shfl_sync............................................................................................... 64
__shfl_sync............................................................................................... 65
__shfl_up_sync........................................................................................... 66
__shfl_up_sync........................................................................................... 66
__shfl_xor_sync.......................................................................................... 67
__shfl_xor_sync.......................................................................................... 68
__short2half_rd.......................................................................................... 69
__short2half_rn.......................................................................................... 69
__short2half_ru.......................................................................................... 70
__short2half_rz.......................................................................................... 70
__short_as_half.......................................................................................... 71
__stcg......................................................................................................71
__stcg......................................................................................................71
__stcs...................................................................................................... 72

[Link]
CUDA Math API vRelease Version | v
 __stcs...................................................................................................... 72
__stwb..................................................................................................... 72
__stwb..................................................................................................... 72
__stwt..................................................................................................... 73
__stwt..................................................................................................... 73
__uint2half_rd............................................................................................73
__uint2half_rn............................................................................................74
__uint2half_ru............................................................................................74
__uint2half_rz............................................................................................ 75
__ull2half_rd............................................................................................. 75
__ull2half_rn............................................................................................. 76
__ull2half_ru............................................................................................. 76
__ull2half_rz..............................................................................................77
__ushort2half_rd.........................................................................................77
__ushort2half_rn......................................................................................... 78
__ushort2half_ru......................................................................................... 78
__ushort2half_rz......................................................................................... 79
__ushort_as_half......................................................................................... 79
1.1.6. Half Math Functions............................................................................... 79
hceil........................................................................................................80
hcos........................................................................................................ 80
hexp........................................................................................................80
hexp10.....................................................................................................81
hexp2...................................................................................................... 81
hfloor...................................................................................................... 82
hlog........................................................................................................ 82
hlog10..................................................................................................... 82
hlog2....................................................................................................... 83
hrcp........................................................................................................ 83
hrint........................................................................................................84
hrsqrt...................................................................................................... 84
hsin.........................................................................................................84
hsqrt....................................................................................................... 85
htrunc......................................................................................................85
1.1.7. Half2 Math Functions..............................................................................86
h2ceil...................................................................................................... 86
h2cos.......................................................................................................86
h2exp...................................................................................................... 87
h2exp10................................................................................................... 87
h2exp2.....................................................................................................87
h2floor.....................................................................................................88
h2log....................................................................................................... 88
h2log10.................................................................................................... 89

[Link]
CUDA Math API vRelease Version | vi
 h2log2..................................................................................................... 89
h2rcp.......................................................................................................90
h2rint...................................................................................................... 90
h2rsqrt.....................................................................................................90
h2sin....................................................................................................... 91
h2sqrt...................................................................................................... 91
h2trunc.................................................................................................... 92
1.2. Bfloat16 Precision Intrinsics........................................................................... 92
Bfloat16 Arithmetic Functions........................................................................... 92
Bfloat162 Arithmetic Functions.......................................................................... 92
Bfloat16 Comparison Functions.......................................................................... 92
Bfloat162 Comparison Functions.........................................................................92
Bfloat16 Precision Conversion And Data Movement.................................................. 92
Bfloat16 Math Functions.................................................................................. 92
Bfloat162 Math Functions................................................................................. 93
1.2.1. Bfloat16 Arithmetic Functions................................................................... 93
__h2div.................................................................................................... 93
__habs..................................................................................................... 93
__hadd.....................................................................................................93
__hadd_sat................................................................................................94
__hdiv..................................................................................................... 94
__hfma.................................................................................................... 94
__hfma_relu.............................................................................................. 95
__hfma_sat............................................................................................... 95
__hmul.....................................................................................................96
__hmul_sat................................................................................................96
__hneg.....................................................................................................96
__hsub..................................................................................................... 97
__hsub_sat................................................................................................ 97
1.2.2. Bfloat162 Arithmetic Functions..................................................................97
__habs2....................................................................................................97
__hadd2................................................................................................... 98
__hadd2_sat.............................................................................................. 98
__hfma2................................................................................................... 99
__hfma2_relu.............................................................................................99
__hfma2_sat.............................................................................................100
__hmul2..................................................................................................100
__hmul2_sat.............................................................................................101
__hneg2.................................................................................................. 101
__hsub2.................................................................................................. 101
__hsub2_sat............................................................................................. 102
1.2.3. Bfloat16 Comparison Functions................................................................ 102
__heq.....................................................................................................102

[Link]
CUDA Math API vRelease Version | vii
 __hequ................................................................................................... 103
__hge..................................................................................................... 103
__hgeu................................................................................................... 104
__hgt..................................................................................................... 104
__hgtu....................................................................................................105
__hisinf...................................................................................................105
__hisnan................................................................................................. 106
__hle..................................................................................................... 106
__hleu.................................................................................................... 107
__hlt...................................................................................................... 107
__hltu.................................................................................................... 108
__hmax...................................................................................................108
__hmax_nan............................................................................................. 109
__hmin................................................................................................... 109
__hmin_nan............................................................................................. 109
__hne.....................................................................................................109
__hneu................................................................................................... 110
1.2.4. Bfloat162 Comparison Functions............................................................... 110
__hbeq2..................................................................................................111
__hbequ2................................................................................................ 111
__hbge2.................................................................................................. 112
__hbgeu2................................................................................................ 112
__hbgt2.................................................................................................. 113
__hbgtu2................................................................................................. 114
__hble2.................................................................................................. 114
__hbleu2................................................................................................. 115
__hblt2................................................................................................... 115
__hbltu2................................................................................................. 116
__hbne2..................................................................................................117
__hbneu2................................................................................................ 117
__heq2................................................................................................... 118
__hequ2..................................................................................................118
__hge2................................................................................................... 119
__hgeu2.................................................................................................. 119
__hgt2.................................................................................................... 120
__hgtu2.................................................................................................. 121
__hisnan2................................................................................................ 121
__hle2.................................................................................................... 122
__hleu2.................................................................................................. 122
__hlt2.................................................................................................... 123
__hltu2................................................................................................... 123
__hmax2................................................................................................. 124
__hmax2_nan........................................................................................... 124

[Link]
CUDA Math API vRelease Version | viii
 __hmin2..................................................................................................124
__hmin2_nan............................................................................................ 125
__hne2................................................................................................... 125
__hneu2.................................................................................................. 125
1.2.5. Bfloat16 Precision Conversion And Data Movement.........................................126
__bfloat1622float2..................................................................................... 126
__bfloat162bfloat162.................................................................................. 127
__bfloat162float........................................................................................ 127
__bfloat162int_rd...................................................................................... 128
__bfloat162int_rn...................................................................................... 128
__bfloat162int_ru...................................................................................... 129
__bfloat162int_rz...................................................................................... 129
__bfloat162ll_rd........................................................................................ 130
__bfloat162ll_rn........................................................................................ 130
__bfloat162ll_ru........................................................................................ 131
__bfloat162ll_rz........................................................................................ 131
__bfloat162short_rd................................................................................... 132
__bfloat162short_rn................................................................................... 132
__bfloat162short_ru................................................................................... 133
__bfloat162short_rz....................................................................................133
__bfloat162uint_rd.....................................................................................134
__bfloat162uint_rn..................................................................................... 134
__bfloat162uint_ru..................................................................................... 135
__bfloat162uint_rz..................................................................................... 135
__bfloat162ull_rd...................................................................................... 136
__bfloat162ull_rn.......................................................................................136
__bfloat162ull_ru.......................................................................................137
__bfloat162ull_rz.......................................................................................137
__bfloat162ushort_rd.................................................................................. 138
__bfloat162ushort_rn.................................................................................. 138
__bfloat162ushort_ru.................................................................................. 139
__bfloat162ushort_rz.................................................................................. 139
__bfloat16_as_short................................................................................... 140
__bfloat16_as_ushort.................................................................................. 140
__double2bfloat16..................................................................................... 141
__float22bfloat162_rn................................................................................. 141
__float2bfloat16........................................................................................ 142
__float2bfloat162_rn.................................................................................. 142
__float2bfloat16_rd.................................................................................... 143
__float2bfloat16_rn.................................................................................... 143
__float2bfloat16_ru.................................................................................... 144
__float2bfloat16_rz.................................................................................... 144
__floats2bfloat162_rn................................................................................. 145

[Link]
CUDA Math API vRelease Version | ix
 __halves2bfloat162.....................................................................................145
__high2bfloat16........................................................................................ 146
__high2bfloat162....................................................................................... 146
__high2float............................................................................................. 147
__highs2bfloat162...................................................................................... 147
__int2bfloat16_rd...................................................................................... 148
__int2bfloat16_rn...................................................................................... 148
__int2bfloat16_ru...................................................................................... 149
__int2bfloat16_rz...................................................................................... 149
__ldca.................................................................................................... 150
__ldca.................................................................................................... 150
__ldcg.................................................................................................... 150
__ldcg.................................................................................................... 150
__ldcs.................................................................................................... 151
__ldcs.................................................................................................... 151
__ldcv.................................................................................................... 151
__ldcv.................................................................................................... 151
__ldg..................................................................................................... 152
__ldg..................................................................................................... 152
__ldlu.....................................................................................................152
__ldlu.....................................................................................................152
__ll2bfloat16_rd........................................................................................ 153
__ll2bfloat16_rn........................................................................................ 153
__ll2bfloat16_ru........................................................................................ 154
__ll2bfloat16_rz........................................................................................ 154
__low2bfloat16......................................................................................... 155
__low2bfloat162........................................................................................ 155
__low2float..............................................................................................156
__lowhigh2highlow..................................................................................... 156
__lows2bfloat162.......................................................................................157
__shfl_down_sync...................................................................................... 157
__shfl_down_sync...................................................................................... 158
__shfl_sync.............................................................................................. 159
__shfl_sync.............................................................................................. 159
__shfl_up_sync..........................................................................................160
__shfl_up_sync..........................................................................................161
__shfl_xor_sync.........................................................................................161
__shfl_xor_sync.........................................................................................162
__short2bfloat16_rd................................................................................... 163
__short2bfloat16_rn................................................................................... 163
__short2bfloat16_ru................................................................................... 164
__short2bfloat16_rz....................................................................................164
__short_as_bfloat16................................................................................... 165

[Link]
CUDA Math API vRelease Version | x
 __stcg.................................................................................................... 165
__stcg.................................................................................................... 165
__stcs.....................................................................................................166
__stcs.....................................................................................................166
__stwb................................................................................................... 166
__stwb................................................................................................... 166
__stwt.................................................................................................... 167
__stwt.................................................................................................... 167
__uint2bfloat16_rd.....................................................................................167
__uint2bfloat16_rn..................................................................................... 168
__uint2bfloat16_ru..................................................................................... 168
__uint2bfloat16_rz..................................................................................... 169
__ull2bfloat16_rd...................................................................................... 169
__ull2bfloat16_rn.......................................................................................170
__ull2bfloat16_ru.......................................................................................170
__ull2bfloat16_rz.......................................................................................171
__ushort2bfloat16_rd.................................................................................. 171
__ushort2bfloat16_rn.................................................................................. 172
__ushort2bfloat16_ru.................................................................................. 172
__ushort2bfloat16_rz.................................................................................. 173
__ushort_as_bfloat16.................................................................................. 173
1.2.6. Bfloat16 Math Functions.........................................................................173
hceil...................................................................................................... 174
hcos.......................................................................................................174
hexp...................................................................................................... 174
hexp10................................................................................................... 175
hexp2.....................................................................................................175
hfloor.....................................................................................................176
hlog....................................................................................................... 176
hlog10.................................................................................................... 177
hlog2..................................................................................................... 177
hrcp.......................................................................................................177
hrint...................................................................................................... 178
hrsqrt.....................................................................................................178
hsin....................................................................................................... 179
hsqrt...................................................................................................... 179
htrunc.................................................................................................... 180
1.2.7. Bfloat162 Math Functions....................................................................... 180
h2ceil.....................................................................................................180
h2cos..................................................................................................... 181
h2exp.....................................................................................................181
h2exp10.................................................................................................. 182
h2exp2................................................................................................... 182

[Link]
CUDA Math API vRelease Version | xi
 h2floor................................................................................................... 183
h2log..................................................................................................... 183
h2log10...................................................................................................184
h2log2.................................................................................................... 184
h2rcp..................................................................................................... 184
h2rint.....................................................................................................185
h2rsqrt................................................................................................... 185
h2sin......................................................................................................186
h2sqrt.................................................................................................... 186
h2trunc...................................................................................................187
1.3. Mathematical Functions...............................................................................187
1.4. Single Precision Mathematical Functions...........................................................187
acosf.........................................................................................................187
acoshf....................................................................................................... 188
asinf......................................................................................................... 188
asinhf........................................................................................................189
atan2f....................................................................................................... 189
atanf.........................................................................................................189
atanhf....................................................................................................... 190
cbrtf......................................................................................................... 190
ceilf..........................................................................................................191
copysignf....................................................................................................191
cosf.......................................................................................................... 191
coshf.........................................................................................................192
cospif........................................................................................................192
cyl_bessel_i0f.............................................................................................. 192
cyl_bessel_i1f.............................................................................................. 193
erfcf......................................................................................................... 193
erfcinvf..................................................................................................... 193
erfcxf........................................................................................................194
erff.......................................................................................................... 194
erfinvf....................................................................................................... 195
exp10f.......................................................................................................195
exp2f........................................................................................................ 196
expf..........................................................................................................196
expm1f...................................................................................................... 196
fabsf......................................................................................................... 197
fdimf........................................................................................................ 197
fdividef......................................................................................................198
floorf........................................................................................................ 198
fmaf......................................................................................................... 198
fmaxf........................................................................................................ 199
fminf........................................................................................................ 199

[Link]
CUDA Math API vRelease Version | xii
 fmodf........................................................................................................200
frexpf........................................................................................................200
hypotf....................................................................................................... 201
ilogbf........................................................................................................ 201
isfinite...................................................................................................... 202
isinf.......................................................................................................... 202
isnan.........................................................................................................202
j0f............................................................................................................203
j1f............................................................................................................203
jnf........................................................................................................... 204
ldexpf....................................................................................................... 204
lgammaf.................................................................................................... 205
llrintf........................................................................................................ 205
llroundf..................................................................................................... 205
log10f....................................................................................................... 206
log1pf....................................................................................................... 206
log2f......................................................................................................... 207
logbf......................................................................................................... 207
logf.......................................................................................................... 207
lrintf.........................................................................................................208
lroundf...................................................................................................... 208
modff........................................................................................................208
nanf..........................................................................................................209
nearbyintf.................................................................................................. 209
nextafterf.................................................................................................. 210
norm3df.....................................................................................................210
norm4df.....................................................................................................210
normcdff.................................................................................................... 211
normcdfinvf................................................................................................ 211
normf........................................................................................................212
powf......................................................................................................... 212
rcbrtf........................................................................................................ 213
remainderf................................................................................................. 213
remquof.....................................................................................................214
rhypotf...................................................................................................... 214
rintf..........................................................................................................215
rnorm3df....................................................................................................215
rnorm4df....................................................................................................215
rnormf.......................................................................................................216
roundf....................................................................................................... 216
rsqrtf........................................................................................................ 217
scalblnf..................................................................................................... 217
scalbnf...................................................................................................... 217

[Link]
CUDA Math API vRelease Version | xiii
 signbit....................................................................................................... 218
sincosf.......................................................................................................218
sincospif.................................................................................................... 219
sinf...........................................................................................................219
sinhf......................................................................................................... 220
sinpif........................................................................................................ 220
sqrtf......................................................................................................... 220
tanf.......................................................................................................... 221
tanhf........................................................................................................ 221
tgammaf.................................................................................................... 222
truncf........................................................................................................222
y0f........................................................................................................... 222
y1f........................................................................................................... 223
ynf........................................................................................................... 223
1.5. Double Precision Mathematical Functions......................................................... 224
acos..........................................................................................................224
acosh........................................................................................................ 224
asin.......................................................................................................... 225
asinh.........................................................................................................225
atan..........................................................................................................226
atan2........................................................................................................ 226
atanh........................................................................................................ 226
cbrt.......................................................................................................... 227
ceil...........................................................................................................227
copysign.....................................................................................................228
cos........................................................................................................... 228
cosh..........................................................................................................228
cospi.........................................................................................................229
cyl_bessel_i0............................................................................................... 229
cyl_bessel_i1............................................................................................... 229
erf........................................................................................................... 230
erfc.......................................................................................................... 230
erfcinv...................................................................................................... 231
erfcx.........................................................................................................231
erfinv........................................................................................................ 231
exp...........................................................................................................232
exp10........................................................................................................232
exp2......................................................................................................... 233
expm1....................................................................................................... 233
fabs.......................................................................................................... 233
fdim......................................................................................................... 234
floor......................................................................................................... 234
fma.......................................................................................................... 235

[Link]
CUDA Math API vRelease Version | xiv
 fmax......................................................................................................... 235
fmin......................................................................................................... 236
fmod.........................................................................................................236
frexp.........................................................................................................237
hypot........................................................................................................ 237
ilogb......................................................................................................... 238
isfinite...................................................................................................... 238
isinf.......................................................................................................... 238
isnan.........................................................................................................239
j0.............................................................................................................239
j1.............................................................................................................239
jn............................................................................................................ 240
ldexp........................................................................................................ 240
lgamma..................................................................................................... 241
llrint......................................................................................................... 241
llround...................................................................................................... 242
log........................................................................................................... 242
log10........................................................................................................ 242
log1p........................................................................................................ 243
log2.......................................................................................................... 243
logb.......................................................................................................... 244
lrint..........................................................................................................244
lround....................................................................................................... 244
modf.........................................................................................................245
nan...........................................................................................................245
nearbyint................................................................................................... 245
nextafter................................................................................................... 246
norm.........................................................................................................246
norm3d......................................................................................................247
norm4d......................................................................................................247
normcdf..................................................................................................... 247
normcdfinv................................................................................................. 248
pow.......................................................................................................... 248
rcbrt......................................................................................................... 249
remainder.................................................................................................. 249
remquo......................................................................................................250
rhypot....................................................................................................... 250
rint...........................................................................................................251
rnorm........................................................................................................251
rnorm3d.....................................................................................................252
rnorm4d.....................................................................................................252
round........................................................................................................ 253
rsqrt......................................................................................................... 253

[Link]
CUDA Math API vRelease Version | xv
 scalbln...................................................................................................... 253
scalbn....................................................................................................... 254
signbit....................................................................................................... 254
sin............................................................................................................254
sincos........................................................................................................255
sincospi..................................................................................................... 255
sinh.......................................................................................................... 256
sinpi......................................................................................................... 256
sqrt.......................................................................................................... 256
tan........................................................................................................... 257
tanh......................................................................................................... 257
tgamma..................................................................................................... 258
trunc.........................................................................................................258
y0............................................................................................................ 258
y1............................................................................................................ 259
yn............................................................................................................ 259
1.6. Single Precision Intrinsics.............................................................................260
__cosf....................................................................................................... 260
__exp10f.................................................................................................... 260
__expf.......................................................................................................261
__fadd_rd...................................................................................................261
__fadd_rn...................................................................................................262
__fadd_ru...................................................................................................262
__fadd_rz................................................................................................... 262
__fdiv_rd................................................................................................... 263
__fdiv_rn....................................................................................................263
__fdiv_ru....................................................................................................263
__fdiv_rz....................................................................................................264
__fdividef...................................................................................................264
__fmaf_rd.................................................................................................. 265
__fmaf_rn.................................................................................................. 265
__fmaf_ru.................................................................................................. 266
__fmaf_rz...................................................................................................266
__fmul_rd...................................................................................................267
__fmul_rn...................................................................................................267
__fmul_ru...................................................................................................267
__fmul_rz................................................................................................... 268
__frcp_rd................................................................................................... 268
__frcp_rn................................................................................................... 268
__frcp_ru................................................................................................... 269
__frcp_rz................................................................................................... 269
__frsqrt_rn................................................................................................. 270
__fsqrt_rd.................................................................................................. 270

[Link]
CUDA Math API vRelease Version | xvi
 __fsqrt_rn.................................................................................................. 270
__fsqrt_ru.................................................................................................. 271
__fsqrt_rz...................................................................................................271
__fsub_rd................................................................................................... 271
__fsub_rn................................................................................................... 272
__fsub_ru................................................................................................... 272
__fsub_rz................................................................................................... 273
__log10f.....................................................................................................273
__log2f...................................................................................................... 273
__logf....................................................................................................... 274
__powf...................................................................................................... 274
__saturatef................................................................................................. 275
__sincosf.................................................................................................... 275
__sinf........................................................................................................275
__tanf....................................................................................................... 276
1.7. Double Precision Intrinsics........................................................................... 276
__dadd_rd.................................................................................................. 276
__dadd_rn.................................................................................................. 277
__dadd_ru.................................................................................................. 277
__dadd_rz.................................................................................................. 277
__ddiv_rd................................................................................................... 278
__ddiv_rn................................................................................................... 278
__ddiv_ru................................................................................................... 278
__ddiv_rz................................................................................................... 279
__dmul_rd.................................................................................................. 279
__dmul_rn.................................................................................................. 280
__dmul_ru.................................................................................................. 280
__dmul_rz.................................................................................................. 280
__drcp_rd...................................................................................................281
__drcp_rn...................................................................................................281
__drcp_ru...................................................................................................282
__drcp_rz................................................................................................... 282
__dsqrt_rd.................................................................................................. 282
__dsqrt_rn.................................................................................................. 283
__dsqrt_ru.................................................................................................. 283
__dsqrt_rz.................................................................................................. 284
__dsub_rd.................................................................................................. 284
__dsub_rn...................................................................................................284
__dsub_ru...................................................................................................285
__dsub_rz...................................................................................................285
__fma_rd................................................................................................... 286
__fma_rn................................................................................................... 286
__fma_ru................................................................................................... 287

[Link]
CUDA Math API vRelease Version | xvii
 __fma_rz....................................................................................................287
1.8. Integer Intrinsics....................................................................................... 288
__brev.......................................................................................................288
__brevll..................................................................................................... 288
__byte_perm............................................................................................... 288
__clz.........................................................................................................289
__clzll....................................................................................................... 289
__ffs......................................................................................................... 289
__ffsll....................................................................................................... 290
__funnelshift_l.............................................................................................290
__funnelshift_lc........................................................................................... 290
__funnelshift_r............................................................................................ 291
__funnelshift_rc........................................................................................... 291
__hadd...................................................................................................... 291
__mul24.....................................................................................................292
__mul64hi.................................................................................................. 292
__mulhi..................................................................................................... 292
__popc...................................................................................................... 293
__popcll.....................................................................................................293
__rhadd..................................................................................................... 293
__sad........................................................................................................ 293
__uhadd.....................................................................................................294
__umul24................................................................................................... 294
__umul64hi................................................................................................. 294
__umulhi.................................................................................................... 295
__urhadd....................................................................................................295
__usad.......................................................................................................295
1.9. Type Casting Intrinsics................................................................................ 296
__double2float_rd.........................................................................................296
__double2float_rn.........................................................................................296
__double2float_ru.........................................................................................296
__double2float_rz......................................................................................... 297
__double2hiint............................................................................................. 297
__double2int_rd........................................................................................... 297
__double2int_rn........................................................................................... 297
__double2int_ru........................................................................................... 298
__double2int_rz........................................................................................... 298
__double2ll_rd............................................................................................. 298
__double2ll_rn............................................................................................. 299
__double2ll_ru............................................................................................. 299
__double2ll_rz............................................................................................. 299
__double2loint............................................................................................. 299
__double2uint_rd..........................................................................................300

[Link]
CUDA Math API vRelease Version | xviii
 __double2uint_rn..........................................................................................300
__double2uint_ru..........................................................................................300
__double2uint_rz.......................................................................................... 301
__double2ull_rd........................................................................................... 301
__double2ull_rn........................................................................................... 301
__double2ull_ru........................................................................................... 302
__double2ull_rz............................................................................................302
__double_as_longlong.................................................................................... 302
__float2int_rd..............................................................................................303
__float2int_rn..............................................................................................303
__float2int_ru..............................................................................................303
__float2int_rz.............................................................................................. 303
__float2ll_rd............................................................................................... 304
__float2ll_rn............................................................................................... 304
__float2ll_ru............................................................................................... 304
__float2ll_rz................................................................................................305
__float2uint_rd............................................................................................ 305
__float2uint_rn............................................................................................ 305
__float2uint_ru............................................................................................ 305
__float2uint_rz............................................................................................ 306
__float2ull_rd.............................................................................................. 306
__float2ull_rn.............................................................................................. 306
__float2ull_ru.............................................................................................. 307
__float2ull_rz.............................................................................................. 307
__float_as_int..............................................................................................307
__float_as_uint............................................................................................ 307
__hiloint2double...........................................................................................308
__int2double_rn........................................................................................... 308
__int2float_rd..............................................................................................308
__int2float_rn..............................................................................................308
__int2float_ru..............................................................................................309
__int2float_rz.............................................................................................. 309
__int_as_float..............................................................................................309
__ll2double_rd............................................................................................. 310
__ll2double_rn............................................................................................. 310
__ll2double_ru............................................................................................. 310
__ll2double_rz............................................................................................. 310
__ll2float_rd............................................................................................... 311
__ll2float_rn............................................................................................... 311
__ll2float_ru............................................................................................... 311
__ll2float_rz................................................................................................312
__longlong_as_double.................................................................................... 312
__uint2double_rn..........................................................................................312

[Link]
CUDA Math API vRelease Version | xix
 __uint2float_rd............................................................................................ 312
__uint2float_rn............................................................................................ 313
__uint2float_ru............................................................................................ 313
__uint2float_rz............................................................................................ 313
__uint_as_float............................................................................................ 314
__ull2double_rd........................................................................................... 314
__ull2double_rn........................................................................................... 314
__ull2double_ru........................................................................................... 315
__ull2double_rz............................................................................................315
__ull2float_rd.............................................................................................. 315
__ull2float_rn.............................................................................................. 316
__ull2float_ru.............................................................................................. 316
__ull2float_rz.............................................................................................. 316
1.10. SIMD Intrinsics.........................................................................................317
__vabs2..................................................................................................... 317
__vabs4..................................................................................................... 317
__vabsdiffs2................................................................................................ 317
__vabsdiffs4................................................................................................ 318
__vabsdiffu2................................................................................................318
__vabsdiffu4................................................................................................318
__vabsss2................................................................................................... 319
__vabsss4................................................................................................... 319
__vadd2..................................................................................................... 319
__vadd4..................................................................................................... 320
__vaddss2...................................................................................................320
__vaddss4...................................................................................................320
__vaddus2.................................................................................................. 321
__vaddus4.................................................................................................. 321
__vavgs2.................................................................................................... 321
__vavgs4.................................................................................................... 322
__vavgu2....................................................................................................322
__vavgu4....................................................................................................322
__vcmpeq2................................................................................................. 323
__vcmpeq4................................................................................................. 323
__vcmpges2................................................................................................ 323
__vcmpges4................................................................................................ 324
__vcmpgeu2................................................................................................ 324
__vcmpgeu4................................................................................................ 324
__vcmpgts2.................................................................................................325
__vcmpgts4.................................................................................................325
__vcmpgtu2................................................................................................ 325
__vcmpgtu4................................................................................................ 326
__vcmples2................................................................................................. 326

[Link]
CUDA Math API vRelease Version | xx
 __vcmples4................................................................................................. 326
__vcmpleu2................................................................................................ 327
__vcmpleu4................................................................................................ 327
__vcmplts2................................................................................................. 327
__vcmplts4................................................................................................. 328
__vcmpltu2................................................................................................. 328
__vcmpltu4................................................................................................. 328
__vcmpne2................................................................................................. 329
__vcmpne4................................................................................................. 329
__vhaddu2.................................................................................................. 329
__vhaddu4.................................................................................................. 330
__vmaxs2................................................................................................... 330
__vmaxs4................................................................................................... 330
__vmaxu2................................................................................................... 331
__vmaxu4................................................................................................... 331
__vmins2....................................................................................................331
__vmins4....................................................................................................332
__vminu2................................................................................................... 332
__vminu4................................................................................................... 332
__vneg2..................................................................................................... 333
__vneg4..................................................................................................... 333
__vnegss2................................................................................................... 333
__vnegss4................................................................................................... 333
__vsads2.................................................................................................... 334
__vsads4.................................................................................................... 334
__vsadu2.................................................................................................... 334
__vsadu4.................................................................................................... 335
__vseteq2...................................................................................................335
__vseteq4...................................................................................................335
__vsetges2..................................................................................................336
__vsetges4..................................................................................................336
__vsetgeu2................................................................................................. 336
__vsetgeu4................................................................................................. 337
__vsetgts2.................................................................................................. 337
__vsetgts4.................................................................................................. 337
__vsetgtu2..................................................................................................338
__vsetgtu4..................................................................................................338
__vsetles2.................................................................................................. 338
__vsetles4.................................................................................................. 339
__vsetleu2.................................................................................................. 339
__vsetleu4.................................................................................................. 339
__vsetlts2...................................................................................................340
__vsetlts4...................................................................................................340

[Link]
CUDA Math API vRelease Version | xxi
 __vsetltu2.................................................................................................. 340
__vsetltu4.................................................................................................. 341
__vsetne2...................................................................................................341
__vsetne4...................................................................................................341
__vsub2..................................................................................................... 342
__vsub4..................................................................................................... 342
__vsubss2................................................................................................... 342
__vsubss4................................................................................................... 343
__vsubus2...................................................................................................343
__vsubus4...................................................................................................343

[Link]
CUDA Math API vRelease Version | xxii
Chapter 1.
MODULES

Here is a list of all modules:

‣ Half Precision Intrinsics

‣ Half Arithmetic Functions

‣ Half2 Arithmetic Functions
‣ Half Comparison Functions
‣ Half2 Comparison Functions
‣ Half Precision Conversion And Data Movement
‣ Half Math Functions
‣ Half2 Math Functions
‣ Bfloat16 Precision Intrinsics

‣ Bfloat16 Arithmetic Functions

‣ Bfloat162 Arithmetic Functions
‣ Bfloat16 Comparison Functions
‣ Bfloat162 Comparison Functions
‣ Bfloat16 Precision Conversion And Data Movement
‣ Bfloat16 Math Functions
‣ Bfloat162 Math Functions
‣ Mathematical Functions
‣ Single Precision Mathematical Functions
‣ Double Precision Mathematical Functions
‣ Single Precision Intrinsics
‣ Double Precision Intrinsics
‣ Integer Intrinsics
‣ Type Casting Intrinsics
‣ SIMD Intrinsics

[Link]
CUDA Math API vRelease Version | 1
 Modules

1.1. Half Precision Intrinsics

This section describes half precision intrinsic functions that are only supported in device
code. To use these functions include the header file cuda_fp16.h in your program.

Half Arithmetic Functions

Half2 Arithmetic Functions

Half Comparison Functions

Half2 Comparison Functions

Half Precision Conversion And Data Movement

Half Math Functions

Half2 Math Functions

1.1.1. Half Arithmetic Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

__device__ __half __habs (const __half a)

Calculates the absolute value of input half number and returns the result.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
absolute value of a.

[Link]
CUDA Math API vRelease Version | 2
 Modules

Description
Calculates the absolute value of input half number and returns the result.

__device__ __half __hadd (const __half a, const __half b)

Performs half addition in round-to-nearest-even mode.

Description
Performs half addition of inputs a and b, in round-to-nearest-even mode.

__device__ __half __hadd_sat (const __half a, const __half b)

Performs half addition in round-to-nearest-even mode, with saturation to [0.0, 1.0].

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
half

‣ The
sum of a and b, with respect to saturation.

Description
Performs half add of inputs a and b, in round-to-nearest-even mode, and clamps the
result to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __half __hdiv (const __half a, const __half b)

Performs half division in round-to-nearest-even mode.

Description
Divides half input a by input b in round-to-nearest mode.

[Link]
CUDA Math API vRelease Version | 3
 Modules

__device__ __half __hfma (const __half a, const __half b, const

__half c)
Performs half fused multiply-add in round-to-nearest-even mode.

Description
Performs half multiply on inputs a and b, then performs a half add of the result with
c, rounding the result once in round-to-nearest-even mode.

__device__ __half __hfma_relu (const __half a, const __half b,

const __half c)
Performs half fused multiply-add in round-to-nearest-even mode with relu saturation.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.
c
- half. Is only being read.

Returns
half

‣ The
result of fused multiply-add operation on a, b, and c with relu saturation.

Description
Performs half multiply on inputs a and b, then performs a half add of the result
with c, rounding the result once in round-to-nearest-even mode. Then negative result is
clamped to 0. NaN result is converted to canonical NaN.

__device__ __half __hfma_sat (const __half a, const __half b, const

__half c)
Performs half fused multiply-add in round-to-nearest-even mode, with saturation to
[0.0, 1.0].

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 4
 Modules

b
- half. Is only being read.
c
- half. Is only being read.

Returns
half

‣ The
result of fused multiply-add operation on a, b, and c, with respect to saturation.

Description
Performs half multiply on inputs a and b, then performs a half add of the result with
c, rounding the result once in round-to-nearest-even mode, and clamps the result to
range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __half __hmul (const __half a, const __half b)

Performs half multiplication in round-to-nearest-even mode.

Description
Performs half multiplication of inputs a and b, in round-to-nearest mode.

__device__ __half __hmul_sat (const __half a, const __half b)

Performs half multiplication in round-to-nearest-even mode, with saturation to [0.0,
1.0].

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
half

‣ The
result of multiplying a and b, with respect to saturation.

Description
Performs half multiplication of inputs a and b, in round-to-nearest mode, and clamps
the result to range [0.0, 1.0]. NaN results are flushed to +0.0.

[Link]
CUDA Math API vRelease Version | 5
 Modules

__device__ __half __hneg (const __half a)

Negates input half number and returns the result.

Description
Negates input half number and returns the result.

__device__ __half __hsub (const __half a, const __half b)

Performs half subtraction in round-to-nearest-even mode.

Description
Subtracts half input b from input a in round-to-nearest mode.

__device__ __half __hsub_sat (const __half a, const __half b)

Performs half subtraction in round-to-nearest-even mode, with saturation to [0.0, 1.0].

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
half

‣ The
result of subtraction of b from a, with respect to saturation.

Description
Subtracts half input b from input a in round-to-nearest mode, and clamps the result to
range [0.0, 1.0]. NaN results are flushed to +0.0.

1.1.2. Half2 Arithmetic Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

[Link]
CUDA Math API vRelease Version | 6
 Modules

__device__ __half2 __h2div (const __half2 a, const __half2 b)

Performs half2 vector division in round-to-nearest-even mode.

Description
Divides half2 input vector a by input vector b in round-to-nearest mode.

__device__ __half2 __habs2 (const __half2 a)

Calculates the absolute value of both halves of the input half2 number and returns the
result.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ Returns
a with the absolute value of both halves.

Description
Calculates the absolute value of both halves of the input half2 number and returns the
result.

__device__ __half2 __hadd2 (const __half2 a, const __half2 b)

Performs half2 vector addition in round-to-nearest-even mode.

Description
Performs half2 vector add of inputs a and b, in round-to-nearest mode.

__device__ __half2 __hadd2_sat (const __half2 a, const __half2 b)

Performs half2 vector addition in round-to-nearest-even mode, with saturation to [0.0,
1.0].

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 7
 Modules

Returns
half2

‣ The
sum of a and b, with respect to saturation.

Description
Performs half2 vector add of inputs a and b, in round-to-nearest mode, and clamps the
results to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __half2 __hfma2 (const __half2 a, const __half2 b, const

__half2 c)
Performs half2 vector fused multiply-add in round-to-nearest-even mode.

Description
Performs half2 vector multiply on inputs a and b, then performs a half2 vector add
of the result with c, rounding the result once in round-to-nearest-even mode.

__device__ __half2 __hfma2_relu (const __half2 a, const __half2 b,

const __half2 c)
Performs half2 vector fused multiply-add in round-to-nearest-even mode with relu
saturation.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.
c
- half2. Is only being read.

Returns
half2

‣ The
result of elementwise fused multiply-add operation on vectors a, b, and c with relu
saturation.

[Link]
CUDA Math API vRelease Version | 8
 Modules

Description
Performs half2 vector multiply on inputs a and b, then performs a half2 vector add
of the result with c, rounding the result once in round-to-nearest-even mode. Then
negative result is clamped to 0. NaN result is converted to canonical NaN.

__device__ __half2 __hfma2_sat (const __half2 a, const __half2 b,

const __half2 c)
Performs half2 vector fused multiply-add in round-to-nearest-even mode, with
saturation to [0.0, 1.0].

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.
c
- half2. Is only being read.

Returns
half2

‣ The
result of elementwise fused multiply-add operation on vectors a, b, and c, with
respect to saturation.

Description
Performs half2 vector multiply on inputs a and b, then performs a half2 vector
add of the result with c, rounding the result once in round-to-nearest-even mode, and
clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __half2 __hmul2 (const __half2 a, const __half2 b)

Performs half2 vector multiplication in round-to-nearest-even mode.

Description
Performs half2 vector multiplication of inputs a and b, in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 9
 Modules

__device__ __half2 __hmul2_sat (const __half2 a, const __half2 b)

Performs half2 vector multiplication in round-to-nearest-even mode, with saturation to
[0.0, 1.0].

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
result of elementwise multiplication of vectors a and b, with respect to saturation.

Description
Performs half2 vector multiplication of inputs a and b, in round-to-nearest-even mode,
and clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __half2 __hneg2 (const __half2 a)

Negates both halves of the input half2 number and returns the result.

Description
Negates both halves of the input half2 number a and returns the result.

__device__ __half2 __hsub2 (const __half2 a, const __half2 b)

Performs half2 vector subtraction in round-to-nearest-even mode.

Description
Subtracts half2 input vector b from input vector a in round-to-nearest-even mode.

__device__ __half2 __hsub2_sat (const __half2 a, const __half2 b)

Performs half2 vector subtraction in round-to-nearest-even mode, with saturation to
[0.0, 1.0].

Parameters
a
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 10
 Modules

b
- half2. Is only being read.

Returns
half2

‣ The
subtraction of vector b from a, with respect to saturation.

Description
Subtracts half2 input vector b from input vector a in round-to-nearest-even mode, and
clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

1.1.3. Half Comparison Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

__device__ bool __heq (const __half a, const __half b)

Performs half if-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of if-equal comparison of a and b.

Description
Performs half if-equal comparison of inputs a and b. NaN inputs generate false results.

[Link]
CUDA Math API vRelease Version | 11
 Modules

__device__ bool __hequ (const __half a, const __half b)

Performs half unordered if-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered if-equal comparison of a and b.

Description
Performs half if-equal comparison of inputs a and b. NaN inputs generate true results.

__device__ bool __hge (const __half a, const __half b)

Performs half greater-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of greater-equal comparison of a and b.

Description
Performs half greater-equal comparison of inputs a and b. NaN inputs generate false
results.

[Link]
CUDA Math API vRelease Version | 12
 Modules

__device__ bool __hgeu (const __half a, const __half b)

Performs half unordered greater-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered greater-equal comparison of a and b.

Description
Performs half greater-equal comparison of inputs a and b. NaN inputs generate true
results.

__device__ bool __hgt (const __half a, const __half b)

Performs half greater-than comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of greater-than comparison of a and b.

Description
Performs half greater-than comparison of inputs a and b. NaN inputs generate false
results.

[Link]
CUDA Math API vRelease Version | 13
 Modules

__device__ bool __hgtu (const __half a, const __half b)

Performs half unordered greater-than comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered greater-than comparison of a and b.

Description
Performs half greater-than comparison of inputs a and b. NaN inputs generate true
results.

__device__ int __hisinf (const __half a)

Checks if the input half number is infinite.

Parameters
a
- half. Is only being read.

Returns
int

‣ -1
iff a is equal to negative infinity,
‣ 1
iff a is equal to positive infinity,
‣ 0
otherwise.

Description
Checks if the input half number a is infinite.

[Link]
CUDA Math API vRelease Version | 14
 Modules

__device__ bool __hisnan (const __half a)

Determine whether half argument is a NaN.

Parameters
a
- half. Is only being read.

Returns
bool

‣ true
iff argument is NaN.

Description
Determine whether half value a is a NaN.

__device__ bool __hle (const __half a, const __half b)

Performs half less-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of less-equal comparison of a and b.

Description
Performs half less-equal comparison of inputs a and b. NaN inputs generate false
results.

[Link]
CUDA Math API vRelease Version | 15
 Modules

__device__ bool __hleu (const __half a, const __half b)

Performs half unordered less-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered less-equal comparison of a and b.

Description
Performs half less-equal comparison of inputs a and b. NaN inputs generate true
results.

__device__ bool __hlt (const __half a, const __half b)

Performs half less-than comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of less-than comparison of a and b.

Description
Performs half less-than comparison of inputs a and b. NaN inputs generate false
results.

[Link]
CUDA Math API vRelease Version | 16
 Modules

__device__ bool __hltu (const __half a, const __half b)

Performs half unordered less-than comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered less-than comparison of a and b.

Description
Performs half less-than comparison of inputs a and b. NaN inputs generate true
results.

__device__ __half __hmax (const __half a, const __half b)

Calculates half maximum of two input values.

Description
Calculates half max(a, b) defined as (a > b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __half __hmax_nan (const __half a, const __half b)

Calculates half maximum of two input values, NaNs pass through.

Description
Calculates half max(a, b) defined as (a > b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

[Link]
CUDA Math API vRelease Version | 17
 Modules

__device__ __half __hmin (const __half a, const __half b)

Calculates half minimum of two input values.

Description
Calculates half min(a, b) defined as (a < b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __half __hmin_nan (const __half a, const __half b)

Calculates half minimum of two input values, NaNs pass through.

Description
Calculates half min(a, b) defined as (a < b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ bool __hne (const __half a, const __half b)

Performs half not-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of not-equal comparison of a and b.

Description
Performs half not-equal comparison of inputs a and b. NaN inputs generate false
results.

[Link]
CUDA Math API vRelease Version | 18
 Modules

__device__ bool __hneu (const __half a, const __half b)

Performs half unordered not-equal comparison.

Parameters
a
- half. Is only being read.
b
- half. Is only being read.

Returns
bool

‣ The
boolean result of unordered not-equal comparison of a and b.

Description
Performs half not-equal comparison of inputs a and b. NaN inputs generate true
results.

1.1.4. Half2 Comparison Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

__device__ bool __hbeq2 (const __half2 a, const __half2 b)

Performs half2 vector if-equal comparison, and returns boolean true iff both half
results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of if-equal comparison of vectors a and b are true;
‣ falseotherwise.

[Link]
CUDA Math API vRelease Version | 19
 Modules

Description
Performs half2 vector if-equal comparison of inputs a and b. The bool result is set to
true only if both half if-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate false results.

__device__ bool __hbequ2 (const __half2 a, const __half2 b)

Performs half2 vector unordered if-equal comparison, and returns boolean true iff both
half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of unordered if-equal comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector if-equal comparison of inputs a and b. The bool result is set to
true only if both half if-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate true results.

__device__ bool __hbge2 (const __half2 a, const __half2 b)

Performs half2 vector greater-equal comparison, and returns boolean true iff both
half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif

[Link]
CUDA Math API vRelease Version | 20
 Modules

both half results of greater-equal comparison of vectors a and b are true;

‣ falseotherwise.

Description
Performs half2 vector greater-equal comparison of inputs a and b. The bool result
is set to true only if both half greater-equal comparisons evaluate to true, or false
otherwise. NaN inputs generate false results.

__device__ bool __hbgeu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered greater-equal comparison, and returns boolean true
iff both half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of unordered greater-equal comparison of vectors a and b are
true;
‣ falseotherwise.

Description
Performs half2 vector greater-equal comparison of inputs a and b. The bool result
is set to true only if both half greater-equal comparisons evaluate to true, or false
otherwise. NaN inputs generate true results.

__device__ bool __hbgt2 (const __half2 a, const __half2 b)

Performs half2 vector greater-than comparison, and returns boolean true iff both half
results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 21
 Modules

Returns
bool

‣ trueif
both half results of greater-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector greater-than comparison of inputs a and b. The bool result is set
to true only if both half greater-than comparisons evaluate to true, or false otherwise.
NaN inputs generate false results.

__device__ bool __hbgtu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered greater-than comparison, and returns boolean true iff
both half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of unordered greater-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector greater-than comparison of inputs a and b. The bool result is set
to true only if both half greater-than comparisons evaluate to true, or false otherwise.
NaN inputs generate true results.

[Link]
CUDA Math API vRelease Version | 22
 Modules

__device__ bool __hble2 (const __half2 a, const __half2 b)

Performs half2 vector less-equal comparison, and returns boolean true iff both half
results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of less-equal comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector less-equal comparison of inputs a and b. The bool result is set to
true only if both half less-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate false results.

__device__ bool __hbleu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered less-equal comparison, and returns boolean true iff
both half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of unordered less-equal comparison of vectors a and b are true;
‣ falseotherwise.

[Link]
CUDA Math API vRelease Version | 23
 Modules

Description
Performs half2 vector less-equal comparison of inputs a and b. The bool result is set to
true only if both half less-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate true results.

__device__ bool __hblt2 (const __half2 a, const __half2 b)

Performs half2 vector less-than comparison, and returns boolean true iff both half
results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of less-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector less-than comparison of inputs a and b. The bool result is set to
true only if both half less-than comparisons evaluate to true, or false otherwise. NaN
inputs generate false results.

__device__ bool __hbltu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered less-than comparison, and returns boolean true iff
both half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif

[Link]
CUDA Math API vRelease Version | 24
 Modules

both half results of unordered less-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector less-than comparison of inputs a and b. The bool result is set to
true only if both half less-than comparisons evaluate to true, or false otherwise. NaN
inputs generate true results.

__device__ bool __hbne2 (const __half2 a, const __half2 b)

Performs half2 vector not-equal comparison, and returns boolean true iff both half
results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
bool

‣ trueif
both half results of not-equal comparison of vectors a and b are true,
‣ false
otherwise.

Description
Performs half2 vector not-equal comparison of inputs a and b. The bool result is set to
true only if both half not-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate false results.

__device__ bool __hbneu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered not-equal comparison, and returns boolean true iff
both half results are true, boolean false otherwise.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 25
 Modules

Returns
bool

‣ trueif
both half results of unordered not-equal comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs half2 vector not-equal comparison of inputs a and b. The bool result is set to
true only if both half not-equal comparisons evaluate to true, or false otherwise. NaN
inputs generate true results.

__device__ __half2 __heq2 (const __half2 a, const __half2 b)

Performs half2 vector if-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of if-equal comparison of vectors a and b.

Description
Performs half2 vector if-equal comparison of inputs a and b. The corresponding half
results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

__device__ __half2 __hequ2 (const __half2 a, const __half2 b)

Performs half2 vector unordered if-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 26
 Modules

Returns
half2

‣ The
vector result of unordered if-equal comparison of vectors a and b.

Description
Performs half2 vector if-equal comparison of inputs a and b. The corresponding half
results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

__device__ __half2 __hge2 (const __half2 a, const __half2 b)

Performs half2 vector greater-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of greater-equal comparison of vectors a and b.

Description
Performs half2 vector greater-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

__device__ __half2 __hgeu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered greater-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

[Link]
CUDA Math API vRelease Version | 27
 Modules

‣ The
half2 vector result of unordered greater-equal comparison of vectors a and b.

Description
Performs half2 vector greater-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

__device__ __half2 __hgt2 (const __half2 a, const __half2 b)

Performs half2 vector greater-than comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of greater-than comparison of vectors a and b.

Description
Performs half2 vector greater-than comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

__device__ __half2 __hgtu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered greater-than comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
half2 vector result of unordered greater-than comparison of vectors a and b.

[Link]
CUDA Math API vRelease Version | 28
 Modules

Description
Performs half2 vector greater-than comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

__device__ __half2 __hisnan2 (const __half2 a)

Determine whether half2 argument is a NaN.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
half2 with the corresponding half results set to 1.0 for for NaN, 0.0 otherwise.

Description
Determine whether each half of input half2 number a is a NaN.

__device__ __half2 __hle2 (const __half2 a, const __half2 b)

Performs half2 vector less-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
half2 result of less-equal comparison of vectors a and b.

Description
Performs half2 vector less-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

[Link]
CUDA Math API vRelease Version | 29
 Modules

__device__ __half2 __hleu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered less-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of unordered less-equal comparison of vectors a and b.

Description
Performs half2 vector less-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

__device__ __half2 __hlt2 (const __half2 a, const __half2 b)

Performs half2 vector less-than comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
half2 vector result of less-than comparison of vectors a and b.

Description
Performs half2 vector less-than comparison of inputs a and b. The corresponding half
results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

[Link]
CUDA Math API vRelease Version | 30
 Modules

__device__ __half2 __hltu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered less-than comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of unordered less-than comparison of vectors a and b.

Description
Performs half2 vector less-than comparison of inputs a and b. The corresponding half
results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

__device__ __half2 __hmax2 (const __half2 a, const __half2 b)

Calculates half2 vector maximum of two inputs.

Description
Calculates half2 vector max(a, b) Elementwise half operation is defined as (a > b) ? a
: b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __half2 __hmax2_nan (const __half2 a, const __half2 b)

Calculates half2 vector maximum of two inputs, NaNs pass through.

Description
Calculates half2 vector max(a, b) Elementwise half operation is defined as (a > b) ? a
: b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

[Link]
CUDA Math API vRelease Version | 31
 Modules

__device__ __half2 __hmin2 (const __half2 a, const __half2 b)

Calculates half2 vector minimum of two inputs.

Description
Calculates half2 vector min(a, b) Elementwise half operation is defined as (a < b) ? a :
b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __half2 __hmin2_nan (const __half2 a, const __half2 b)

Calculates half2 vector minimum of two inputs, NaNs pass through.

Description
Calculates half2 vector min(a, b) Elementwise half operation is defined as (a < b) ? a :
b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __half2 __hne2 (const __half2 a, const __half2 b)

Performs half2 vector not-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of not-equal comparison of vectors a and b.

Description
Performs half2 vector not-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate false results.

[Link]
CUDA Math API vRelease Version | 32
 Modules

__device__ __half2 __hneu2 (const __half2 a, const __half2 b)

Performs half2 vector unordered not-equal comparison.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
vector result of unordered not-equal comparison of vectors a and b.

Description
Performs half2 vector not-equal comparison of inputs a and b. The corresponding
half results are set to 1.0 for true, or 0.0 for false. NaN inputs generate true results.

1.1.5. Half Precision Conversion And Data Movement

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

__host____device__ __half __double2half (const double a)

Converts double number to half precision in round-to-nearest-even mode and returns
half with converted value.

Parameters
a
- double. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts double number a to half precision in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 33
 Modules

__host____device__ __half2 __float22half2_rn (const float2 a)

Converts both components of float2 number to half precision in round-to-nearest-even
mode and returns half2 with converted values.

Parameters
a
- float2. Is only being read.

Returns
half2

‣ The
half2 which has corresponding halves equal to the converted float2 components.

Description
Converts both components of float2 to half precision in round-to-nearest mode and
combines the results into one half2 number. Low 16 bits of the return value correspond
to a.x and high 16 bits of the return value correspond to a.y.

__host____device__ __half __float2half (const float a)

Converts float number to half precision in round-to-nearest-even mode and returns
half with converted value.

Parameters
a
- float. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts float number a to half precision in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 34
 Modules

__host____device__ __half2 __float2half2_rn (const float a)

Converts input to half precision in round-to-nearest-even mode and populates both
halves of half2 with converted value.

Parameters
a
- float. Is only being read.

Returns
half2

‣ The
half2 value with both halves equal to the converted half precision number.

Description
Converts input a to half precision in round-to-nearest-even mode and populates both
halves of half2 with converted value.

__host____device__ __half __float2half_rd (const float a)

Converts float number to half precision in round-down mode and returns half with
converted value.

Parameters
a
- float. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts float number a to half precision in round-down mode.

[Link]
CUDA Math API vRelease Version | 35
 Modules

__host____device__ __half __float2half_rn (const float a)

Converts float number to half precision in round-to-nearest-even mode and returns
half with converted value.

Parameters
a
- float. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts float number a to half precision in round-to-nearest-even mode.

__host____device__ __half __float2half_ru (const float a)

Converts float number to half precision in round-up mode and returns half with
converted value.

Parameters
a
- float. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts float number a to half precision in round-up mode.

[Link]
CUDA Math API vRelease Version | 36
 Modules

__host____device__ __half __float2half_rz (const float a)

Converts float number to half precision in round-towards-zero mode and returns half
with converted value.

Parameters
a
- float. Is only being read.

Returns
half

‣ \p
a converted to half.

Description
Converts float number a to half precision in round-towards-zero mode.

__host____device__ __half2 __floats2half2_rn (const float a, const

float b)
Converts both input floats to half precision in round-to-nearest-even mode and returns
half2 with converted values.

Parameters
a
- float. Is only being read.
b
- float. Is only being read.

Returns
half2

‣ The
half2 value with corresponding halves equal to the converted input floats.

Description
Converts both input floats to half precision in round-to-nearest-even mode and
combines the results into one half2 number. Low 16 bits of the return value correspond
to the input a, high 16 bits correspond to the input b.

[Link]
CUDA Math API vRelease Version | 37
 Modules

__host____device__ float2 __half22float2 (const __half2 a)

Converts both halves of half2 to float2 and returns the result.

Parameters
a
- half2. Is only being read.

Returns
float2

‣ \p
a converted to float2.

Description
Converts both halves of half2 input a to float2 and returns the result.

__host____device__ float __half2float (const __half a)

Converts half number to float.

Parameters
a
- float. Is only being read.

Returns
float

‣ \p
a converted to float.

Description
Converts half number a to float.

__device__ __half2 __half2half2 (const __half a)

Returns half2 with both halves equal to the input value.

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 38
 Modules

Returns
half2

‣ The
vector which has both its halves equal to the input a.

Description
Returns half2 number with both halves equal to the input a half number.

__device__ int __half2int_rd (__half h)

Convert a half to a signed integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the half-precision floating point value h to a signed integer in round-down
mode.

__device__ int __half2int_rn (__half h)

Convert a half to a signed integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

[Link]
CUDA Math API vRelease Version | 39
 Modules

Description
Convert the half-precision floating point value h to a signed integer in round-to-nearest-
even mode.

__device__ int __half2int_ru (__half h)

Convert a half to a signed integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the half-precision floating point value h to a signed integer in round-up mode.

__device__ int __half2int_rz (__half h)

Convert a half to a signed integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the half-precision floating point value h to a signed integer in round-towards-
zero mode.

[Link]
CUDA Math API vRelease Version | 40
 Modules

__device__ long long int __half2ll_rd (__half h)

Convert a half to a signed 64-bit integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the half-precision floating point value h to a signed 64-bit integer in round-
down mode.

__device__ long long int __half2ll_rn (__half h)

Convert a half to a signed 64-bit integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the half-precision floating point value h to a signed 64-bit integer in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 41
 Modules

__device__ long long int __half2ll_ru (__half h)

Convert a half to a signed 64-bit integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the half-precision floating point value h to a signed 64-bit integer in round-up
mode.

__device__ long long int __half2ll_rz (__half h)

Convert a half to a signed 64-bit integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the half-precision floating point value h to a signed 64-bit integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 42
 Modules

__device__ short int __half2short_rd (__half h)

Convert a half to a signed short integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the half-precision floating point value h to a signed short integer in round-
down mode.

__device__ short int __half2short_rn (__half h)

Convert a half to a signed short integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the half-precision floating point value h to a signed short integer in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 43
 Modules

__device__ short int __half2short_ru (__half h)

Convert a half to a signed short integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the half-precision floating point value h to a signed short integer in round-up
mode.

__device__ short int __half2short_rz (__half h)

Convert a half to a signed short integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the half-precision floating point value h to a signed short integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 44
 Modules

__device__ unsigned int __half2uint_rd (__half h)

Convert a half to an unsigned integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the half-precision floating point value h to an unsigned integer in round-down
mode.

__device__ unsigned int __half2uint_rn (__half h)

Convert a half to an unsigned integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the half-precision floating point value h to an unsigned integer in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 45
 Modules

__device__ unsigned int __half2uint_ru (__half h)

Convert a half to an unsigned integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the half-precision floating point value h to an unsigned integer in round-up
mode.

__device__ unsigned int __half2uint_rz (__half h)

Convert a half to an unsigned integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the half-precision floating point value h to an unsigned integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 46
 Modules

__device__ unsigned long long int __half2ull_rd (__half h)

Convert a half to an unsigned 64-bit integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the half-precision floating point value h to an unsigned 64-bit integer in round-
down mode.

__device__ unsigned long long int __half2ull_rn (__half h)

Convert a half to an unsigned 64-bit integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the half-precision floating point value h to an unsigned 64-bit integer in round-
to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 47
 Modules

__device__ unsigned long long int __half2ull_ru (__half h)

Convert a half to an unsigned 64-bit integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the half-precision floating point value h to an unsigned 64-bit integer in round-
up mode.

__device__ unsigned long long int __half2ull_rz (__half h)

Convert a half to an unsigned 64-bit integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the half-precision floating point value h to an unsigned 64-bit integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 48
 Modules

__device__ unsigned short int __half2ushort_rd (__half h)

Convert a half to an unsigned short integer in round-down mode.

Parameters
h
- half. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the half-precision floating point value h to an unsigned short integer in round-
down mode.

__device__ unsigned short int __half2ushort_rn (__half h)

Convert a half to an unsigned short integer in round-to-nearest-even mode.

Parameters
h
- half. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the half-precision floating point value h to an unsigned short integer in round-
to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 49
 Modules

__device__ unsigned short int __half2ushort_ru (__half h)

Convert a half to an unsigned short integer in round-up mode.

Parameters
h
- half. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an an unsigned short integer.

Description
Convert the half-precision floating point value h to an unsigned short integer in round-
up mode.

__device__ unsigned short int __half2ushort_rz (__half h)

Convert a half to an unsigned short integer in round-towards-zero mode.

Parameters
h
- half. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the half-precision floating point value h to an unsigned short integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 50
 Modules

__device__ short int __half_as_short (const __half h)

Reinterprets bits in a half as a signed short integer.

Parameters
h
- half. Is only being read.

Returns
short int

‣ The
reinterpreted value.

Description
Reinterprets the bits in the half-precision floating point number h as a signed short
integer.

__device__ unsigned short int __half_as_ushort (const __half h)

Reinterprets bits in a half as an unsigned short integer.

Parameters
h
- half. Is only being read.

Returns
unsigned short int

‣ The
reinterpreted value.

Description
Reinterprets the bits in the half-precision floating point h as an unsigned short number.

__device__ __half2 __halves2half2 (const __half a, const __half b)

Combines two half numbers into one half2 number.

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 51
 Modules

b
- half. Is only being read.

Returns
half2

‣ The
half2 with one half equal to a and the other to b.

Description
Combines two input half number a and b into one half2 number. Input a is stored in
low 16 bits of the return value, input b is stored in high 16 bits of the return value.

__host____device__ float __high2float (const __half2 a)

Converts high 16 bits of half2 to float and returns the result.

Parameters
a
- half2. Is only being read.

Returns
float

‣ The
high 16 bits of a converted to float.

Description
Converts high 16 bits of half2 input a to 32 bit floating point number and returns the
result.

__device__ __half __high2half (const __half2 a)

Returns high 16 bits of half2 input.

Parameters
a
- half2. Is only being read.

Returns
half

‣ The

[Link]
CUDA Math API vRelease Version | 52
 Modules

high 16 bits of the input.

Description
Returns high 16 bits of half2 input a.

__device__ __half2 __high2half2 (const __half2 a)

Extracts high 16 bits from half2 input.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
half2 with both halves equal to the high 16 bits of the input.

Description
Extracts high 16 bits from half2 input a and returns a new half2 number which has
both halves equal to the extracted bits.

__device__ __half2 __highs2half2 (const __half2 a, const __half2 b)

Extracts high 16 bits from each of the two half2 inputs and combines into one half2
number.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The
high 16 bits of a and of b.

[Link]
CUDA Math API vRelease Version | 53
 Modules

Description
Extracts high 16 bits from each of the two half2 inputs and combines into one half2
number. High 16 bits from input a is stored in low 16 bits of the return value, high 16
bits from input b is stored in high 16 bits of the return value.

__device__ __half __int2half_rd (int i)

Convert a signed integer to a half in round-down mode.

Parameters
i
- int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed integer value i to a half-precision floating point value in round-
down mode.

__device__ __half __int2half_rn (int i)

Convert a signed integer to a half in round-to-nearest-even mode.

Parameters
i
- int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed integer value i to a half-precision floating point value in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 54
 Modules

__device__ __half __int2half_ru (int i)

Convert a signed integer to a half in round-up mode.

Parameters
i
- int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed integer value i to a half-precision floating point value in round-up
mode.

__device__ __half __int2half_rz (int i)

Convert a signed integer to a half in round-towards-zero mode.

Parameters
i
- int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed integer value i to a half-precision floating point value in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 55
 Modules

__device__ __half __ldca (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldca (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half __ldcg (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldcg (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 56
 Modules

__device__ __half __ldcs (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldcs (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half __ldcv (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldcv (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 57
 Modules

__device__ __half __ldg (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldg (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half __ldlu (const __half *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __half2 __ldlu (const __half2 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 58
 Modules

__device__ __half __ll2half_rd (long long int i)

Convert a signed 64-bit integer to a half in round-down mode.

Parameters
i
- long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed 64-bit integer value i to a half-precision floating point value in
round-down mode.

__device__ __half __ll2half_rn (long long int i)

Convert a signed 64-bit integer to a half in round-to-nearest-even mode.

Parameters
i
- long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed 64-bit integer value i to a half-precision floating point value in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 59
 Modules

__device__ __half __ll2half_ru (long long int i)

Convert a signed 64-bit integer to a half in round-up mode.

Parameters
i
- long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed 64-bit integer value i to a half-precision floating point value in
round-up mode.

__device__ __half __ll2half_rz (long long int i)

Convert a signed 64-bit integer to a half in round-towards-zero mode.

Parameters
i
- long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed 64-bit integer value i to a half-precision floating point value in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 60
 Modules

__host____device__ float __low2float (const __half2 a)

Converts low 16 bits of half2 to float and returns the result.

Parameters
a
- half2. Is only being read.

Returns
float

‣ The
low 16 bits of a converted to float.

Description
Converts low 16 bits of half2 input a to 32 bit floating point number and returns the
result.

__device__ __half __low2half (const __half2 a)

Returns low 16 bits of half2 input.

Parameters
a
- half2. Is only being read.

Returns
half

‣ Returns
half which contains low 16 bits of the input a.

Description
Returns low 16 bits of half2 input a.

__device__ __half2 __low2half2 (const __half2 a)

Extracts low 16 bits from half2 input.

Parameters
a
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 61
 Modules

Returns
half2

‣ The
half2 with both halves equal to the low 16 bits of the input.

Description
Extracts low 16 bits from half2 input a and returns a new half2 number which has
both halves equal to the extracted bits.

__device__ __half2 __lowhigh2highlow (const __half2 a)

Swaps both halves of the half2 input.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ \p
a with its halves being swapped.

Description
Swaps both halves of the half2 input and returns a new half2 number with swapped
halves.

__device__ __half2 __lows2half2 (const __half2 a, const __half2 b)

Extracts low 16 bits from each of the two half2 inputs and combines into one half2
number.

Parameters
a
- half2. Is only being read.
b
- half2. Is only being read.

Returns
half2

‣ The

[Link]
CUDA Math API vRelease Version | 62
 Modules

low 16 bits of a and of b.

Description
Extracts low 16 bits from each of the two half2 inputs and combines into one half2
number. Low 16 bits from input a is stored in low 16 bits of the return value, low 16 bits
from input b is stored in high 16 bits of the return value.

__device__ __half __shfl_down_sync (unsigned mask, __half var,

unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with higher ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- half. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as half. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Calculates a source thread ID by adding delta to the caller's thread ID. The value
of var held by the resulting thread ID is returned: this has the effect of shifting var
down the warp by delta threads. If width is less than warpSize then each subsection
of the warp behaves as a separate entity with a starting logical thread ID of 0. As for
__shfl_up_sync(), the ID number of the source thread will not wrap around the value of
width and so the upper delta threads will remain unchanged.

[Link]
CUDA Math API vRelease Version | 63
 Modules

__device__ __half2 __shfl_down_sync (unsigned mask, __half2 var,

unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with higher ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- half2. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as half2. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Calculates a source thread ID by adding delta to the caller's thread ID. The value
of var held by the resulting thread ID is returned: this has the effect of shifting var
down the warp by delta threads. If width is less than warpSize then each subsection
of the warp behaves as a separate entity with a starting logical thread ID of 0. As for
__shfl_up_sync(), the ID number of the source thread will not wrap around the value of
width and so the upper delta threads will remain unchanged.

__device__ __half __shfl_sync (unsigned mask, __half var, int delta,

int width)
Exchange a variable between threads within a warp. Direct copy from indexed thread.

Parameters
mask
- unsigned int. Is only being read.
var
- half. Is only being read.
delta
- int. Is only being read.

[Link]
CUDA Math API vRelease Version | 64
 Modules

width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as half. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Returns the value of var held by the thread whose ID is given by delta. If width is less
than warpSize then each subsection of the warp behaves as a separate entity with a
starting logical thread ID of 0. If delta is outside the range [0:width-1], the value returned
corresponds to the value of var held by the delta modulo width (i.e. ithin the same
subsection). width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __half2 __shfl_sync (unsigned mask, __half2 var, int

delta, int width)
Exchange a variable between threads within a warp. Direct copy from indexed thread.

Parameters
mask
- unsigned int. Is only being read.
var
- half2. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as half2. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Returns the value of var held by the thread whose ID is given by delta. If width is less
than warpSize then each subsection of the warp behaves as a separate entity with a
starting logical thread ID of 0. If delta is outside the range [0:width-1], the value returned
corresponds to the value of var held by the delta modulo width (i.e. ithin the same

[Link]
CUDA Math API vRelease Version | 65
 Modules

subsection). width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __half __shfl_up_sync (unsigned mask, __half var,

unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with lower ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- half. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as half. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Calculates a source thread ID by subtracting delta from the caller's lane ID. The value
of var held by the resulting lane ID is returned: in effect, var is shifted up the warp by
delta threads. If width is less than warpSize then each subsection of the warp behaves
as a separate entity with a starting logical thread ID of 0. The source thread index
will not wrap around the value of width, so effectively the lower delta threads will be
unchanged. width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __half2 __shfl_up_sync (unsigned mask, __half2 var,

unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with lower ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.

[Link]
CUDA Math API vRelease Version | 66
 Modules

var
- half2. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as half2. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Calculates a source thread ID by subtracting delta from the caller's lane ID. The value
of var held by the resulting lane ID is returned: in effect, var is shifted up the warp by
delta threads. If width is less than warpSize then each subsection of the warp behaves
as a separate entity with a starting logical thread ID of 0. The source thread index
will not wrap around the value of width, so effectively the lower delta threads will be
unchanged. width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __half __shfl_xor_sync (unsigned mask, __half var, int

delta, int width)
Exchange a variable between threads within a warp. Copy from a thread based on
bitwise XOR of own thread ID.

Parameters
mask
- unsigned int. Is only being read.
var
- half. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as half. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

[Link]
CUDA Math API vRelease Version | 67
 Modules

Description
Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with
mask: the value of var held by the resulting thread ID is returned. If width is less than
warpSize then each group of width consecutive threads are able to access elements from
earlier groups of threads, however if they attempt to access elements from later groups
of threads their own value of var will be returned. This mode implements a butterfly
addressing pattern such as is used in tree reduction and broadcast.

__device__ __half2 __shfl_xor_sync (unsigned mask, __half2 var, int

delta, int width)
Exchange a variable between threads within a warp. Copy from a thread based on
bitwise XOR of own thread ID.

Parameters
mask
- unsigned int. Is only being read.
var
- half2. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as half2. If the
source thread ID is out of range or the source thread has exited, the calling thread's own
var is returned.

Description
Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with
mask: the value of var held by the resulting thread ID is returned. If width is less than
warpSize then each group of width consecutive threads are able to access elements from
earlier groups of threads, however if they attempt to access elements from later groups
of threads their own value of var will be returned. This mode implements a butterfly
addressing pattern such as is used in tree reduction and broadcast.

[Link]
CUDA Math API vRelease Version | 68
 Modules

__device__ __half __short2half_rd (short int i)

Convert a signed short integer to a half in round-down mode.

Parameters
i
- short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed short integer value i to a half-precision floating point value in
round-down mode.

__device__ __half __short2half_rn (short int i)

Convert a signed short integer to a half in round-to-nearest-even mode.

Parameters
i
- short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed short integer value i to a half-precision floating point value in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 69
 Modules

__device__ __half __short2half_ru (short int i)

Convert a signed short integer to a half in round-up mode.

Parameters
i
- short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed short integer value i to a half-precision floating point value in
round-up mode.

__device__ __half __short2half_rz (short int i)

Convert a signed short integer to a half in round-towards-zero mode.

Parameters
i
- short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the signed short integer value i to a half-precision floating point value in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 70
 Modules

__device__ __half __short_as_half (const short int i)

Reinterprets bits in a signed short integer as a half.

Parameters
i
- short int. Is only being read.

Returns
half

‣ The
reinterpreted value.

Description
Reinterprets the bits in the signed short integer i as a half-precision floating point
number.

__device__ void __stcg (__half *ptr, __half value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stcg (__half2 *ptr, __half2 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

[Link]
CUDA Math API vRelease Version | 71
 Modules

__device__ void __stcs (__half *ptr, __half value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stcs (__half2 *ptr, __half2 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwb (__half *ptr, __half value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwb (__half2 *ptr, __half2 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

[Link]
CUDA Math API vRelease Version | 72
 Modules

__device__ void __stwt (__half *ptr, __half value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwt (__half2 *ptr, __half2 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ __half __uint2half_rd (unsigned int i)

Convert an unsigned integer to a half in round-down mode.

Parameters
i
- unsigned int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned integer value i to a half-precision floating point value in round-
down mode.

[Link]
CUDA Math API vRelease Version | 73
 Modules

__device__ __half __uint2half_rn (unsigned int i)

Convert an unsigned integer to a half in round-to-nearest-even mode.

Parameters
i
- unsigned int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned integer value i to a half-precision floating point value in round-to-
nearest-even mode.

__device__ __half __uint2half_ru (unsigned int i)

Convert an unsigned integer to a half in round-up mode.

Parameters
i
- unsigned int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned integer value i to a half-precision floating point value in round-up
mode.

[Link]
CUDA Math API vRelease Version | 74
 Modules

__device__ __half __uint2half_rz (unsigned int i)

Convert an unsigned integer to a half in round-towards-zero mode.

Parameters
i
- unsigned int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned integer value i to a half-precision floating point value in round-
towards-zero mode.

__device__ __half __ull2half_rd (unsigned long long int i)

Convert an unsigned 64-bit integer to a half in round-down mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned 64-bit integer value i to a half-precision floating point value in
round-down mode.

[Link]
CUDA Math API vRelease Version | 75
 Modules

__device__ __half __ull2half_rn (unsigned long long int i)

Convert an unsigned 64-bit integer to a half in round-to-nearest-even mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned 64-bit integer value i to a half-precision floating point value in
round-to-nearest-even mode.

__device__ __half __ull2half_ru (unsigned long long int i)

Convert an unsigned 64-bit integer to a half in round-up mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned 64-bit integer value i to a half-precision floating point value in
round-up mode.

[Link]
CUDA Math API vRelease Version | 76
 Modules

__device__ __half __ull2half_rz (unsigned long long int i)

Convert an unsigned 64-bit integer to a half in round-towards-zero mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned 64-bit integer value i to a half-precision floating point value in
round-towards-zero mode.

__device__ __half __ushort2half_rd (unsigned short int i)

Convert an unsigned short integer to a half in round-down mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned short integer value i to a half-precision floating point value in
round-down mode.

[Link]
CUDA Math API vRelease Version | 77
 Modules

__device__ __half __ushort2half_rn (unsigned short int i)

Convert an unsigned short integer to a half in round-to-nearest-even mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned short integer value i to a half-precision floating point value in
round-to-nearest-even mode.

__device__ __half __ushort2half_ru (unsigned short int i)

Convert an unsigned short integer to a half in round-up mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned short integer value i to a half-precision floating point value in
round-up mode.

[Link]
CUDA Math API vRelease Version | 78
 Modules

__device__ __half __ushort2half_rz (unsigned short int i)

Convert an unsigned short integer to a half in round-towards-zero mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
half

‣ \p
i converted to half.

Description
Convert the unsigned short integer value i to a half-precision floating point value in
round-towards-zero mode.

__device__ __half __ushort_as_half (const unsigned short int i)

Reinterprets bits in an unsigned short integer as a half.

Parameters
i
- unsigned short int. Is only being read.

Returns
half

‣ The
reinterpreted value.

Description
Reinterprets the bits in the unsigned short integer i as a half-precision floating point
number.

1.1.6. Half Math Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

[Link]
CUDA Math API vRelease Version | 79
 Modules

__device__ __half hceil (const __half h)

Calculate ceiling of the input argument.

Parameters
h
- half. Is only being read.

Returns
half

‣ The
smallest integer value not less than h.

Description
Compute the smallest integer value not less than h.

__device__ __half hcos (const __half a)

Calculates half cosine in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
cosine of a.

Description
Calculates half cosine of input a in round-to-nearest-even mode.

__device__ __half hexp (const __half a)

Calculates half natural exponential function in round-to-nearest mode.

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 80
 Modules

Returns
half

‣ The
natural exponential function on a.

Description
Calculates half natural exponential function of input a in round-to-nearest-even mode.

__device__ __half hexp10 (const __half a)

Calculates half decimal exponential function in round-to-nearest mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
decimal exponential function on a.

Description
Calculates half decimal exponential function of input a in round-to-nearest-even mode.

__device__ __half hexp2 (const __half a)

Calculates half binary exponential function in round-to-nearest mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
binary exponential function on a.

Description
Calculates half binary exponential function of input a in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 81
 Modules

__device__ __half hfloor (const __half h)

Calculate the largest integer less than or equal to h.

Parameters
h
- half. Is only being read.

Returns
half

‣ The
largest integer value which is less than or equal to h.

Description
Calculate the largest integer value which is less than or equal to h.

__device__ __half hlog (const __half a)

Calculates half natural logarithm in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
natural logarithm of a.

Description
Calculates half natural logarithm of input a in round-to-nearest-even mode.

__device__ __half hlog10 (const __half a)

Calculates half decimal logarithm in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 82
 Modules

Returns
half

‣ The
decimal logarithm of a.

Description
Calculates half decimal logarithm of input a in round-to-nearest-even mode.

__device__ __half hlog2 (const __half a)

Calculates half binary logarithm in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
binary logarithm of a.

Description
Calculates half binary logarithm of input a in round-to-nearest-even mode.

__device__ __half hrcp (const __half a)

Calculates half reciprocal in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
reciprocal of a.

Description
Calculates half reciprocal of input a in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 83
 Modules

__device__ __half hrint (const __half h)

Round input to nearest integer value in half-precision floating point number.

Parameters
h
- half. Is only being read.

Returns
half

‣ The
nearest integer to h.

Description
Round h to the nearest integer value in half-precision floating point format, with
halfway cases rounded to the nearest even integer value.

__device__ __half hrsqrt (const __half a)

Calculates half reciprocal square root in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
reciprocal square root of a.

Description
Calculates half reciprocal square root of input a in round-to-nearest mode.

__device__ __half hsin (const __half a)

Calculates half sine in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

[Link]
CUDA Math API vRelease Version | 84
 Modules

Returns
half

‣ The
sine of a.

Description
Calculates half sine of input a in round-to-nearest-even mode.

__device__ __half hsqrt (const __half a)

Calculates half square root in round-to-nearest-even mode.

Parameters
a
- half. Is only being read.

Returns
half

‣ The
square root of a.

Description
Calculates half square root of input a in round-to-nearest-even mode.

__device__ __half htrunc (const __half h)

Truncate input argument to the integral part.

Parameters
h
- half. Is only being read.

Returns
half

‣ The
truncated integer value.

Description
Round h to the nearest integer value that does not exceed h in magnitude.

[Link]
CUDA Math API vRelease Version | 85
 Modules

1.1.7. Half2 Math Functions

Half Precision Intrinsics
To use these functions include the header file cuda_fp16.h in your program.

__device__ __half2 h2ceil (const __half2 h)

Calculate half2 vector ceiling of the input argument.

Parameters
h
- half2. Is only being read.

Returns
half2

‣ The
vector of smallest integers not less than h.

Description
For each component of vector h compute the smallest integer value not less than h.

__device__ __half2 h2cos (const __half2 a)

Calculates half2 vector cosine in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise cosine on vector a.

Description
Calculates half2 cosine of input vector a in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 86
 Modules

__device__ __half2 h2exp (const __half2 a)

Calculates half2 vector exponential function in round-to-nearest mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise exponential function on vector a.

Description
Calculates half2 exponential function of input vector a in round-to-nearest-even mode.

__device__ __half2 h2exp10 (const __half2 a)

Calculates half2 vector decimal exponential function in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise decimal exponential function on vector a.

Description
Calculates half2 decimal exponential function of input vector a in round-to-nearest-
even mode.

__device__ __half2 h2exp2 (const __half2 a)

Calculates half2 vector binary exponential function in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 87
 Modules

Returns
half2

‣ The
elementwise binary exponential function on vector a.

Description
Calculates half2 binary exponential function of input vector a in round-to-nearest-even
mode.

__device__ __half2 h2floor (const __half2 h)

Calculate the largest integer less than or equal to h.

Parameters
h
- half2. Is only being read.

Returns
half2

‣ The
vector of largest integers which is less than or equal to h.

Description
For each component of vector h calculate the largest integer value which is less than or
equal to h.

__device__ __half2 h2log (const __half2 a)

Calculates half2 vector natural logarithm in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise natural logarithm on vector a.

[Link]
CUDA Math API vRelease Version | 88
 Modules

Description
Calculates half2 natural logarithm of input vector a in round-to-nearest-even mode.

__device__ __half2 h2log10 (const __half2 a)

Calculates half2 vector decimal logarithm in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise decimal logarithm on vector a.

Description
Calculates half2 decimal logarithm of input vector a in round-to-nearest-even mode.

__device__ __half2 h2log2 (const __half2 a)

Calculates half2 vector binary logarithm in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise binary logarithm on vector a.

Description
Calculates half2 binary logarithm of input vector a in round-to-nearest mode.

[Link]
CUDA Math API vRelease Version | 89
 Modules

__device__ __half2 h2rcp (const __half2 a)

Calculates half2 vector reciprocal in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise reciprocal on vector a.

Description
Calculates half2 reciprocal of input vector a in round-to-nearest-even mode.

__device__ __half2 h2rint (const __half2 h)

Round input to nearest integer value in half-precision floating point number.

Parameters
h
- half2. Is only being read.

Returns
half2

‣ The
vector of rounded integer values.

Description
Round each component of half2 vector h to the nearest integer value in half-precision
floating point format, with halfway cases rounded to the nearest even integer value.

__device__ __half2 h2rsqrt (const __half2 a)

Calculates half2 vector reciprocal square root in round-to-nearest mode.

Parameters
a
- half2. Is only being read.

[Link]
CUDA Math API vRelease Version | 90
 Modules

Returns
half2

‣ The
elementwise reciprocal square root on vector a.

Description
Calculates half2 reciprocal square root of input vector a in round-to-nearest-even
mode.

__device__ __half2 h2sin (const __half2 a)

Calculates half2 vector sine in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise sine on vector a.

Description
Calculates half2 sine of input vector a in round-to-nearest-even mode.

__device__ __half2 h2sqrt (const __half2 a)

Calculates half2 vector square root in round-to-nearest-even mode.

Parameters
a
- half2. Is only being read.

Returns
half2

‣ The
elementwise square root on vector a.

[Link]
CUDA Math API vRelease Version | 91
 Modules

Description
Calculates half2 square root of input vector a in round-to-nearest mode.

__device__ __half2 h2trunc (const __half2 h)

Truncate half2 vector input argument to the integral part.

Parameters
h
- half2. Is only being read.

Returns
half2

‣ The
truncated h.

Description
Round each component of vector h to the nearest integer value that does not exceed h in
magnitude.

1.2. Bfloat16 Precision Intrinsics

This section describes nv_bfloat16 precision intrinsic functions that are only supported
in device code. To use these functions include the header file cuda_bf16.h in your
program.

Bfloat16 Arithmetic Functions

Bfloat162 Arithmetic Functions

Bfloat16 Comparison Functions

Bfloat162 Comparison Functions

Bfloat16 Precision Conversion And Data Movement

Bfloat16 Math Functions

[Link]
CUDA Math API vRelease Version | 92
 Modules

Bfloat162 Math Functions

1.2.1. Bfloat16 Arithmetic Functions

Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

__device__ __nv_bfloat162 __h2div (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector division in round-to-nearest-even mode.

Description
Divides nv_bfloat162 input vector a by input vector b in round-to-nearest mode.

__device__ __nv_bfloat16 __habs (const __nv_bfloat16 a)

Calculates the absolute value of input nv_bfloat16 number and returns the result.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
absolute value of a.

Description
Calculates the absolute value of input nv_bfloat16 number and returns the result.

__device__ __nv_bfloat16 __hadd (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 addition in round-to-nearest-even mode.

Description
Performs nv_bfloat16 addition of inputs a and b, in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 93
 Modules

__device__ __nv_bfloat16 __hadd_sat (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 addition in round-to-nearest-even mode, with saturation to
[0.0, 1.0].

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
sum of a and b, with respect to saturation.

Description
Performs nv_bfloat16 add of inputs a and b, in round-to-nearest-even mode, and
clamps the result to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __nv_bfloat16 __hdiv (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 division in round-to-nearest-even mode.

Description
Divides nv_bfloat16 input a by input b in round-to-nearest mode.

__device__ __nv_bfloat16 __hfma (const __nv_bfloat16 a, const

__nv_bfloat16 b, const __nv_bfloat16 c)
Performs nv_bfloat16 fused multiply-add in round-to-nearest-even mode.

Description
Performs nv_bfloat16 multiply on inputs a and b, then performs a nv_bfloat16
add of the result with c, rounding the result once in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 94
 Modules

__device__ __nv_bfloat16 __hfma_relu (const __nv_bfloat16 a,

const __nv_bfloat16 b, const __nv_bfloat16 c)
Performs nv_bfloat16 fused multiply-add in round-to-nearest-even mode with relu
saturation.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.
c
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
result of fused multiply-add operation on a, b, and c with relu saturation.

Description
Performs nv_bfloat16 multiply on inputs a and b, then performs a nv_bfloat16
add of the result with c, rounding the result once in round-to-nearest-even mode. Then
negative result is clamped to 0. NaN result is converted to canonical NaN.

__device__ __nv_bfloat16 __hfma_sat (const __nv_bfloat16 a, const

__nv_bfloat16 b, const __nv_bfloat16 c)
Performs nv_bfloat16 fused multiply-add in round-to-nearest-even mode, with
saturation to [0.0, 1.0].

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.
c
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The

[Link]
CUDA Math API vRelease Version | 95
 Modules

result of fused multiply-add operation on a, b, and c, with respect to saturation.

Description
Performs nv_bfloat16 multiply on inputs a and b, then performs a nv_bfloat16
add of the result with c, rounding the result once in round-to-nearest-even mode, and
clamps the result to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __nv_bfloat16 __hmul (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 multiplication in round-to-nearest-even mode.

Description
Performs nv_bfloat16 multiplication of inputs a and b, in round-to-nearest mode.

__device__ __nv_bfloat16 __hmul_sat (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 multiplication in round-to-nearest-even mode, with saturation
to [0.0, 1.0].

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
result of multiplying a and b, with respect to saturation.

Description
Performs nv_bfloat16 multiplication of inputs a and b, in round-to-nearest mode, and
clamps the result to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __nv_bfloat16 __hneg (const __nv_bfloat16 a)

Negates input nv_bfloat16 number and returns the result.

Description
Negates input nv_bfloat16 number and returns the result.

[Link]
CUDA Math API vRelease Version | 96
 Modules

__device__ __nv_bfloat16 __hsub (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 subtraction in round-to-nearest-even mode.

Description
Subtracts nv_bfloat16 input b from input a in round-to-nearest mode.

__device__ __nv_bfloat16 __hsub_sat (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 subtraction in round-to-nearest-even mode, with saturation to
[0.0, 1.0].

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
result of subtraction of b from a, with respect to saturation.

Description
Subtracts nv_bfloat16 input b from input a in round-to-nearest mode, and clamps the
result to range [0.0, 1.0]. NaN results are flushed to +0.0.

1.2.2. Bfloat162 Arithmetic Functions

Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

__device__ __nv_bfloat162 __habs2 (const __nv_bfloat162 a)

Calculates the absolute value of both halves of the input nv_bfloat162 number and
returns the result.

Parameters
a
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 97
 Modules

Returns
bfloat2

‣ Returns
a with the absolute value of both halves.

Description
Calculates the absolute value of both halves of the input nv_bfloat162 number and
returns the result.

__device__ __nv_bfloat162 __hadd2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector addition in round-to-nearest-even mode.

Description
Performs nv_bfloat162 vector add of inputs a and b, in round-to-nearest mode.

__device__ __nv_bfloat162 __hadd2_sat (const __nv_bfloat162 a,

const __nv_bfloat162 b)
Performs nv_bfloat162 vector addition in round-to-nearest-even mode, with
saturation to [0.0, 1.0].

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
sum of a and b, with respect to saturation.

Description
Performs nv_bfloat162 vector add of inputs a and b, in round-to-nearest mode, and
clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

[Link]
CUDA Math API vRelease Version | 98
 Modules

__device__ __nv_bfloat162 __hfma2 (const __nv_bfloat162 a, const

__nv_bfloat162 b, const __nv_bfloat162 c)
Performs nv_bfloat162 vector fused multiply-add in round-to-nearest-even mode.

Description
Performs nv_bfloat162 vector multiply on inputs a and b, then performs a
nv_bfloat162 vector add of the result with c, rounding the result once in round-to-
nearest-even mode.

__device__ __nv_bfloat162 __hfma2_relu (const __nv_bfloat162 a,

const __nv_bfloat162 b, const __nv_bfloat162 c)
Performs nv_bfloat162 vector fused multiply-add in round-to-nearest-even mode
with relu saturation.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.
c
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
result of elementwise fused multiply-add operation on vectors a, b, and c with relu
saturation.

Description
Performs nv_bfloat162 vector multiply on inputs a and b, then performs a
nv_bfloat162 vector add of the result with c, rounding the result once in round-to-
nearest-even mode. Then negative result is clamped to 0. NaN result is converted to
canonical NaN.

[Link]
CUDA Math API vRelease Version | 99
 Modules

__device__ __nv_bfloat162 __hfma2_sat (const __nv_bfloat162 a,

const __nv_bfloat162 b, const __nv_bfloat162 c)
Performs nv_bfloat162 vector fused multiply-add in round-to-nearest-even mode,
with saturation to [0.0, 1.0].

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.
c
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
result of elementwise fused multiply-add operation on vectors a, b, and c, with
respect to saturation.

Description
Performs nv_bfloat162 vector multiply on inputs a and b, then performs a
nv_bfloat162 vector add of the result with c, rounding the result once in round-to-
nearest-even mode, and clamps the results to range [0.0, 1.0]. NaN results are flushed to
+0.0.

__device__ __nv_bfloat162 __hmul2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector multiplication in round-to-nearest-even mode.

Description
Performs nv_bfloat162 vector multiplication of inputs a and b, in round-to-nearest-
even mode.

[Link]
CUDA Math API vRelease Version | 100
 Modules

__device__ __nv_bfloat162 __hmul2_sat (const __nv_bfloat162 a,

const __nv_bfloat162 b)
Performs nv_bfloat162 vector multiplication in round-to-nearest-even mode, with
saturation to [0.0, 1.0].

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
result of elementwise multiplication of vectors a and b, with respect to saturation.

Description
Performs nv_bfloat162 vector multiplication of inputs a and b, in round-to-nearest-
even mode, and clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

__device__ __nv_bfloat162 __hneg2 (const __nv_bfloat162 a)

Negates both halves of the input nv_bfloat162 number and returns the result.

Description
Negates both halves of the input nv_bfloat162 number a and returns the result.

__device__ __nv_bfloat162 __hsub2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector subtraction in round-to-nearest-even mode.

Description
Subtracts nv_bfloat162 input vector b from input vector a in round-to-nearest-even
mode.

[Link]
CUDA Math API vRelease Version | 101
 Modules

__device__ __nv_bfloat162 __hsub2_sat (const __nv_bfloat162 a,

const __nv_bfloat162 b)
Performs nv_bfloat162 vector subtraction in round-to-nearest-even mode, with
saturation to [0.0, 1.0].

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
subtraction of vector b from a, with respect to saturation.

Description
Subtracts nv_bfloat162 input vector b from input vector a in round-to-nearest-even
mode, and clamps the results to range [0.0, 1.0]. NaN results are flushed to +0.0.

1.2.3. Bfloat16 Comparison Functions

Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

__device__ bool __heq (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 if-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The

[Link]
CUDA Math API vRelease Version | 102
 Modules

boolean result of if-equal comparison of a and b.

Description
Performs nv_bfloat16 if-equal comparison of inputs a and b. NaN inputs generate
false results.

__device__ bool __hequ (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 unordered if-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered if-equal comparison of a and b.

Description
Performs nv_bfloat16 if-equal comparison of inputs a and b. NaN inputs generate
true results.

__device__ bool __hge (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 greater-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The

[Link]
CUDA Math API vRelease Version | 103
 Modules

boolean result of greater-equal comparison of a and b.

Description
Performs nv_bfloat16 greater-equal comparison of inputs a and b. NaN inputs
generate false results.

__device__ bool __hgeu (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 unordered greater-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered greater-equal comparison of a and b.

Description
Performs nv_bfloat16 greater-equal comparison of inputs a and b. NaN inputs
generate true results.

__device__ bool __hgt (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 greater-than comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The

[Link]
CUDA Math API vRelease Version | 104
 Modules

boolean result of greater-than comparison of a and b.

Description
Performs nv_bfloat16 greater-than comparison of inputs a and b. NaN inputs
generate false results.

__device__ bool __hgtu (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 unordered greater-than comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered greater-than comparison of a and b.

Description
Performs nv_bfloat16 greater-than comparison of inputs a and b. NaN inputs
generate true results.

__device__ int __hisinf (const __nv_bfloat16 a)

Checks if the input nv_bfloat16 number is infinite.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
int

‣ -1
iff a is equal to negative infinity,
‣ 1

[Link]
CUDA Math API vRelease Version | 105
 Modules

iff a is equal to positive infinity,

‣ 0
otherwise.

Description
Checks if the input nv_bfloat16 number a is infinite.

__device__ bool __hisnan (const __nv_bfloat16 a)

Determine whether nv_bfloat16 argument is a NaN.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
bool

‣ true
iff argument is NaN.

Description
Determine whether nv_bfloat16 value a is a NaN.

__device__ bool __hle (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 less-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of less-equal comparison of a and b.

[Link]
CUDA Math API vRelease Version | 106
 Modules

Description
Performs nv_bfloat16 less-equal comparison of inputs a and b. NaN inputs generate
false results.

__device__ bool __hleu (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 unordered less-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered less-equal comparison of a and b.

Description
Performs nv_bfloat16 less-equal comparison of inputs a and b. NaN inputs generate
true results.

__device__ bool __hlt (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 less-than comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of less-than comparison of a and b.

[Link]
CUDA Math API vRelease Version | 107
 Modules

Description
Performs nv_bfloat16 less-than comparison of inputs a and b. NaN inputs generate
false results.

__device__ bool __hltu (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 unordered less-than comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered less-than comparison of a and b.

Description
Performs nv_bfloat16 less-than comparison of inputs a and b. NaN inputs generate
true results.

__device__ __nv_bfloat16 __hmax (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Calculates nv_bfloat16 maximum of two input values.

Description
Calculates nv_bfloat16 max(a, b) defined as (a > b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

[Link]
CUDA Math API vRelease Version | 108
 Modules

__device__ __nv_bfloat16 __hmax_nan (const __nv_bfloat16 a,

const __nv_bfloat16 b)
Calculates nv_bfloat16 maximum of two input values, NaNs pass through.

Description
Calculates nv_bfloat16 max(a, b) defined as (a > b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __nv_bfloat16 __hmin (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Calculates nv_bfloat16 minimum of two input values.

Description
Calculates nv_bfloat16 min(a, b) defined as (a < b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __nv_bfloat16 __hmin_nan (const __nv_bfloat16 a,

const __nv_bfloat16 b)
Calculates nv_bfloat16 minimum of two input values, NaNs pass through.

Description
Calculates nv_bfloat16 min(a, b) defined as (a < b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ bool __hne (const __nv_bfloat16 a, const __nv_bfloat16

b)
Performs nv_bfloat16 not-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

[Link]
CUDA Math API vRelease Version | 109
 Modules

Returns
bool

‣ The
boolean result of not-equal comparison of a and b.

Description
Performs nv_bfloat16 not-equal comparison of inputs a and b. NaN inputs generate
false results.

__device__ bool __hneu (const __nv_bfloat16 a, const

__nv_bfloat16 b)
Performs nv_bfloat16 unordered not-equal comparison.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
bool

‣ The
boolean result of unordered not-equal comparison of a and b.

Description
Performs nv_bfloat16 not-equal comparison of inputs a and b. NaN inputs generate
true results.

1.2.4. Bfloat162 Comparison Functions

Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

[Link]
CUDA Math API vRelease Version | 110
 Modules

__device__ bool __hbeq2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector if-equal comparison, and returns boolean true iff both
nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of if-equal comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector if-equal comparison of inputs a and b. The bool result
is set to true only if both nv_bfloat16 if-equal comparisons evaluate to true, or false
otherwise. NaN inputs generate false results.

__device__ bool __hbequ2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered if-equal comparison, and returns boolean
true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of unordered if-equal comparison of vectors a and b are
true;

[Link]
CUDA Math API vRelease Version | 111
 Modules

‣ falseotherwise.

Description
Performs nv_bfloat162 vector if-equal comparison of inputs a and b. The bool result
is set to true only if both nv_bfloat16 if-equal comparisons evaluate to true, or false
otherwise. NaN inputs generate true results.

__device__ bool __hbge2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector greater-equal comparison, and returns boolean true iff
both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of greater-equal comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector greater-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 greater-equal comparisons evaluate to
true, or false otherwise. NaN inputs generate false results.

__device__ bool __hbgeu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered greater-equal comparison, and returns
boolean true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 112
 Modules

Returns
bool

‣ trueif
both nv_bfloat16 results of unordered greater-equal comparison of vectors a and
b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector greater-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 greater-equal comparisons evaluate to
true, or false otherwise. NaN inputs generate true results.

__device__ bool __hbgt2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector greater-than comparison, and returns boolean true iff
both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of greater-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector greater-than comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 greater-than comparisons evaluate to
true, or false otherwise. NaN inputs generate false results.

[Link]
CUDA Math API vRelease Version | 113
 Modules

__device__ bool __hbgtu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered greater-than comparison, and returns
boolean true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of unordered greater-than comparison of vectors a and
b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector greater-than comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 greater-than comparisons evaluate to
true, or false otherwise. NaN inputs generate true results.

__device__ bool __hble2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector less-equal comparison, and returns boolean true iff
both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of less-equal comparison of vectors a and b are true;

[Link]
CUDA Math API vRelease Version | 114
 Modules

‣ falseotherwise.

Description
Performs nv_bfloat162 vector less-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 less-equal comparisons evaluate to true,
or false otherwise. NaN inputs generate false results.

__device__ bool __hbleu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered less-equal comparison, and returns boolean
true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of unordered less-equal comparison of vectors a and b
are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector less-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 less-equal comparisons evaluate to true,
or false otherwise. NaN inputs generate true results.

__device__ bool __hblt2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector less-than comparison, and returns boolean true iff both
nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 115
 Modules

b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of less-than comparison of vectors a and b are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector less-than comparison of inputs a and b. The bool result
is set to true only if both nv_bfloat16 less-than comparisons evaluate to true, or false
otherwise. NaN inputs generate false results.

__device__ bool __hbltu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered less-than comparison, and returns boolean
true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of unordered less-than comparison of vectors a and b
are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector less-than comparison of inputs a and b. The bool result
is set to true only if both nv_bfloat16 less-than comparisons evaluate to true, or false
otherwise. NaN inputs generate true results.

[Link]
CUDA Math API vRelease Version | 116
 Modules

__device__ bool __hbne2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector not-equal comparison, and returns boolean true iff
both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif
both nv_bfloat16 results of not-equal comparison of vectors a and b are true,
‣ false
otherwise.

Description
Performs nv_bfloat162 vector not-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 not-equal comparisons evaluate to true, or
false otherwise. NaN inputs generate false results.

__device__ bool __hbneu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered not-equal comparison, and returns boolean
true iff both nv_bfloat16 results are true, boolean false otherwise.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
bool

‣ trueif

[Link]
CUDA Math API vRelease Version | 117
 Modules

both nv_bfloat16 results of unordered not-equal comparison of vectors a and b

are true;
‣ falseotherwise.

Description
Performs nv_bfloat162 vector not-equal comparison of inputs a and b. The bool
result is set to true only if both nv_bfloat16 not-equal comparisons evaluate to true, or
false otherwise. NaN inputs generate true results.

__device__ __nv_bfloat162 __heq2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector if-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of if-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector if-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

__device__ __nv_bfloat162 __hequ2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered if-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 118
 Modules

Returns
nv_bfloat162

‣ The
vector result of unordered if-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector if-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

__device__ __nv_bfloat162 __hge2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector greater-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of greater-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector greater-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

__device__ __nv_bfloat162 __hgeu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered greater-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 119
 Modules

b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 vector result of unordered greater-equal comparison of vectors a
and b.

Description
Performs nv_bfloat162 vector greater-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

__device__ __nv_bfloat162 __hgt2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector greater-than comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of greater-than comparison of vectors a and b.

Description
Performs nv_bfloat162 vector greater-than comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

[Link]
CUDA Math API vRelease Version | 120
 Modules

__device__ __nv_bfloat162 __hgtu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered greater-than comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 vector result of unordered greater-than comparison of vectors a
and b.

Description
Performs nv_bfloat162 vector greater-than comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

__device__ __nv_bfloat162 __hisnan2 (const __nv_bfloat162 a)

Determine whether nv_bfloat162 argument is a NaN.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 with the corresponding nv_bfloat16 results set to 1.0 for for NaN,
0.0 otherwise.

Description
Determine whether each nv_bfloat16 of input nv_bfloat162 number a is a NaN.

[Link]
CUDA Math API vRelease Version | 121
 Modules

__device__ __nv_bfloat162 __hle2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector less-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 result of less-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector less-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

__device__ __nv_bfloat162 __hleu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered less-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of unordered less-equal comparison of vectors a and b.

[Link]
CUDA Math API vRelease Version | 122
 Modules

Description
Performs nv_bfloat162 vector less-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

__device__ __nv_bfloat162 __hlt2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector less-than comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 vector result of less-than comparison of vectors a and b.

Description
Performs nv_bfloat162 vector less-than comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

__device__ __nv_bfloat162 __hltu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered less-than comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The

[Link]
CUDA Math API vRelease Version | 123
 Modules

vector result of unordered less-than comparison of vectors a and b.

Description
Performs nv_bfloat162 vector less-than comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

__device__ __nv_bfloat162 __hmax2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Calculates nv_bfloat162 vector maximum of two inputs.

Description
Calculates nv_bfloat162 vector max(a, b) Elementwise nv_bfloat16 operation is
defined as (a > b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __nv_bfloat162 __hmax2_nan (const __nv_bfloat162 a,

const __nv_bfloat162 b)
Calculates nv_bfloat162 vector maximum of two inputs, NaNs pass through.

Description
Calculates nv_bfloat162 vector max(a, b) Elementwise nv_bfloat16 operation is
defined as (a > b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __nv_bfloat162 __hmin2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Calculates nv_bfloat162 vector minimum of two inputs.

Description
Calculates nv_bfloat162 vector min(a, b) Elementwise nv_bfloat16 operation is
defined as (a < b) ? a : b.

‣ If either of inputs is NaN, the other input is returned.

‣ If both inputs are NaNs, then canonical NaN is returned.
‣ If values of both inputs are 0.0, then +0.0 > -0.0

[Link]
CUDA Math API vRelease Version | 124
 Modules

__device__ __nv_bfloat162 __hmin2_nan (const __nv_bfloat162 a,

const __nv_bfloat162 b)
Calculates nv_bfloat162 vector minimum of two inputs, NaNs pass through.

Description
Calculates nv_bfloat162 vector min(a, b) Elementwise nv_bfloat16 operation is
defined as (a < b) ? a : b.

‣ If either of inputs is NaN, then canonical NaN is returned.

‣ If values of both inputs are 0.0, then +0.0 > -0.0

__device__ __nv_bfloat162 __hne2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector not-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of not-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector not-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate false results.

__device__ __nv_bfloat162 __hneu2 (const __nv_bfloat162 a, const

__nv_bfloat162 b)
Performs nv_bfloat162 vector unordered not-equal comparison.

Parameters
a
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 125
 Modules

b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector result of unordered not-equal comparison of vectors a and b.

Description
Performs nv_bfloat162 vector not-equal comparison of inputs a and b. The
corresponding nv_bfloat16 results are set to 1.0 for true, or 0.0 for false. NaN inputs
generate true results.

1.2.5. Bfloat16 Precision Conversion And Data

Movement
Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

__host____device__ float2 __bfloat1622float2 (const

__nv_bfloat162 a)
Converts both halves of nv_bfloat162 to float2 and returns the result.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
float2

‣ \p
a converted to float2.

Description
Converts both halves of nv_bfloat162 input a to float2 and returns the result.

[Link]
CUDA Math API vRelease Version | 126
 Modules

__device__ __nv_bfloat162 __bfloat162bfloat162 (const

__nv_bfloat16 a)
Returns nv_bfloat162 with both halves equal to the input value.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat162

‣ The
vector which has both its halves equal to the input a.

Description
Returns nv_bfloat162 number with both halves equal to the input a nv_bfloat16
number.

__host____device__ float __bfloat162float (const __nv_bfloat16 a)

Converts nv_bfloat16 number to float.

Parameters
a
- float. Is only being read.

Returns
float

‣ \p
a converted to float.

Description
Converts nv_bfloat16 number a to float.

[Link]
CUDA Math API vRelease Version | 127
 Modules

__device__ int __bfloat162int_rd (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed integer in round-
down mode.

__device__ int __bfloat162int_rn (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed integer in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 128
 Modules

__device__ int __bfloat162int_ru (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed integer in round-up
mode.

__device__ int __bfloat162int_rz (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
int

‣ \p
h converted to a signed integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed integer in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 129
 Modules

__device__ long long int __bfloat162ll_rd (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed 64-bit integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed 64-bit integer in
round-down mode.

__device__ long long int __bfloat162ll_rn (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed 64-bit integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed 64-bit integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 130
 Modules

__device__ long long int __bfloat162ll_ru (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed 64-bit integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed 64-bit integer in
round-up mode.

__device__ long long int __bfloat162ll_rz (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed 64-bit integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
long long int

‣ \p
h converted to a signed 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed 64-bit integer in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 131
 Modules

__device__ short int __bfloat162short_rd (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed short integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed short integer in
round-down mode.

__device__ short int __bfloat162short_rn (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed short integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed short integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 132
 Modules

__device__ short int __bfloat162short_ru (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed short integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed short integer in
round-up mode.

__device__ short int __bfloat162short_rz (__nv_bfloat16 h)

Convert a nv_bfloat16 to a signed short integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
short int

‣ \p
h converted to a signed short integer.

Description
Convert the nv_bfloat16-precision floating point value h to a signed short integer in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 133
 Modules

__device__ unsigned int __bfloat162uint_rd (__nv_bfloat16 h)

Convert a nv_bfloat16 to an unsigned integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned integer in
round-down mode.

__device__ unsigned int __bfloat162uint_rn (__nv_bfloat16 h)

Convert a nv_bfloat16 to an unsigned integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 134
 Modules

__device__ unsigned int __bfloat162uint_ru (__nv_bfloat16 h)

Convert a nv_bfloat16 to an unsigned integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned integer in
round-up mode.

__device__ unsigned int __bfloat162uint_rz (__nv_bfloat16 h)

Convert a nv_bfloat16 to an unsigned integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned int

‣ \p
h converted to an unsigned integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned integer in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 135
 Modules

__device__ unsigned long long int __bfloat162ull_rd (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned 64-bit integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned 64-bit integer in
round-down mode.

__device__ unsigned long long int __bfloat162ull_rn (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned 64-bit integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned 64-bit integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 136
 Modules

__device__ unsigned long long int __bfloat162ull_ru (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned 64-bit integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned 64-bit integer in
round-up mode.

__device__ unsigned long long int __bfloat162ull_rz (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned 64-bit integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned long long int

‣ \p
h converted to an unsigned 64-bit integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned 64-bit integer in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 137
 Modules

__device__ unsigned short int __bfloat162ushort_rd (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned short integer in round-down mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned short integer in
round-down mode.

__device__ unsigned short int __bfloat162ushort_rn (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned short integer in round-to-nearest-even mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned short integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 138
 Modules

__device__ unsigned short int __bfloat162ushort_ru (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned short integer in round-up mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an an unsigned short integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned short integer in
round-up mode.

__device__ unsigned short int __bfloat162ushort_rz (__nv_bfloat16

h)
Convert a nv_bfloat16 to an unsigned short integer in round-towards-zero mode.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned short int

‣ \p
h converted to an unsigned short integer.

Description
Convert the nv_bfloat16-precision floating point value h to an unsigned short integer in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 139
 Modules

__device__ short int __bfloat16_as_short (const __nv_bfloat16 h)

Reinterprets bits in a nv_bfloat16 as a signed short integer.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
short int

‣ The
reinterpreted value.

Description
Reinterprets the bits in the nv_bfloat16-precision floating point number h as a signed
short integer.

__device__ unsigned short int __bfloat16_as_ushort (const

__nv_bfloat16 h)
Reinterprets bits in a nv_bfloat16 as an unsigned short integer.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
unsigned short int

‣ The
reinterpreted value.

Description
Reinterprets the bits in the nv_bfloat16-precision floating point h as an unsigned short
number.

[Link]
CUDA Math API vRelease Version | 140
 Modules

__host____device__ __nv_bfloat16 __double2bfloat16 (const double

a)
Converts double number to nv_bfloat16 precision in round-to-nearest-even mode and
returns nv_bfloat16 with converted value.

Parameters
a
- double. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts double number a to nv_bfloat16 precision in round-to-nearest-even mode.

__host____device__ __nv_bfloat162 __float22bfloat162_rn (const

float2 a)
Converts both components of float2 number to nv_bfloat16 precision in round-to-
nearest-even mode and returns nv_bfloat162 with converted values.

Parameters
a
- float2. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 which has corresponding halves equal to the converted float2
components.

Description
Converts both components of float2 to nv_bfloat16 precision in round-to-nearest mode
and combines the results into one nv_bfloat162 number. Low 16 bits of the return
value correspond to a.x and high 16 bits of the return value correspond to a.y.

[Link]
CUDA Math API vRelease Version | 141
 Modules

__host____device__ __nv_bfloat16 __float2bfloat16 (const float a)

Converts float number to nv_bfloat16 precision in round-to-nearest-even mode and
returns nv_bfloat16 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts float number a to nv_bfloat16 precision in round-to-nearest-even mode.

__host____device__ __nv_bfloat162 __float2bfloat162_rn (const

float a)
Converts input to nv_bfloat16 precision in round-to-nearest-even mode and populates
both halves of nv_bfloat162 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 value with both halves equal to the converted nv_bfloat16 precision
number.

Description
Converts input a to nv_bfloat16 precision in round-to-nearest-even mode and populates
both halves of nv_bfloat162 with converted value.

[Link]
CUDA Math API vRelease Version | 142
 Modules

__host____device__ __nv_bfloat16 __float2bfloat16_rd (const float

a)
Converts float number to nv_bfloat16 precision in round-down mode and returns
nv_bfloat16 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts float number a to nv_bfloat16 precision in round-down mode.

__host____device__ __nv_bfloat16 __float2bfloat16_rn (const float

a)
Converts float number to nv_bfloat16 precision in round-to-nearest-even mode and
returns nv_bfloat16 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts float number a to nv_bfloat16 precision in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 143
 Modules

__host____device__ __nv_bfloat16 __float2bfloat16_ru (const float

a)
Converts float number to nv_bfloat16 precision in round-up mode and returns
nv_bfloat16 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts float number a to nv_bfloat16 precision in round-up mode.

__host____device__ __nv_bfloat16 __float2bfloat16_rz (const float

a)
Converts float number to nv_bfloat16 precision in round-towards-zero mode and
returns nv_bfloat16 with converted value.

Parameters
a
- float. Is only being read.

Returns
nv_bfloat16

‣ \p
a converted to nv_bfloat16.

Description
Converts float number a to nv_bfloat16 precision in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 144
 Modules

__host____device__ __nv_bfloat162 __floats2bfloat162_rn (const

float a, const float b)
Converts both input floats to nv_bfloat16 precision in round-to-nearest-even mode and
returns nv_bfloat162 with converted values.

Parameters
a
- float. Is only being read.
b
- float. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 value with corresponding halves equal to the converted input
floats.

Description
Converts both input floats to nv_bfloat16 precision in round-to-nearest-even mode and
combines the results into one nv_bfloat162 number. Low 16 bits of the return value
correspond to the input a, high 16 bits correspond to the input b.

__device__ __nv_bfloat162 __halves2bfloat162 (const __nv_bfloat16

a, const __nv_bfloat16 b)
Combines two nv_bfloat16 numbers into one nv_bfloat162 number.

Parameters
a
- nv_bfloat16. Is only being read.
b
- nv_bfloat16. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 with one nv_bfloat16 equal to a and the other to b.

[Link]
CUDA Math API vRelease Version | 145
 Modules

Description
Combines two input nv_bfloat16 number a and b into one nv_bfloat162 number.
Input a is stored in low 16 bits of the return value, input b is stored in high 16 bits of the
return value.

__device__ __nv_bfloat16 __high2bfloat16 (const __nv_bfloat162 a)

Returns high 16 bits of nv_bfloat162 input.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat16

‣ The
high 16 bits of the input.

Description
Returns high 16 bits of nv_bfloat162 input a.

__device__ __nv_bfloat162 __high2bfloat162 (const __nv_bfloat162

a)
Extracts high 16 bits from nv_bfloat162 input.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 with both halves equal to the high 16 bits of the input.

Description
Extracts high 16 bits from nv_bfloat162 input a and returns a new nv_bfloat162
number which has both halves equal to the extracted bits.

[Link]
CUDA Math API vRelease Version | 146
 Modules

__host____device__ float __high2float (const __nv_bfloat162 a)

Converts high 16 bits of nv_bfloat162 to float and returns the result.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
float

‣ The
high 16 bits of a converted to float.

Description
Converts high 16 bits of nv_bfloat162 input a to 32 bit floating point number and
returns the result.

__device__ __nv_bfloat162 __highs2bfloat162 (const __nv_bfloat162

a, const __nv_bfloat162 b)
Extracts high 16 bits from each of the two nv_bfloat162 inputs and combines into one
nv_bfloat162 number.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
high 16 bits of a and of b.

Description
Extracts high 16 bits from each of the two nv_bfloat162 inputs and combines into one
nv_bfloat162 number. High 16 bits from input a is stored in low 16 bits of the return
value, high 16 bits from input b is stored in high 16 bits of the return value.

[Link]
CUDA Math API vRelease Version | 147
 Modules

__device__ __nv_bfloat16 __int2bfloat16_rd (int i)

Convert a signed integer to a nv_bfloat16 in round-down mode.

Parameters
i
- int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed integer value i to a nv_bfloat16-precision floating point value in
round-down mode.

__device__ __nv_bfloat16 __int2bfloat16_rn (int i)

Convert a signed integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed integer value i to a nv_bfloat16-precision floating point value in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 148
 Modules

__device__ __nv_bfloat16 __int2bfloat16_ru (int i)

Convert a signed integer to a nv_bfloat16 in round-up mode.

Parameters
i
- int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed integer value i to a nv_bfloat16-precision floating point value in
round-up mode.

__device__ __nv_bfloat16 __int2bfloat16_rz (int i)

Convert a signed integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed integer value i to a nv_bfloat16-precision floating point value in
round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 149
 Modules

__device__ __nv_bfloat16 __ldca (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldca (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat16 __ldcg (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldcg (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 150
 Modules

__device__ __nv_bfloat16 __ldcs (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldcs (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat16 __ldcv (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldcv (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 151
 Modules

__device__ __nv_bfloat16 __ldg (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldg (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat16 __ldlu (const __nv_bfloat16 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

__device__ __nv_bfloat162 __ldlu (const __nv_bfloat162 *ptr)

Generates a `[Link]` load instruction.

Parameters
ptr
- memory location

Returns
The value pointed by `ptr`

[Link]
CUDA Math API vRelease Version | 152
 Modules

__device__ __nv_bfloat16 __ll2bfloat16_rd (long long int i)

Convert a signed 64-bit integer to a nv_bfloat16 in round-down mode.

Parameters
i
- long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed 64-bit integer value i to a nv_bfloat16-precision floating point value
in round-down mode.

__device__ __nv_bfloat16 __ll2bfloat16_rn (long long int i)

Convert a signed 64-bit integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed 64-bit integer value i to a nv_bfloat16-precision floating point value
in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 153
 Modules

__device__ __nv_bfloat16 __ll2bfloat16_ru (long long int i)

Convert a signed 64-bit integer to a nv_bfloat16 in round-up mode.

Parameters
i
- long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed 64-bit integer value i to a nv_bfloat16-precision floating point value
in round-up mode.

__device__ __nv_bfloat16 __ll2bfloat16_rz (long long int i)

Convert a signed 64-bit integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed 64-bit integer value i to a nv_bfloat16-precision floating point value
in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 154
 Modules

__device__ __nv_bfloat16 __low2bfloat16 (const __nv_bfloat162 a)

Returns low 16 bits of nv_bfloat162 input.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat16

‣ Returns
nv_bfloat16 which contains low 16 bits of the input a.

Description
Returns low 16 bits of nv_bfloat162 input a.

__device__ __nv_bfloat162 __low2bfloat162 (const __nv_bfloat162

a)
Extracts low 16 bits from nv_bfloat162 input.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
nv_bfloat162 with both halves equal to the low 16 bits of the input.

Description
Extracts low 16 bits from nv_bfloat162 input a and returns a new nv_bfloat162
number which has both halves equal to the extracted bits.

[Link]
CUDA Math API vRelease Version | 155
 Modules

__host____device__ float __low2float (const __nv_bfloat162 a)

Converts low 16 bits of nv_bfloat162 to float and returns the result.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
float

‣ The
low 16 bits of a converted to float.

Description
Converts low 16 bits of nv_bfloat162 input a to 32 bit floating point number and
returns the result.

__device__ __nv_bfloat162 __lowhigh2highlow (const

__nv_bfloat162 a)
Swaps both halves of the nv_bfloat162 input.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ \p
a with its halves being swapped.

Description
Swaps both halves of the nv_bfloat162 input and returns a new nv_bfloat162
number with swapped halves.

[Link]
CUDA Math API vRelease Version | 156
 Modules

__device__ __nv_bfloat162 __lows2bfloat162 (const __nv_bfloat162

a, const __nv_bfloat162 b)
Extracts low 16 bits from each of the two nv_bfloat162 inputs and combines into one
nv_bfloat162 number.

Parameters
a
- nv_bfloat162. Is only being read.
b
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
low 16 bits of a and of b.

Description
Extracts low 16 bits from each of the two nv_bfloat162 inputs and combines into one
nv_bfloat162 number. Low 16 bits from input a is stored in low 16 bits of the return
value, low 16 bits from input b is stored in high 16 bits of the return value.

__device__ __nv_bfloat16 __shfl_down_sync (unsigned mask,

__nv_bfloat16 var, unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with higher ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat16. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

[Link]
CUDA Math API vRelease Version | 157
 Modules

Returns
Returns the 2-byte word referenced by var from the source thread ID as nv_bfloat16. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by adding delta to the caller's thread ID. The value
of var held by the resulting thread ID is returned: this has the effect of shifting var
down the warp by delta threads. If width is less than warpSize then each subsection
of the warp behaves as a separate entity with a starting logical thread ID of 0. As for
__shfl_up_sync(), the ID number of the source thread will not wrap around the value of
width and so the upper delta threads will remain unchanged.

__device__ __nv_bfloat162 __shfl_down_sync (unsigned mask,

__nv_bfloat162 var, unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with higher ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat162. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as nv_bfloat162. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by adding delta to the caller's thread ID. The value
of var held by the resulting thread ID is returned: this has the effect of shifting var
down the warp by delta threads. If width is less than warpSize then each subsection
of the warp behaves as a separate entity with a starting logical thread ID of 0. As for
__shfl_up_sync(), the ID number of the source thread will not wrap around the value of
width and so the upper delta threads will remain unchanged.

[Link]
CUDA Math API vRelease Version | 158
 Modules

__device__ __nv_bfloat16 __shfl_sync (unsigned mask,

__nv_bfloat16 var, int delta, int width)
Exchange a variable between threads within a warp. Direct copy from indexed thread.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat16. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as nv_bfloat16. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Returns the value of var held by the thread whose ID is given by delta. If width is less
than warpSize then each subsection of the warp behaves as a separate entity with a
starting logical thread ID of 0. If delta is outside the range [0:width-1], the value returned
corresponds to the value of var held by the delta modulo width (i.e. ithin the same
subsection). width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __nv_bfloat162 __shfl_sync (unsigned mask,

__nv_bfloat162 var, int delta, int width)
Exchange a variable between threads within a warp. Direct copy from indexed thread.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat162. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

[Link]
CUDA Math API vRelease Version | 159
 Modules

Returns
Returns the 4-byte word referenced by var from the source thread ID as nv_bfloat162. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Returns the value of var held by the thread whose ID is given by delta. If width is less
than warpSize then each subsection of the warp behaves as a separate entity with a
starting logical thread ID of 0. If delta is outside the range [0:width-1], the value returned
corresponds to the value of var held by the delta modulo width (i.e. ithin the same
subsection). width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __nv_bfloat16 __shfl_up_sync (unsigned mask,

__nv_bfloat16 var, unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with lower ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat16. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as nv_bfloat16. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by subtracting delta from the caller's lane ID. The value
of var held by the resulting lane ID is returned: in effect, var is shifted up the warp by
delta threads. If width is less than warpSize then each subsection of the warp behaves
as a separate entity with a starting logical thread ID of 0. The source thread index
will not wrap around the value of width, so effectively the lower delta threads will be
unchanged. width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

[Link]
CUDA Math API vRelease Version | 160
 Modules

__device__ __nv_bfloat162 __shfl_up_sync (unsigned mask,

__nv_bfloat162 var, unsigned int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread with lower ID
relative to the caller.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat162. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as nv_bfloat162. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by subtracting delta from the caller's lane ID. The value
of var held by the resulting lane ID is returned: in effect, var is shifted up the warp by
delta threads. If width is less than warpSize then each subsection of the warp behaves
as a separate entity with a starting logical thread ID of 0. The source thread index
will not wrap around the value of width, so effectively the lower delta threads will be
unchanged. width must have a value which is a power of 2; results are undefined if
width is not a power of 2, or is a number greater than warpSize.

__device__ __nv_bfloat16 __shfl_xor_sync (unsigned mask,

__nv_bfloat16 var, int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread based on
bitwise XOR of own thread ID.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat16. Is only being read.
delta
- int. Is only being read.

[Link]
CUDA Math API vRelease Version | 161
 Modules

width
- int. Is only being read.

Returns
Returns the 2-byte word referenced by var from the source thread ID as nv_bfloat16. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with
mask: the value of var held by the resulting thread ID is returned. If width is less than
warpSize then each group of width consecutive threads are able to access elements from
earlier groups of threads, however if they attempt to access elements from later groups
of threads their own value of var will be returned. This mode implements a butterfly
addressing pattern such as is used in tree reduction and broadcast.

__device__ __nv_bfloat162 __shfl_xor_sync (unsigned mask,

__nv_bfloat162 var, int delta, int width)
Exchange a variable between threads within a warp. Copy from a thread based on
bitwise XOR of own thread ID.

Parameters
mask
- unsigned int. Is only being read.
var
- nv_bfloat162. Is only being read.
delta
- int. Is only being read.
width
- int. Is only being read.

Returns
Returns the 4-byte word referenced by var from the source thread ID as nv_bfloat162. If
the source thread ID is out of range or the source thread has exited, the calling thread's
own var is returned.

Description
Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with
mask: the value of var held by the resulting thread ID is returned. If width is less than
warpSize then each group of width consecutive threads are able to access elements from
earlier groups of threads, however if they attempt to access elements from later groups

[Link]
CUDA Math API vRelease Version | 162
 Modules

of threads their own value of var will be returned. This mode implements a butterfly
addressing pattern such as is used in tree reduction and broadcast.

__device__ __nv_bfloat16 __short2bfloat16_rd (short int i)

Convert a signed short integer to a nv_bfloat16 in round-down mode.

Parameters
i
- short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed short integer value i to a nv_bfloat16-precision floating point value
in round-down mode.

__device__ __nv_bfloat16 __short2bfloat16_rn (short int i)

Convert a signed short integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed short integer value i to a nv_bfloat16-precision floating point value
in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 163
 Modules

__device__ __nv_bfloat16 __short2bfloat16_ru (short int i)

Convert a signed short integer to a nv_bfloat16 in round-up mode.

Parameters
i
- short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed short integer value i to a nv_bfloat16-precision floating point value
in round-up mode.

__device__ __nv_bfloat16 __short2bfloat16_rz (short int i)

Convert a signed short integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the signed short integer value i to a nv_bfloat16-precision floating point value
in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 164
 Modules

__device__ __nv_bfloat16 __short_as_bfloat16 (const short int i)

Reinterprets bits in a signed short integer as a nv_bfloat16.

Parameters
i
- short int. Is only being read.

Returns
nv_bfloat16

‣ The
reinterpreted value.

Description
Reinterprets the bits in the signed short integer i as a nv_bfloat16-precision floating
point number.

__device__ void __stcg (__nv_bfloat16 *ptr, __nv_bfloat16 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stcg (__nv_bfloat162 *ptr, __nv_bfloat162 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

[Link]
CUDA Math API vRelease Version | 165
 Modules

__device__ void __stcs (__nv_bfloat16 *ptr, __nv_bfloat16 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stcs (__nv_bfloat162 *ptr, __nv_bfloat162 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwb (__nv_bfloat16 *ptr, __nv_bfloat16 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwb (__nv_bfloat162 *ptr, __nv_bfloat162 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

[Link]
CUDA Math API vRelease Version | 166
 Modules

__device__ void __stwt (__nv_bfloat16 *ptr, __nv_bfloat16 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ void __stwt (__nv_bfloat162 *ptr, __nv_bfloat162 value)

Generates a `[Link]` store instruction.

Parameters
ptr
- memory location
value
- the value to be stored

__device__ __nv_bfloat16 __uint2bfloat16_rd (unsigned int i)

Convert an unsigned integer to a nv_bfloat16 in round-down mode.

Parameters
i
- unsigned int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned integer value i to a nv_bfloat16-precision floating point value in
round-down mode.

[Link]
CUDA Math API vRelease Version | 167
 Modules

__device__ __nv_bfloat16 __uint2bfloat16_rn (unsigned int i)

Convert an unsigned integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- unsigned int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned integer value i to a nv_bfloat16-precision floating point value in
round-to-nearest-even mode.

__device__ __nv_bfloat16 __uint2bfloat16_ru (unsigned int i)

Convert an unsigned integer to a nv_bfloat16 in round-up mode.

Parameters
i
- unsigned int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned integer value i to a nv_bfloat16-precision floating point value in
round-up mode.

[Link]
CUDA Math API vRelease Version | 168
 Modules

__device__ __nv_bfloat16 __uint2bfloat16_rz (unsigned int i)

Convert an unsigned integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- unsigned int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned integer value i to a nv_bfloat16-precision floating point value in
round-towards-zero mode.

__device__ __nv_bfloat16 __ull2bfloat16_rd (unsigned long long int

i)
Convert an unsigned 64-bit integer to a nv_bfloat16 in round-down mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned 64-bit integer value i to a nv_bfloat16-precision floating point
value in round-down mode.

[Link]
CUDA Math API vRelease Version | 169
 Modules

__device__ __nv_bfloat16 __ull2bfloat16_rn (unsigned long long int

i)
Convert an unsigned 64-bit integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned 64-bit integer value i to a nv_bfloat16-precision floating point
value in round-to-nearest-even mode.

__device__ __nv_bfloat16 __ull2bfloat16_ru (unsigned long long int

i)
Convert an unsigned 64-bit integer to a nv_bfloat16 in round-up mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned 64-bit integer value i to a nv_bfloat16-precision floating point
value in round-up mode.

[Link]
CUDA Math API vRelease Version | 170
 Modules

__device__ __nv_bfloat16 __ull2bfloat16_rz (unsigned long long int

i)
Convert an unsigned 64-bit integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- unsigned long long int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned 64-bit integer value i to a nv_bfloat16-precision floating point
value in round-towards-zero mode.

__device__ __nv_bfloat16 __ushort2bfloat16_rd (unsigned short int

i)
Convert an unsigned short integer to a nv_bfloat16 in round-down mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned short integer value i to a nv_bfloat16-precision floating point
value in round-down mode.

[Link]
CUDA Math API vRelease Version | 171
 Modules

__device__ __nv_bfloat16 __ushort2bfloat16_rn (unsigned short int

i)
Convert an unsigned short integer to a nv_bfloat16 in round-to-nearest-even mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned short integer value i to a nv_bfloat16-precision floating point
value in round-to-nearest-even mode.

__device__ __nv_bfloat16 __ushort2bfloat16_ru (unsigned short int

i)
Convert an unsigned short integer to a nv_bfloat16 in round-up mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned short integer value i to a nv_bfloat16-precision floating point
value in round-up mode.

[Link]
CUDA Math API vRelease Version | 172
 Modules

__device__ __nv_bfloat16 __ushort2bfloat16_rz (unsigned short int

i)
Convert an unsigned short integer to a nv_bfloat16 in round-towards-zero mode.

Parameters
i
- unsigned short int. Is only being read.

Returns
nv_bfloat16

‣ \p
i converted to nv_bfloat16.

Description
Convert the unsigned short integer value i to a nv_bfloat16-precision floating point
value in round-towards-zero mode.

__device__ __nv_bfloat16 __ushort_as_bfloat16 (const unsigned

short int i)
Reinterprets bits in an unsigned short integer as a nv_bfloat16.

Parameters
i
- unsigned short int. Is only being read.

Returns
nv_bfloat16

‣ The
reinterpreted value.

Description
Reinterprets the bits in the unsigned short integer i as a nv_bfloat16-precision floating
point number.

1.2.6. Bfloat16 Math Functions

Bfloat16 Precision Intrinsics

[Link]
CUDA Math API vRelease Version | 173
 Modules

To use these functions include the header file cuda_bf16.h in your program.

__device__ __nv_bfloat16 hceil (const __nv_bfloat16 h)

Calculate ceiling of the input argument.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
smallest integer value not less than h.

Description
Compute the smallest integer value not less than h.

__device__ __nv_bfloat16 hcos (const __nv_bfloat16 a)

Calculates nv_bfloat16 cosine in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
cosine of a.

Description
Calculates nv_bfloat16 cosine of input a in round-to-nearest-even mode.

__device__ __nv_bfloat16 hexp (const __nv_bfloat16 a)

Calculates nv_bfloat16 natural exponential function in round-to-nearest mode.

Parameters
a
- nv_bfloat16. Is only being read.

[Link]
CUDA Math API vRelease Version | 174
 Modules

Returns
nv_bfloat16

‣ The
natural exponential function on a.

Description
Calculates nv_bfloat16 natural exponential function of input a in round-to-nearest-
even mode.

__device__ __nv_bfloat16 hexp10 (const __nv_bfloat16 a)

Calculates nv_bfloat16 decimal exponential function in round-to-nearest mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
decimal exponential function on a.

Description
Calculates nv_bfloat16 decimal exponential function of input a in round-to-nearest-
even mode.

__device__ __nv_bfloat16 hexp2 (const __nv_bfloat16 a)

Calculates nv_bfloat16 binary exponential function in round-to-nearest mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
binary exponential function on a.

[Link]
CUDA Math API vRelease Version | 175
 Modules

Description
Calculates nv_bfloat16 binary exponential function of input a in round-to-nearest-
even mode.

__device__ __nv_bfloat16 hfloor (const __nv_bfloat16 h)

Calculate the largest integer less than or equal to h.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
largest integer value which is less than or equal to h.

Description
Calculate the largest integer value which is less than or equal to h.

__device__ __nv_bfloat16 hlog (const __nv_bfloat16 a)

Calculates nv_bfloat16 natural logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
natural logarithm of a.

Description
Calculates nv_bfloat16 natural logarithm of input a in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 176
 Modules

__device__ __nv_bfloat16 hlog10 (const __nv_bfloat16 a)

Calculates nv_bfloat16 decimal logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
decimal logarithm of a.

Description
Calculates nv_bfloat16 decimal logarithm of input a in round-to-nearest-even mode.

__device__ __nv_bfloat16 hlog2 (const __nv_bfloat16 a)

Calculates nv_bfloat16 binary logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
binary logarithm of a.

Description
Calculates nv_bfloat16 binary logarithm of input a in round-to-nearest-even mode.

__device__ __nv_bfloat16 hrcp (const __nv_bfloat16 a)

Calculates nv_bfloat16 reciprocal in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

[Link]
CUDA Math API vRelease Version | 177
 Modules

Returns
nv_bfloat16

‣ The
reciprocal of a.

Description
Calculates nv_bfloat16 reciprocal of input a in round-to-nearest-even mode.

__device__ __nv_bfloat16 hrint (const __nv_bfloat16 h)

Round input to nearest integer value in nv_bfloat16-precision floating point number.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
nearest integer to h.

Description
Round h to the nearest integer value in nv_bfloat16-precision floating point format, with
bfloat16way cases rounded to the nearest even integer value.

__device__ __nv_bfloat16 hrsqrt (const __nv_bfloat16 a)

Calculates nv_bfloat16 reciprocal square root in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
reciprocal square root of a.

[Link]
CUDA Math API vRelease Version | 178
 Modules

Description
Calculates nv_bfloat16 reciprocal square root of input a in round-to-nearest mode.

__device__ __nv_bfloat16 hsin (const __nv_bfloat16 a)

Calculates nv_bfloat16 sine in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
sine of a.

Description
Calculates nv_bfloat16 sine of input a in round-to-nearest-even mode.

__device__ __nv_bfloat16 hsqrt (const __nv_bfloat16 a)

Calculates nv_bfloat16 square root in round-to-nearest-even mode.

Parameters
a
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
square root of a.

Description
Calculates nv_bfloat16 square root of input a in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 179
 Modules

__device__ __nv_bfloat16 htrunc (const __nv_bfloat16 h)

Truncate input argument to the integral part.

Parameters
h
- nv_bfloat16. Is only being read.

Returns
nv_bfloat16

‣ The
truncated integer value.

Description
Round h to the nearest integer value that does not exceed h in magnitude.

1.2.7. Bfloat162 Math Functions

Bfloat16 Precision Intrinsics
To use these functions include the header file cuda_bf16.h in your program.

__device__ __nv_bfloat162 h2ceil (const __nv_bfloat162 h)

Calculate nv_bfloat162 vector ceiling of the input argument.

Parameters
h
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector of smallest integers not less than h.

Description
For each component of vector h compute the smallest integer value not less than h.

[Link]
CUDA Math API vRelease Version | 180
 Modules

__device__ __nv_bfloat162 h2cos (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector cosine in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise cosine on vector a.

Description
Calculates nv_bfloat162 cosine of input vector a in round-to-nearest-even mode.

__device__ __nv_bfloat162 h2exp (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector exponential function in round-to-nearest mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise exponential function on vector a.

Description
Calculates nv_bfloat162 exponential function of input vector a in round-to-nearest-
even mode.

[Link]
CUDA Math API vRelease Version | 181
 Modules

__device__ __nv_bfloat162 h2exp10 (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector decimal exponential function in round-to-nearest-
even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise decimal exponential function on vector a.

Description
Calculates nv_bfloat162 decimal exponential function of input vector a in round-to-
nearest-even mode.

__device__ __nv_bfloat162 h2exp2 (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector binary exponential function in round-to-nearest-even
mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise binary exponential function on vector a.

Description
Calculates nv_bfloat162 binary exponential function of input vector a in round-to-
nearest-even mode.

[Link]
CUDA Math API vRelease Version | 182
 Modules

__device__ __nv_bfloat162 h2floor (const __nv_bfloat162 h)

Calculate the largest integer less than or equal to h.

Parameters
h
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector of largest integers which is less than or equal to h.

Description
For each component of vector h calculate the largest integer value which is less than or
equal to h.

__device__ __nv_bfloat162 h2log (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector natural logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise natural logarithm on vector a.

Description
Calculates nv_bfloat162 natural logarithm of input vector a in round-to-nearest-even
mode.

[Link]
CUDA Math API vRelease Version | 183
 Modules

__device__ __nv_bfloat162 h2log10 (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector decimal logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise decimal logarithm on vector a.

Description
Calculates nv_bfloat162 decimal logarithm of input vector a in round-to-nearest-even
mode.

__device__ __nv_bfloat162 h2log2 (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector binary logarithm in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise binary logarithm on vector a.

Description
Calculates nv_bfloat162 binary logarithm of input vector a in round-to-nearest mode.

__device__ __nv_bfloat162 h2rcp (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector reciprocal in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

[Link]
CUDA Math API vRelease Version | 184
 Modules

Returns
nv_bfloat162

‣ The
elementwise reciprocal on vector a.

Description
Calculates nv_bfloat162 reciprocal of input vector a in round-to-nearest-even mode.

__device__ __nv_bfloat162 h2rint (const __nv_bfloat162 h)

Round input to nearest integer value in nv_bfloat16-precision floating point number.

Parameters
h
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
vector of rounded integer values.

Description
Round each component of nv_bfloat162 vector h to the nearest integer value in
nv_bfloat16-precision floating point format, with bfloat16way cases rounded to the
nearest even integer value.

__device__ __nv_bfloat162 h2rsqrt (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector reciprocal square root in round-to-nearest mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise reciprocal square root on vector a.

[Link]
CUDA Math API vRelease Version | 185
 Modules

Description
Calculates nv_bfloat162 reciprocal square root of input vector a in round-to-nearest-
even mode.

__device__ __nv_bfloat162 h2sin (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector sine in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise sine on vector a.

Description
Calculates nv_bfloat162 sine of input vector a in round-to-nearest-even mode.

__device__ __nv_bfloat162 h2sqrt (const __nv_bfloat162 a)

Calculates nv_bfloat162 vector square root in round-to-nearest-even mode.

Parameters
a
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
elementwise square root on vector a.

Description
Calculates nv_bfloat162 square root of input vector a in round-to-nearest mode.

[Link]
CUDA Math API vRelease Version | 186
 Modules

__device__ __nv_bfloat162 h2trunc (const __nv_bfloat162 h)

Truncate nv_bfloat162 vector input argument to the integral part.

Parameters
h
- nv_bfloat162. Is only being read.

Returns
nv_bfloat162

‣ The
truncated h.

Description
Round each component of vector h to the nearest integer value that does not exceed h in
magnitude.

1.3. Mathematical Functions

CUDA mathematical functions are always available in device code. Some functions are
also available in host code as indicated.
Note that floating-point functions are overloaded for different argument types. For
example, the log() function has the following prototypes:
‎ double log(double x);
float log(float x);
float logf(float x);

1.4. Single Precision Mathematical Functions

This section describes single precision mathematical functions. To use these functions
you do not need to include any additional header files in your program.

__device__ float acosf (float x)

Calculate the arc cosine of the input argument.

Returns
Result will be in radians, in the interval [0, ] for x inside [-1, +1].

‣ acosf(1) returns +0.

[Link]
CUDA Math API vRelease Version | 187
 Modules

‣ acosf(x) returns NaN for x outside [-1, +1].

Description
Calculate the principal value of the arc cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float acoshf (float x)

Calculate the nonnegative arc hyperbolic cosine of the input argument.

Returns
Result will be in the interval [0, ].

‣ acoshf(1) returns 0.
‣ acoshf(x) returns NaN for x in the interval [ , 1).

Description
Calculate the nonnegative arc hyperbolic cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float asinf (float x)

Calculate the arc sine of the input argument.

Returns

Result will be in radians, in the interval [- ,+ ] for x inside [-1, +1].

‣ asinf(0) returns +0.

‣ asinf(x) returns NaN for x outside [-1, +1].

Description
Calculate the principal value of the arc sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 188
 Modules

__device__ float asinhf (float x)

Calculate the arc hyperbolic sine of the input argument.

Returns
‣ asinhf(0) returns 1.

Description
Calculate the arc hyperbolic sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float atan2f (float y, float x)

Calculate the arc tangent of the ratio of first and second input arguments.

Returns
Result will be in radians, in the interval [- ,+ ].

‣ atan2f(0, 1) returns +0.

Description
Calculate the principal value of the arc tangent of the ratio of first and second input
arguments y / x. The quadrant of the result is determined by the signs of inputs y and x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float atanf (float x)

Calculate the arc tangent of the input argument.

Returns

Result will be in radians, in the interval [- ,+ ].

‣ atanf(0) returns +0.

Description
Calculate the principal value of the arc tangent of the input argument x.

[Link]
CUDA Math API vRelease Version | 189
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float atanhf (float x)

Calculate the arc hyperbolic tangent of the input argument.

Returns
‣ atanhf( ) returns .
‣ atanhf( ) returns .
‣ atanhf(x) returns NaN for x outside interval [-1, 1].

Description
Calculate the arc hyperbolic tangent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float cbrtf (float x)

Calculate the cube root of the input argument.

Returns

Returns .

‣ cbrtf( ) returns .
‣ cbrtf( ) returns .

Description

Calculate the cube root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 190
 Modules

__device__ float ceilf (float x)

Calculate ceiling of the input argument.

Returns
Returns expressed as a floating-point number.

‣ ceilf( ) returns .
‣ ceilf( ) returns .

Description
Compute the smallest integer value not less than x.

__device__ float copysignf (float x, float y)

Create value with given magnitude, copying sign of second value.

Returns
Returns a value with the magnitude of x and the sign of y.

Description
Create a floating-point value with the magnitude x and the sign of y.

__device__ float cosf (float x)

Calculate the cosine of the input argument.

Returns
‣ cosf(0) returns 1.
‣ cosf( ) returns NaN.

Description
Calculate the cosine of the input argument x (measured in radians).

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

[Link]
CUDA Math API vRelease Version | 191
 Modules

__device__ float coshf (float x)

Calculate the hyperbolic cosine of the input argument.

Returns
‣ coshf(0) returns 1.
‣ coshf( ) returns NaN.

Description
Calculate the hyperbolic cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float cospif (float x)

Calculate the cosine of the input argument .

Returns
‣ cospif( ) returns 1.
‣ cospif( ) returns NaN.

Description
Calculate the cosine of x (measured in radians), where x is the input argument.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float cyl_bessel_i0f (float x)

Calculate the value of the regular modified cylindrical Bessel function of order 0 for the
input argument.

Returns
Returns the value of the regular modified cylindrical Bessel function of order 0.

Description
Calculate the value of the regular modified cylindrical Bessel function of order 0 for the
input argument x, .

[Link]
CUDA Math API vRelease Version | 192
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float cyl_bessel_i1f (float x)

Calculate the value of the regular modified cylindrical Bessel function of order 1 for the
input argument.

Returns
Returns the value of the regular modified cylindrical Bessel function of order 1.

Description
Calculate the value of the regular modified cylindrical Bessel function of order 1 for the
input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float erfcf (float x)

Calculate the complementary error function of the input argument.

Returns
‣ erfcf( ) returns 2.
‣ erfcf( ) returns +0.

Description
Calculate the complementary error function of the input argument x, 1 - erf(x).

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float erfcinvf (float y)

Calculate the inverse complementary error function of the input argument.

Returns
‣ erfcinvf(0) returns .

[Link]
CUDA Math API vRelease Version | 193
 Modules

‣ erfcinvf(2) returns .

Description
Calculate the inverse complementary error function of the input argument y, for y in the
interval [0, 2]. The inverse complementary error function find the value x that satisfies
the equation y = erfc(x), for , and .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float erfcxf (float x)

Calculate the scaled complementary error function of the input argument.

Returns
‣ erfcxf( ) returns
‣ erfcxf( ) returns +0
‣ erfcxf(x) returns if the correctly calculated value is outside the single floating
point range.

Description
Calculate the scaled complementary error function of the input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float erff (float x)

Calculate the error function of the input argument.

Returns
‣ erff( ) returns .
‣ erff( ) returns .

Description

Calculate the value of the error function for the input argument x, .

[Link]
CUDA Math API vRelease Version | 194
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float erfinvf (float y)

Calculate the inverse error function of the input argument.

Returns
‣ erfinvf(1) returns .
‣ erfinvf(-1) returns .

Description
Calculate the inverse error function of the input argument y, for y in the interval [-1,
1]. The inverse error function finds the value x that satisfies the equation y = erf(x), for
, and .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float exp10f (float x)

Calculate the base 10 exponential of the input argument.

Returns

Returns .

Description
Calculate the base 10 exponential of the input argument x.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

[Link]
CUDA Math API vRelease Version | 195
 Modules

__device__ float exp2f (float x)

Calculate the base 2 exponential of the input argument.

Returns

Returns .

Description
Calculate the base 2 exponential of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float expf (float x)

Calculate the base exponential of the input argument.

Returns
Returns .

Description
Calculate the base exponential of the input argument x, .

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

__device__ float expm1f (float x)

Calculate the base exponential of the input argument, minus 1.

Returns
Returns .

Description
Calculate the base exponential of the input argument x, minus 1.

[Link]
CUDA Math API vRelease Version | 196
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fabsf (float x)

Calculate the absolute value of its argument.

Returns
Returns the absolute value of its argument.

‣ fabs( ) returns .
‣ fabs( ) returns 0.

Description
Calculate the absolute value of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fdimf (float x, float y)

Compute the positive difference between x and y.

Returns
Returns the positive difference between x and y.

‣ fdimf(x, y) returns x - y if x > y.

‣ fdimf(x, y) returns +0 if x y.

Description
Compute the positive difference between x and y. The positive difference is x - y when x
> y and +0 otherwise.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 197
 Modules

__device__ float fdividef (float x, float y)

Divide two floating point values.

Returns
Returns x / y.

Description
Compute x divided by y. If --use_fast_math is specified, use __fdividef() for higher
performance, otherwise use normal division.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

__device__ float floorf (float x)

Calculate the largest integer less than or equal to x.

Returns
Returns expressed as a floating-point number.

‣ floorf( ) returns .
‣ floorf( ) returns .

Description
Calculate the largest integer value which is less than or equal to x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fmaf (float x, float y, float z)

Compute as a single operation.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

[Link]
CUDA Math API vRelease Version | 198
 Modules

‣ fmaf( , , z) returns NaN.

‣ fmaf(x, y, ) returns NaN if is an exact .
‣ fmaf(x, y, ) returns NaN if is an exact .

Description
Compute the value of as a single ternary operation. After computing the value
to infinite precision, the value is rounded once.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fmaxf (float x, float y)

Determine the maximum numeric value of the arguments.

Returns
Returns the maximum numeric values of the arguments x and y.

‣ If both arguments are NaN, returns NaN.

‣ If one argument is NaN, returns the numeric argument.

Description
Determines the maximum numeric value of the arguments x and y. Treats NaN
arguments as missing data. If one argument is a NaN and the other is legitimate numeric
value, the numeric value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fminf (float x, float y)

Determine the minimum numeric value of the arguments.

Returns
Returns the minimum numeric values of the arguments x and y.

‣ If both arguments are NaN, returns NaN.

‣ If one argument is NaN, returns the numeric argument.

[Link]
CUDA Math API vRelease Version | 199
 Modules

Description
Determines the minimum numeric value of the arguments x and y. Treats NaN
arguments as missing data. If one argument is a NaN and the other is legitimate numeric
value, the numeric value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float fmodf (float x, float y)

Calculate the floating-point remainder of x / y.

Returns
‣ Returns the floating point remainder of x / y.
‣ fmodf( , y) returns if y is not zero.
‣ fmodf(x, ) returns x if x is finite.
‣ fmodf(x, y) returns NaN if x is or y is zero.
‣ If either argument is NaN, NaN is returned.

Description
Calculate the floating-point remainder of x / y. The floating-point remainder of the
division operation x / y calculated by this function is exactly the value x - n*y, where
n is x / y with its fractional part truncated. The computed value will have the same sign
as x, and it's magnitude will be less than the magnitude of y.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float frexpf (float x, int *nptr)

Extract mantissa and exponent of a floating-point value.

Returns
Returns the fractional component m.

‣ frexp(0, nptr) returns 0 for the fractional component and zero for the integer
component.
‣ frexp( , nptr) returns and stores zero in the location pointed to by nptr.
‣ frexp( , nptr) returns and stores an unspecified value in the location to
which nptr points.

[Link]
CUDA Math API vRelease Version | 200
 Modules

‣ frexp(NaN, y) returns a NaN and stores an unspecified value in the location to

which nptr points.

Description
Decomposes the floating-point value x into a component m for the normalized fraction
element and another term n for the exponent. The absolute value of m will be greater
than or equal to 0.5 and less than 1.0 or it will be equal to 0; . The integer
exponent n will be stored in the location to which nptr points.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __CRTDECL hypotf (float x, float y)

Calculate the square root of the sum of squares of two arguments.

Returns

Returns the length of the hypotenuse . If the correct value would overflow,
returns . If the correct value would underflow, returns 0.

Description
Calculates the length of the hypotenuse of a right triangle whose two sides have lengths
x and y without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ int ilogbf (float x)

Compute the unbiased integer exponent of the argument.

Returns
‣ If successful, returns the unbiased exponent of the argument.
‣ ilogbf(0) returns INT_MIN.
‣ ilogbf(NaN) returns INT_MIN.
‣ ilogbf(x) returns INT_MAX if x is or the correct value is greater than INT_MAX.
‣ ilogbf(x) return INT_MIN if the correct value is less than INT_MIN.

[Link]
CUDA Math API vRelease Version | 201
 Modules

Description
Calculates the unbiased integer exponent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ __RETURN_TYPE isfinite (float a)

Determine whether argument is finite.

Returns
‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is a finite value.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is a finite value.

Description
Determine whether the floating-point value a is a finite value (zero, subnormal, or
normal and not infinity or NaN).

__device__ __RETURN_TYPE isinf (float a)

Determine whether argument is infinite.

Returns
‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is a infinite value.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is a infinite value.

Description
Determine whether the floating-point value a is an infinite value (positive or negative).

__device__ __RETURN_TYPE isnan (float a)

Determine whether argument is a NaN.

Returns
‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is a NaN value.

[Link]
CUDA Math API vRelease Version | 202
 Modules

‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is a NaN value.

Description
Determine whether the floating-point value a is a NaN.

__device__ float j0f (float x)

Calculate the value of the Bessel function of the first kind of order 0 for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order 0.

‣ j0f( ) returns +0.

‣ j0f(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the first kind of order 0 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float j1f (float x)

Calculate the value of the Bessel function of the first kind of order 1 for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order 1.

‣ j1f( ) returns .
‣ j1f( ) returns .
‣ j1f(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the first kind of order 1 for the input
argument x, .

[Link]
CUDA Math API vRelease Version | 203
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float jnf (int n, float x)

Calculate the value of the Bessel function of the first kind of order n for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order n.

‣ jnf(n, NaN) returns NaN.

‣ jnf(n, x) returns NaN for n < 0.
‣ jnf(n, ) returns +0.

Description
Calculate the value of the Bessel function of the first kind of order n for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float ldexpf (float x, int exp)

Calculate the value of .

Returns
‣ ldexpf(x) returns if the correctly calculated value is outside the single floating
point range.

Description

Calculate the value of of the input arguments x and exp.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 204
 Modules

__device__ float lgammaf (float x)

Calculate the natural logarithm of the absolute value of the gamma function of the input
argument.

Returns
‣ lgammaf(1) returns +0.
‣ lgammaf(2) returns +0.
‣ lgammaf(x) returns if the correctly calculated value is outside the single floating
point range.
‣ lgammaf(x) returns if x 0 and x is an integer.
‣ lgammaf( ) returns .
‣ lgammaf( ) returns .

Description
Calculate the natural logarithm of the absolute value of the gamma function of the input

argument x, namely the value of .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ long long int llrintf (float x)

Round input to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded to the nearest even
integer value. If the result is outside the range of the return type, the result is undefined.

__device__ long long int llroundf (float x)

Round to nearest integer value.

Returns
Returns rounded integer value.

[Link]
CUDA Math API vRelease Version | 205
 Modules

Description
Round x to the nearest integer value, with halfway cases rounded away from zero. If the
result is outside the range of the return type, the result is undefined.

This function may be slower than alternate rounding methods. See llrintf().

__device__ float log10f (float x)

Calculate the base 10 logarithm of the input argument.

Returns
‣ log10f( ) returns .
‣ log10f(1) returns +0.
‣ log10f(x) returns NaN for x < 0.
‣ log10f( ) returns .

Description
Calculate the base 10 logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float log1pf (float x)

Calculate the value of .

Returns
‣ log1pf( ) returns .
‣ log1pf(-1) returns +0.
‣ log1pf(x) returns NaN for x < -1.
‣ log1pf( ) returns .

Description
Calculate the value of of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 206
 Modules

__device__ float log2f (float x)

Calculate the base 2 logarithm of the input argument.

Returns
‣ log2f( ) returns .
‣ log2f(1) returns +0.
‣ log2f(x) returns NaN for x < 0.
‣ log2f( ) returns .

Description
Calculate the base 2 logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float logbf (float x)

Calculate the floating point representation of the exponent of the input argument.

Returns
‣ logbf returns
‣ logbf returns

Description
Calculate the floating point representation of the exponent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float logf (float x)

Calculate the natural logarithm of the input argument.

Returns
‣ logf( ) returns .
‣ logf(1) returns +0.
‣ logf(x) returns NaN for x < 0.
‣ logf( ) returns .

[Link]
CUDA Math API vRelease Version | 207
 Modules

Description
Calculate the natural logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ long int lrintf (float x)

Round input to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded to the nearest even
integer value. If the result is outside the range of the return type, the result is undefined.

__device__ long int lroundf (float x)

Round to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded away from zero. If the
result is outside the range of the return type, the result is undefined.

This function may be slower than alternate rounding methods. See lrintf().

__device__ float modff (float x, float *iptr)

Break down the input argument into fractional and integral parts.

Returns
‣ modff( , iptr) returns a result with the same sign as x.
‣ modff( , iptr) returns and stores in the object pointed to by iptr.
‣ modff(NaN, iptr) stores a NaN in the object pointed to by iptr and returns a
NaN.

[Link]
CUDA Math API vRelease Version | 208
 Modules

Description
Break down the argument x into fractional and integral parts. The integral part is stored
in the argument iptr. Fractional and integral parts are given the same sign as the
argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float nanf (const char *tagp)

Returns "Not a Number" value.

Returns
‣ nanf(tagp) returns NaN.

Description
Return a representation of a quiet NaN. Argument tagp selects one of the possible
representations.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float nearbyintf (float x)

Round the input argument to the nearest integer.

Returns
‣ nearbyintf( ) returns .
‣ nearbyintf( ) returns .

Description
Round argument x to an integer value in single precision floating-point format.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 209
 Modules

__device__ float nextafterf (float x, float y)

Return next representable single-precision floating-point value afer argument.

Returns
‣ nextafterf( , y) returns .

Description
Calculate the next representable single-precision floating-point value following x in
the direction of y. For example, if y is greater than x, nextafterf() returns the smallest
representable number greater than x

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float norm3df (float a, float b, float c)

Calculate the square root of the sum of squares of three coordinates of the argument.

Returns

Returns the length of the 3D . If the correct value would overflow,

returns . If the correct value would underflow, returns 0.

Description
Calculates the length of three dimensional vector p in euclidean space without undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float norm4df (float a, float b, float c, float

d)
Calculate the square root of the sum of squares of four coordinates of the argument.

Returns

Returns the length of the 4D vector . If the correct value would

overflow, returns . If the correct value would underflow, returns 0.

[Link]
CUDA Math API vRelease Version | 210
 Modules

Description
Calculates the length of four dimensional vector p in euclidean space without undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float normcdff (float y)

Calculate the standard normal cumulative distribution function.

Returns
‣ normcdff( ) returns 1
‣ normcdff( ) returns +0

Description
Calculate the cumulative distribution function of the standard normal distribution for
input argument y, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float normcdfinvf (float y)

Calculate the inverse of the standard normal cumulative distribution function.

Returns
‣ normcdfinvf(0) returns .
‣ normcdfinvf(1) returns .
‣ normcdfinvf(x) returns NaN if x is not in the interval [0,1].

Description
Calculate the inverse of the standard normal cumulative distribution function for input
argument y, . The function is defined for input values in the interval .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 211
 Modules

__device__ float normf (int dim, const float *a)

Calculate the square root of the sum of squares of any number of coordinates.

Returns

Returns the length of the vector . If the correct value would

overflow, returns . If the correct value would underflow, returns 0.

Description
Calculates the length of a vector p, dimension of which is passed as an agument without
undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float powf (float x, float y)

Calculate the value of first argument to the power of second argument.

Returns
‣ powf( , y) returns for y an integer less than 0.
‣ powf( , y) returns for y an odd integer greater than 0.
‣ powf( , y) returns +0 for y > 0 and not and odd integer.
‣ powf(-1, ) returns 1.
‣ powf(+1, y) returns 1 for any y, even a NaN.
‣ powf(x, ) returns 1 for any x, even a NaN.
‣ powf(x, y) returns a NaN for finite x < 0 and finite non-integer y.
‣ powf(x, ) returns for .
‣ powf(x, ) returns +0 for .
‣ powf(x, ) returns +0 for .
‣ powf(x, ) returns for .
‣ powf( , y) returns -0 for y an odd integer less than 0.
‣ powf( , y) returns +0 for y < 0 and not an odd integer.
‣ powf( , y) returns for y an odd integer greater than 0.
‣ powf( , y) returns for y > 0 and not an odd integer.
‣ powf( , y) returns +0 for y < 0.
‣ powf( , y) returns for y > 0.

[Link]
CUDA Math API vRelease Version | 212
 Modules

Description
Calculate the value of x to the power of y.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float rcbrtf (float x)

Calculate reciprocal cube root function.

Returns
‣ rcbrt( ) returns .
‣ rcbrt( ) returns .

Description
Calculate reciprocal cube root function of x

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float remainderf (float x, float y)

Compute single-precision floating-point remainder.

Returns
‣ remainderf(x, 0) returns NaN.
‣ remainderf( , y) returns NaN.
‣ remainderf(x, ) returns x for finite x.

Description
Compute single-precision floating-point remainder r of dividing x by y for nonzero y.
Thus . The value n is the integer value nearest . In the case when ,
the even n value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 213
 Modules

__device__ float remquof (float x, float y, int *quo)

Compute single-precision floating-point remainder and part of quotient.

Returns
Returns the remainder.

‣ remquof(x, 0, quo) returns NaN.

‣ remquof( , y, quo) returns NaN.
‣ remquof(x, , quo) returns x.

Description
Compute a double-precision floating-point remainder in the same way as the
remainderf() function. Argument quo returns part of quotient upon division of x by y.
Value quo has the same sign as and may not be the exact quotient but agrees with the
exact quotient in the low order 3 bits.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float rhypotf (float x, float y)

Calculate one over the square root of the sum of squares of two arguments.

Returns

Returns one over the length of the hypotenuse . If the square root would

overflow, returns 0. If the square root would underflow, returns .

Description
Calculates one over the length of the hypotenuse of a right triangle whose two sides
have lengths x and y without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 214
 Modules

__device__ float rintf (float x)

Round input to nearest integer value in floating-point.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value in floating-point format, with halfway cases
rounded to the nearest even integer value.

__device__ float rnorm3df (float a, float b, float c)

Calculate one over the square root of the sum of squares of three coordinates of the
argument.

Returns

Returns one over the length of the 3D vector . If the square root

would overflow, returns 0. If the square root would underflow, returns .

Description
Calculates one over the length of three dimension vector p in euclidean space without
undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float rnorm4df (float a, float b, float c,

float d)
Calculate one over the square root of the sum of squares of four coordinates of the
argument.

Returns

Returns one over the length of the 3D vector . If the square root

would overflow, returns 0. If the square root would underflow, returns .

[Link]
CUDA Math API vRelease Version | 215
 Modules

Description
Calculates one over the length of four dimension vector p in euclidean space without
undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float rnormf (int dim, const float *a)

Calculate the reciprocal of square root of the sum of squares of any number of
coordinates.

Returns

Returns one over the length of the vector . If the square root

would overflow, returns 0. If the square root would underflow, returns .

Description
Calculates one over the length of vector p, dimension of which is passed as an agument,
in euclidean space without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float roundf (float x)

Round to nearest integer value in floating-point.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value in floating-point format, with halfway cases
rounded away from zero.

This function may be slower than alternate rounding methods. See rintf().

[Link]
CUDA Math API vRelease Version | 216
 Modules

__device__ float rsqrtf (float x)

Calculate the reciprocal of the square root of the input argument.

Returns

Returns .

‣ rsqrtf( ) returns +0.

‣ rsqrtf( ) returns .
‣ rsqrtf(x) returns NaN if x is less than 0.

Description

Calculate the reciprocal of the nonnegative square root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float scalblnf (float x, long int n)

Scale floating-point input by integer power of two.

Returns

Returns x * .

‣ scalblnf( , n) returns .
‣ scalblnf(x, 0) returns x.
‣ scalblnf( , n) returns .

Description

Scale x by by efficient manipulation of the floating-point exponent.

__device__ float scalbnf (float x, int n)

Scale floating-point input by integer power of two.

Returns

Returns x * .

‣ scalbnf( , n) returns .
‣ scalbnf(x, 0) returns x.
‣ scalbnf( , n) returns .

[Link]
CUDA Math API vRelease Version | 217
 Modules

Description

Scale x by by efficient manipulation of the floating-point exponent.

__device__ __RETURN_TYPE signbit (float a)

Return the sign bit of the input.

Returns
Reports the sign bit of all values including infinities, zeros, and NaNs.

‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is negative.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is negative.

Description
Determine whether the floating-point value a is negative.

__device__ void sincosf (float x, float *sptr, float *cptr)

Calculate the sine and cosine of the first input argument.

Returns
‣ none

Description
Calculate the sine and cosine of the first input argument x (measured in radians). The
results for sine and cosine are written into the second argument, sptr, and, respectively,
third argument, cptr.

See also:
sinf() and cosf().

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

[Link]
CUDA Math API vRelease Version | 218
 Modules

__device__ void sincospif (float x, float *sptr, float

*cptr)
Calculate the sine and cosine of the first input argument .

Returns
‣ none

Description
Calculate the sine and cosine of the first input argument, x (measured in radians),
. The results for sine and cosine are written into the second argument, sptr, and,
respectively, third argument, cptr.

See also:
sinpif() and cospif().

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float sinf (float x)

Calculate the sine of the input argument.

Returns
‣ sinf( ) returns .
‣ sinf( ) returns NaN.

Description
Calculate the sine of the input argument x (measured in radians).

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

[Link]
CUDA Math API vRelease Version | 219
 Modules

__device__ float sinhf (float x)

Calculate the hyperbolic sine of the input argument.

Returns
‣ sinhf( ) returns .
‣ sinhf( ) returns NaN.

Description
Calculate the hyperbolic sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float sinpif (float x)

Calculate the sine of the input argument .

Returns
‣ sinpif( ) returns .
‣ sinpif( ) returns NaN.

Description
Calculate the sine of x (measured in radians), where x is the input argument.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float sqrtf (float x)

Calculate the square root of the input argument.

Returns

Returns .

‣ sqrtf( ) returns .
‣ sqrtf( ) returns .
‣ sqrtf(x) returns NaN if x is less than 0.

[Link]
CUDA Math API vRelease Version | 220
 Modules

Description

Calculate the nonnegative square root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float tanf (float x)

Calculate the tangent of the input argument.

Returns
‣ tanf( ) returns .
‣ tanf( ) returns NaN.

Description
Calculate the tangent of the input argument x (measured in radians).

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This function is affected by the --use_fast_math compiler flag. See
the CUDA C Programming Guide, Appendix D.2, Table 8 for a complete list of
functions affected.

__device__ float tanhf (float x)

Calculate the hyperbolic tangent of the input argument.

Returns
‣ tanhf( ) returns .

Description
Calculate the hyperbolic tangent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 221
 Modules

__device__ float tgammaf (float x)

Calculate the gamma function of the input argument.

Returns
‣ tgammaf( ) returns .
‣ tgammaf(2) returns +1.
‣ tgammaf(x) returns if the correctly calculated value is outside the single floating
point range.
‣ tgammaf(x) returns NaN if x < 0 and x is an integer.
‣ tgammaf( ) returns NaN.
‣ tgammaf( ) returns .

Description

Calculate the gamma function of the input argument x, namely the value of .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float truncf (float x)

Truncate input argument to the integral part.

Returns
Returns truncated integer value.

Description
Round x to the nearest integer value that does not exceed x in magnitude.

__device__ float y0f (float x)

Calculate the value of the Bessel function of the second kind of order 0 for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order 0.

‣ y0f(0) returns .
‣ y0f(x) returns NaN for x < 0.
‣ y0f( ) returns +0.

[Link]
CUDA Math API vRelease Version | 222
 Modules

‣ y0f(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order 0 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float y1f (float x)

Calculate the value of the Bessel function of the second kind of order 1 for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order 1.

‣ y1f(0) returns .
‣ y1f(x) returns NaN for x < 0.
‣ y1f( ) returns +0.
‣ y1f(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order 1 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float ynf (int n, float x)

Calculate the value of the Bessel function of the second kind of order n for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order n.

‣ ynf(n, x) returns NaN for n < 0.

‣ ynf(n, 0) returns .
‣ ynf(n, x) returns NaN for x < 0.
‣ ynf(n, ) returns +0.

[Link]
CUDA Math API vRelease Version | 223
 Modules

‣ ynf(n, NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order n for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

1.5. Double Precision Mathematical Functions

This section describes double precision mathematical functions. To use these functions
you do not need to include any additional header files in your program.

__device__ double acos (double x)

Calculate the arc cosine of the input argument.

Returns
Result will be in radians, in the interval [0, ] for x inside [-1, +1].

‣ acos(1) returns +0.

‣ acos(x) returns NaN for x outside [-1, +1].

Description
Calculate the principal value of the arc cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double acosh (double x)

Calculate the nonnegative arc hyperbolic cosine of the input argument.

Returns
Result will be in the interval [0, ].

‣ acosh(1) returns 0.
‣ acosh(x) returns NaN for x in the interval [ , 1).

[Link]
CUDA Math API vRelease Version | 224
 Modules

Description
Calculate the nonnegative arc hyperbolic cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double asin (double x)

Calculate the arc sine of the input argument.

Returns
Result will be in radians, in the interval [- /2, + /2] for x inside [-1, +1].

‣ asin(0) returns +0.

‣ asin(x) returns NaN for x outside [-1, +1].

Description
Calculate the principal value of the arc sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double asinh (double x)

Calculate the arc hyperbolic sine of the input argument.

Returns
‣ asinh(0) returns 1.

Description
Calculate the arc hyperbolic sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 225
 Modules

__device__ double atan (double x)

Calculate the arc tangent of the input argument.

Returns
Result will be in radians, in the interval [- /2, + /2].

‣ atan(0) returns +0.

Description
Calculate the principal value of the arc tangent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double atan2 (double y, double x)

Calculate the arc tangent of the ratio of first and second input arguments.

Returns
Result will be in radians, in the interval [- /, + ].

‣ atan2(0, 1) returns +0.

Description
Calculate the principal value of the arc tangent of the ratio of first and second input
arguments y / x. The quadrant of the result is determined by the signs of inputs y and x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double atanh (double x)

Calculate the arc hyperbolic tangent of the input argument.

Returns
‣ atanh( ) returns .
‣ atanh( ) returns .
‣ atanh(x) returns NaN for x outside interval [-1, 1].

[Link]
CUDA Math API vRelease Version | 226
 Modules

Description
Calculate the arc hyperbolic tangent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double cbrt (double x)

Calculate the cube root of the input argument.

Returns

Returns .

‣ cbrt( ) returns .
‣ cbrt( ) returns .

Description

Calculate the cube root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double ceil (double

x)
Calculate ceiling of the input argument.

Returns
Returns expressed as a floating-point number.

‣ ceil( ) returns .
‣ ceil( ) returns .

Description
Compute the smallest integer value not less than x.

[Link]
CUDA Math API vRelease Version | 227
 Modules

__device__ double copysign (double x, double y)

Create value with given magnitude, copying sign of second value.

Returns
Returns a value with the magnitude of x and the sign of y.

Description
Create a floating-point value with the magnitude x and the sign of y.

__device__ double cos (double x)

Calculate the cosine of the input argument.

Returns
‣ cos( ) returns 1.
‣ cos( ) returns NaN.

Description
Calculate the cosine of the input argument x (measured in radians).

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double cosh (double x)

Calculate the hyperbolic cosine of the input argument.

Returns
‣ cosh(0) returns 1.
‣ cosh( ) returns .

Description
Calculate the hyperbolic cosine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 228
 Modules

__device__ double cospi (double x)

Calculate the cosine of the input argument .

Returns
‣ cospi( ) returns 1.
‣ cospi( ) returns NaN.

Description
Calculate the cosine of x (measured in radians), where x is the input argument.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double cyl_bessel_i0

(double x)
Calculate the value of the regular modified cylindrical Bessel function of order 0 for the
input argument.

Returns
Returns the value of the regular modified cylindrical Bessel function of order 0.

Description
Calculate the value of the regular modified cylindrical Bessel function of order 0 for the
input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double cyl_bessel_i1

(double x)
Calculate the value of the regular modified cylindrical Bessel function of order 1 for the
input argument.

Returns
Returns the value of the regular modified cylindrical Bessel function of order 1.

[Link]
CUDA Math API vRelease Version | 229
 Modules

Description
Calculate the value of the regular modified cylindrical Bessel function of order 1 for the
input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double erf (double x)

Calculate the error function of the input argument.

Returns
‣ erf( ) returns .
‣ erf( ) returns .

Description

Calculate the value of the error function for the input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double erfc (double x)

Calculate the complementary error function of the input argument.

Returns
‣ erfc( ) returns 2.
‣ erfc( ) returns +0.

Description
Calculate the complementary error function of the input argument x, 1 - erf(x).

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 230
 Modules

__device__ double erfcinv (double y)

Calculate the inverse complementary error function of the input argument.

Returns
‣ erfcinv(0) returns .
‣ erfcinv(2) returns .

Description
Calculate the inverse complementary error function of the input argument y, for y in the
interval [0, 2]. The inverse complementary error function find the value x that satisfies
the equation y = erfc(x), for , and .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double erfcx (double x)

Calculate the scaled complementary error function of the input argument.

Returns
‣ erfcx( ) returns
‣ erfcx( ) returns +0
‣ erfcx(x) returns if the correctly calculated value is outside the double floating
point range.

Description
Calculate the scaled complementary error function of the input argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double erfinv (double y)

Calculate the inverse error function of the input argument.

Returns
‣ erfinv(1) returns .
‣ erfinv(-1) returns .

[Link]
CUDA Math API vRelease Version | 231
 Modules

Description
Calculate the inverse error function of the input argument y, for y in the interval [-1,
1]. The inverse error function finds the value x that satisfies the equation y = erf(x), for
, and .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double exp (double x)

Calculate the base exponential of the input argument.

Returns
Returns .

Description
Calculate the base exponential of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double exp10 (double x)

Calculate the base 10 exponential of the input argument.

Returns

Returns .

Description
Calculate the base 10 exponential of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 232
 Modules

__device__ double exp2 (double x)

Calculate the base 2 exponential of the input argument.

Returns

Returns .

Description
Calculate the base 2 exponential of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double expm1 (double x)

Calculate the base exponential of the input argument, minus 1.

Returns
Returns .

Description
Calculate the base exponential of the input argument x, minus 1.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double fabs (double x)

Calculate the absolute value of the input argument.

Returns
Returns the absolute value of the input argument.

‣ fabs( ) returns .
‣ fabs( ) returns 0.

Description
Calculate the absolute value of the input argument x.

[Link]
CUDA Math API vRelease Version | 233
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double fdim (double x, double y)

Compute the positive difference between x and y.

Returns
Returns the positive difference between x and y.

‣ fdim(x, y) returns x - y if x > y.

‣ fdim(x, y) returns +0 if x y.

Description
Compute the positive difference between x and y. The positive difference is x - y when x
> y and +0 otherwise.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ __CUDA_MATH_CRTIMP double floor (double

x)
Calculate the largest integer less than or equal to x.

Returns
Returns expressed as a floating-point number.

‣ floor( ) returns .
‣ floor( ) returns .

Description
Calculates the largest integer value which is less than or equal to x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 234
 Modules

__device__ double fma (double x, double y, double z)

Compute as a single operation.

Returns
Returns the rounded value of as a single operation.

‣ fma( , , z) returns NaN.

‣ fma( , , z) returns NaN.
‣ fma(x, y, ) returns NaN if is an exact .
‣ fma(x, y, ) returns NaN if is an exact .

Description
Compute the value of as a single ternary operation. After computing the value
to infinite precision, the value is rounded once.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double fmax (double, double)

Determine the maximum numeric value of the arguments.

Returns
Returns the maximum numeric values of the arguments x and y.

‣ If both arguments are NaN, returns NaN.

‣ If one argument is NaN, returns the numeric argument.

Description
Determines the maximum numeric value of the arguments x and y. Treats NaN
arguments as missing data. If one argument is a NaN and the other is legitimate numeric
value, the numeric value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 235
 Modules

__device__ double fmin (double x, double y)

Determine the minimum numeric value of the arguments.

Returns
Returns the minimum numeric values of the arguments x and y.

‣ If both arguments are NaN, returns NaN.

‣ If one argument is NaN, returns the numeric argument.

Description
Determines the minimum numeric value of the arguments x and y. Treats NaN
arguments as missing data. If one argument is a NaN and the other is legitimate numeric
value, the numeric value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double fmod (double x, double y)

Calculate the double-precision floating-point remainder of x / y.

Returns
‣ Returns the floating point remainder of x / y.
‣ fmod( , y) returns if y is not zero.
‣ fmod(x, ) returns x if x is finite.
‣ fmod(x, y) returns NaN if x is or y is zero.
‣ If either argument is NaN, NaN is returned.

Description
Calculate the double-precision floating-point remainder of x / y. The floating-point
remainder of the division operation x / y calculated by this function is exactly the value
x - n*y, where n is x / y with its fractional part truncated. The computed value will
have the same sign as x, and it's magnitude will be less than the magnitude of y.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 236
 Modules

__device__ __CUDA_MATH_CRTIMP double frexp (double

x, int *nptr)
Extract mantissa and exponent of a floating-point value.

Returns
Returns the fractional component m.

‣ frexp(0, nptr) returns 0 for the fractional component and zero for the integer
component.
‣ frexp( , nptr) returns and stores zero in the location pointed to by nptr.
‣ frexp( , nptr) returns and stores an unspecified value in the location to
which nptr points.
‣ frexp(NaN, y) returns a NaN and stores an unspecified value in the location to
which nptr points.

Description
Decompose the floating-point value x into a component m for the normalized fraction
element and another term n for the exponent. The absolute value of m will be greater
than or equal to 0.5 and less than 1.0 or it will be equal to 0; . The integer
exponent n will be stored in the location to which nptr points.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device___ACRTIMP double hypot (double x, double y)

Calculate the square root of the sum of squares of two arguments.

Returns

Returns the length of the hypotenuse . If the correct value would overflow,
returns . If the correct value would underflow, returns 0.

Description
Calculate the length of the hypotenuse of a right triangle whose two sides have lengths x
and y without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 237
 Modules

__device__ int ilogb (double x)

Compute the unbiased integer exponent of the argument.

Returns
‣ If successful, returns the unbiased exponent of the argument.
‣ ilogb(0) returns INT_MIN.
‣ ilogb(NaN) returns INT_MIN.
‣ ilogb(x) returns INT_MAX if x is or the correct value is greater than INT_MAX.
‣ ilogb(x) return INT_MIN if the correct value is less than INT_MIN.

Description
Calculates the unbiased integer exponent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __RETURN_TYPE isfinite (double a)

Determine whether argument is finite.

Returns
‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is a finite value.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is a finite value.

Description
Determine whether the floating-point value a is a finite value (zero, subnormal, or
normal and not infinity or NaN).

__device__ __RETURN_TYPE isinf (double a)

Determine whether argument is infinite.

Returns
‣ With Visual Studio 2013 host compiler: Returns true if and only if a is a infinite
value.
‣ With other host compilers: Returns a nonzero value if and only if a is a infinite
value.

[Link]
CUDA Math API vRelease Version | 238
 Modules

Description
Determine whether the floating-point value a is an infinite value (positive or negative).

__device__ __RETURN_TYPE isnan (double a)

Determine whether argument is a NaN.

Returns
‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is a NaN value.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is a NaN value.

Description
Determine whether the floating-point value a is a NaN.

__device__ __CUDA_MATH_CRTIMP double j0 (double x)

Calculate the value of the Bessel function of the first kind of order 0 for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order 0.

‣ j0( ) returns +0.

‣ j0(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the first kind of order 0 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double j1 (double x)

Calculate the value of the Bessel function of the first kind of order 1 for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order 1.

[Link]
CUDA Math API vRelease Version | 239
 Modules

‣ j1( ) returns .
‣ j1( ) returns .
‣ j1(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the first kind of order 1 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double jn (int n,

double x)
Calculate the value of the Bessel function of the first kind of order n for the input
argument.

Returns
Returns the value of the Bessel function of the first kind of order n.

‣ jn(n, NaN) returns NaN.

‣ jn(n, x) returns NaN for n < 0.
‣ jn(n, ) returns +0.

Description
Calculate the value of the Bessel function of the first kind of order n for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double ldexp (double

x, int exp)
Calculate the value of .

Returns
‣ ldexp(x) returns if the correctly calculated value is outside the double floating
point range.

[Link]
CUDA Math API vRelease Version | 240
 Modules

Description

Calculate the value of of the input arguments x and exp.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double lgamma (double x)

Calculate the natural logarithm of the absolute value of the gamma function of the input
argument.

Returns
‣ lgamma(1) returns +0.
‣ lgamma(2) returns +0.
‣ lgamma(x) returns if the correctly calculated value is outside the double
floating point range.
‣ lgamma(x) returns if x 0 and x is an integer.
‣ lgamma( ) returns .
‣ lgamma( ) returns .

Description
Calculate the natural logarithm of the absolute value of the gamma function of the input

argument x, namely the value of

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ long long int llrint (double x)

Round input to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded to the nearest even
integer value. If the result is outside the range of the return type, the result is undefined.

[Link]
CUDA Math API vRelease Version | 241
 Modules

__device__ long long int llround (double x)

Round to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded away from zero. If the
result is outside the range of the return type, the result is undefined.

This function may be slower than alternate rounding methods. See llrint().

__device__ double log (double x)

Calculate the base logarithm of the input argument.

Returns
‣ log( ) returns .
‣ log(1) returns +0.
‣ log(x) returns NaN for x < 0.
‣ log( ) returns

Description
Calculate the base logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double log10 (double x)

Calculate the base 10 logarithm of the input argument.

Returns
‣ log10( ) returns .
‣ log10(1) returns +0.
‣ log10(x) returns NaN for x < 0.
‣ log10( ) returns .

[Link]
CUDA Math API vRelease Version | 242
 Modules

Description
Calculate the base 10 logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double log1p (double x)

Calculate the value of .

Returns
‣ log1p( ) returns .
‣ log1p(-1) returns +0.
‣ log1p(x) returns NaN for x < -1.
‣ log1p( ) returns .

Description
Calculate the value of of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double log2 (double x)

Calculate the base 2 logarithm of the input argument.

Returns
‣ log2( ) returns .
‣ log2(1) returns +0.
‣ log2(x) returns NaN for x < 0.
‣ log2( ) returns .

Description
Calculate the base 2 logarithm of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 243
 Modules

__device__ double logb (double x)

Calculate the floating point representation of the exponent of the input argument.

Returns
‣ logb returns
‣ logb returns

Description
Calculate the floating point representation of the exponent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ long int lrint (double x)

Round input to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded to the nearest even
integer value. If the result is outside the range of the return type, the result is undefined.

__device__ long int lround (double x)

Round to nearest integer value.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value, with halfway cases rounded away from zero. If the
result is outside the range of the return type, the result is undefined.

This function may be slower than alternate rounding methods. See lrint().

[Link]
CUDA Math API vRelease Version | 244
 Modules

__device__ __CUDA_MATH_CRTIMP double modf (double

x, double *iptr)
Break down the input argument into fractional and integral parts.

Returns
‣ modf( , iptr) returns a result with the same sign as x.
‣ modf( , iptr) returns and stores in the object pointed to by iptr.
‣ modf(NaN, iptr) stores a NaN in the object pointed to by iptr and returns a NaN.

Description
Break down the argument x into fractional and integral parts. The integral part is stored
in the argument iptr. Fractional and integral parts are given the same sign as the
argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double nan (const char *tagp)

Returns "Not a Number" value.

Returns
‣ nan(tagp) returns NaN.

Description
Return a representation of a quiet NaN. Argument tagp selects one of the possible
representations.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double nearbyint (double x)

Round the input argument to the nearest integer.

Returns
‣ nearbyint( ) returns .
‣ nearbyint( ) returns .

[Link]
CUDA Math API vRelease Version | 245
 Modules

Description
Round argument x to an integer value in double precision floating-point format.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double nextafter (double x, double y)

Return next representable double-precision floating-point value after argument.

Returns
‣ nextafter( , y) returns .

Description
Calculate the next representable double-precision floating-point value following x in
the direction of y. For example, if y is greater than x, nextafter() returns the smallest
representable number greater than x

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double norm (int dim, const double *t)

Calculate the square root of the sum of squares of any number of coordinates.

Returns

Returns the length of the dim-D vector . If the correct value

would overflow, returns . If the correct value would underflow, returns 0. If two of
the input arguments is 0, returns remaining argument

Description
Calculate the length of a vector p, dimension of which is passed as an argument
without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 246
 Modules

__device__ __CUDA_MATH_CRTIMP double norm3d

(double a, double b, double c)
Calculate the square root of the sum of squares of three coordinates of the argument.

Returns

Returns the length of 3D vector . If the correct value would overflow,

returns . If the correct value would underflow, returns 0.

Description
Calculate the length of three dimensional vector p in euclidean space without undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double norm4d

(double a, double b, double c, double d)
Calculate the square root of the sum of squares of four coordinates of the argument.

Returns

Returns the length of 4D vector . If the correct value would

overflow, returns . If the correct value would underflow, returns 0.

Description
Calculate the length of four dimensional vector p in euclidean space without undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double normcdf (double y)

Calculate the standard normal cumulative distribution function.

Returns
‣ normcdf( ) returns 1

[Link]
CUDA Math API vRelease Version | 247
 Modules

‣ normcdf( ) returns +0

Description
Calculate the cumulative distribution function of the standard normal distribution for
input argument y, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double normcdfinv (double y)

Calculate the inverse of the standard normal cumulative distribution function.

Returns
‣ normcdfinv(0) returns .
‣ normcdfinv(1) returns .
‣ normcdfinv(x) returns NaN if x is not in the interval [0,1].

Description
Calculate the inverse of the standard normal cumulative distribution function for input
argument y, . The function is defined for input values in the interval .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double pow (double x, double y)

Calculate the value of first argument to the power of second argument.

Returns
‣ pow( , y) returns for y an integer less than 0.
‣ pow( , y) returns for y an odd integer greater than 0.
‣ pow( , y) returns +0 for y > 0 and not and odd integer.
‣ pow(-1, ) returns 1.
‣ pow(+1, y) returns 1 for any y, even a NaN.
‣ pow(x, ) returns 1 for any x, even a NaN.
‣ pow(x, y) returns a NaN for finite x < 0 and finite non-integer y.
‣ pow(x, ) returns for .
‣ pow(x, ) returns +0 for .

[Link]
CUDA Math API vRelease Version | 248
 Modules

‣ pow(x, ) returns +0 for .

‣ pow(x, ) returns for .
‣ pow( , y) returns -0 for y an odd integer less than 0.
‣ pow( , y) returns +0 for y < 0 and not an odd integer.
‣ pow( , y) returns for y an odd integer greater than 0.
‣ pow( , y) returns for y > 0 and not an odd integer.
‣ pow( , y) returns +0 for y < 0.
‣ pow( , y) returns for y > 0.

Description
Calculate the value of x to the power of y

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double rcbrt (double x)

Calculate reciprocal cube root function.

Returns
‣ rcbrt( ) returns .
‣ rcbrt( ) returns .

Description
Calculate reciprocal cube root function of x

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double remainder (double x, double y)

Compute double-precision floating-point remainder.

Returns
‣ remainder(x, 0) returns NaN.
‣ remainder( , y) returns NaN.
‣ remainder(x, ) returns x for finite x.

[Link]
CUDA Math API vRelease Version | 249
 Modules

Description
Compute double-precision floating-point remainder r of dividing x by y for nonzero y.
Thus . The value n is the integer value nearest . In the case when ,
the even n value is chosen.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double remquo (double x, double y, int

*quo)
Compute double-precision floating-point remainder and part of quotient.

Returns
Returns the remainder.

‣ remquo(x, 0, quo) returns NaN.

‣ remquo( , y, quo) returns NaN.
‣ remquo(x, , quo) returns x.

Description
Compute a double-precision floating-point remainder in the same way as the
remainder() function. Argument quo returns part of quotient upon division of x by y.
Value quo has the same sign as and may not be the exact quotient but agrees with the
exact quotient in the low order 3 bits.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double rhypot (double x, double y)

Calculate one over the square root of the sum of squares of two arguments.

Returns

Returns one over the length of the hypotenuse . If the square root would

overflow, returns 0. If the square root would underflow, returns .

[Link]
CUDA Math API vRelease Version | 250
 Modules

Description
Calculate one over the length of the hypotenuse of a right triangle whose two sides have
lengths x and y without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double rint (double x)

Round to nearest integer value in floating-point.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value in floating-point format, with halfway cases
rounded to the nearest even integer value.

__device__ double rnorm (int dim, const double *t)

Calculate the reciprocal of square root of the sum of squares of any number of
coordinates.

Returns

Returns one over the length of the vector . If the square root

would overflow, returns 0. If the square root would underflow, returns .

Description
Calculates one over the length of vector p, dimension of which is passed as an agument,
in euclidean space without undue overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 251
 Modules

__device__ double rnorm3d (double a, double b, double

c)
Calculate one over the square root of the sum of squares of three coordinates of the
argument.

Returns

Returns one over the length of the 3D vetor . If the square root would

overflow, returns 0. If the square root would underflow, returns .

Description
Calculate one over the length of three dimensional vector p in euclidean space undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double rnorm4d (double a, double b, double

c, double d)
Calculate one over the square root of the sum of squares of four coordinates of the
argument.

Returns

Returns one over the length of the 3D vetor . If the square root

would overflow, returns 0. If the square root would underflow, returns .

Description
Calculate one over the length of four dimensional vector p in euclidean space undue
overflow or underflow.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 252
 Modules

__device__ double round (double x)

Round to nearest integer value in floating-point.

Returns
Returns rounded integer value.

Description
Round x to the nearest integer value in floating-point format, with halfway cases
rounded away from zero.

This function may be slower than alternate rounding methods. See rint().

__device__ double rsqrt (double x)

Calculate the reciprocal of the square root of the input argument.

Returns

Returns .

‣ rsqrt( ) returns +0.

‣ rsqrt( ) returns .
‣ rsqrt(x) returns NaN if x is less than 0.

Description

Calculate the reciprocal of the nonnegative square root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double scalbln (double x, long int n)

Scale floating-point input by integer power of two.

Returns

Returns x * .

‣ scalbln( , n) returns .
‣ scalbln(x, 0) returns x.

[Link]
CUDA Math API vRelease Version | 253
 Modules

‣ scalbln( , n) returns .

Description

Scale x by by efficient manipulation of the floating-point exponent.

__device__ double scalbn (double x, int n)

Scale floating-point input by integer power of two.

Returns

Returns x * .

‣ scalbn( , n) returns .
‣ scalbn(x, 0) returns x.
‣ scalbn( , n) returns .

Description

Scale x by by efficient manipulation of the floating-point exponent.

__device__ __RETURN_TYPE signbit (double a)

Return the sign bit of the input.

Returns
Reports the sign bit of all values including infinities, zeros, and NaNs.

‣ With Visual Studio 2013 host compiler: __RETURN_TYPE is 'bool'. Returns true if
and only if a is negative.
‣ With other host compilers: __RETURN_TYPE is 'int'. Returns a nonzero value if and
only if a is negative.

Description
Determine whether the floating-point value a is negative.

__device__ double sin (double x)

Calculate the sine of the input argument.

Returns
‣ sin( ) returns .
‣ sin( ) returns NaN.

[Link]
CUDA Math API vRelease Version | 254
 Modules

Description
Calculate the sine of the input argument x (measured in radians).

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ void sincos (double x, double *sptr, double

*cptr)
Calculate the sine and cosine of the first input argument.

Returns
‣ none

Description
Calculate the sine and cosine of the first input argument x (measured in radians). The
results for sine and cosine are written into the second argument, sptr, and, respectively,
third argument, cptr.

See also:
sin() and cos().

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ void sincospi (double x, double *sptr, double

*cptr)
Calculate the sine and cosine of the first input argument .

Returns
‣ none

Description
Calculate the sine and cosine of the first input argument, x (measured in radians),
. The results for sine and cosine are written into the second argument, sptr, and,
respectively, third argument, cptr.

See also:

[Link]
CUDA Math API vRelease Version | 255
 Modules

sinpi() and cospi().

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double sinh (double x)

Calculate the hyperbolic sine of the input argument.

Returns
‣ sinh( ) returns .

Description
Calculate the hyperbolic sine of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double sinpi (double x)

Calculate the sine of the input argument .

Returns
‣ sinpi( ) returns .
‣ sinpi( ) returns NaN.

Description
Calculate the sine of x (measured in radians), where x is the input argument.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double sqrt (double x)

Calculate the square root of the input argument.

Returns

Returns .

[Link]
CUDA Math API vRelease Version | 256
 Modules

‣ sqrt( ) returns .
‣ sqrt( ) returns .
‣ sqrt(x) returns NaN if x is less than 0.

Description

Calculate the nonnegative square root of x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double tan (double x)

Calculate the tangent of the input argument.

Returns
‣ tan( ) returns .
‣ tan( ) returns NaN.

Description
Calculate the tangent of the input argument x (measured in radians).

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double tanh (double x)

Calculate the hyperbolic tangent of the input argument.

Returns
‣ tanh( ) returns .

Description
Calculate the hyperbolic tangent of the input argument x.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 257
 Modules

__device__ double tgamma (double x)

Calculate the gamma function of the input argument.

Returns
‣ tgamma( ) returns .
‣ tgamma(2) returns +1.
‣ tgamma(x) returns if the correctly calculated value is outside the double
floating point range.
‣ tgamma(x) returns NaN if x < 0 and x is an integer.
‣ tgamma( ) returns NaN.
‣ tgamma( ) returns .

Description

Calculate the gamma function of the input argument x, namely the value of .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double trunc (double x)

Truncate input argument to the integral part.

Returns
Returns truncated integer value.

Description
Round x to the nearest integer value that does not exceed x in magnitude.

__device__ __CUDA_MATH_CRTIMP double y0 (double x)

Calculate the value of the Bessel function of the second kind of order 0 for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order 0.

‣ y0(0) returns .
‣ y0(x) returns NaN for x < 0.
‣ y0( ) returns +0.

[Link]
CUDA Math API vRelease Version | 258
 Modules

‣ y0(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order 0 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double y1 (double x)

Calculate the value of the Bessel function of the second kind of order 1 for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order 1.

‣ y1(0) returns .
‣ y1(x) returns NaN for x < 0.
‣ y1( ) returns +0.
‣ y1(NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order 1 for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ __CUDA_MATH_CRTIMP double yn (int n,

double x)
Calculate the value of the Bessel function of the second kind of order n for the input
argument.

Returns
Returns the value of the Bessel function of the second kind of order n.

‣ yn(n, x) returns NaN for n < 0.

‣ yn(n, 0) returns .
‣ yn(n, x) returns NaN for x < 0.

[Link]
CUDA Math API vRelease Version | 259
 Modules

‣ yn(n, ) returns +0.

‣ yn(n, NaN) returns NaN.

Description
Calculate the value of the Bessel function of the second kind of order n for the input
argument x, .

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

1.6. Single Precision Intrinsics

This section describes single precision intrinsic functions that are only supported in
device code. To use these functions you do not need to include any additional header
files in your program.

__device__ float __cosf (float x)

Calculate the fast approximate cosine of the input argument.

Returns
Returns the approximate cosine of x.

Description
Calculate the fast approximate cosine of the input argument x, measured in radians.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Input and output in the denormal range is flushed to sign preserving 0.0.

__device__ float __exp10f (float x)

Calculate the fast approximate base 10 exponential of the input argument.

Returns

Returns an approximation to .

[Link]
CUDA Math API vRelease Version | 260
 Modules

Description

Calculate the fast approximate base 10 exponential of the input argument x, .

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Most input and output values around denormal range are flushed to sign
preserving 0.0.

__device__ float __expf (float x)

Calculate the fast approximate base exponential of the input argument.

Returns
Returns an approximation to .

Description
Calculate the fast approximate base exponential of the input argument x, .

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Most input and output values around denormal range are flushed to sign
preserving 0.0.

__device__ float __fadd_rd (float x, float y)

Add two floating point values in round-down mode.

Returns
Returns x + y.

Description
Compute the sum of x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

[Link]
CUDA Math API vRelease Version | 261
 Modules

__device__ float __fadd_rn (float x, float y)

Add two floating point values in round-to-nearest-even mode.

Returns
Returns x + y.

Description
Compute the sum of x and y in round-to-nearest-even rounding mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fadd_ru (float x, float y)

Add two floating point values in round-up mode.

Returns
Returns x + y.

Description
Compute the sum of x and y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fadd_rz (float x, float y)

Add two floating point values in round-towards-zero mode.

Returns
Returns x + y.

Description
Compute the sum of x and y in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 262
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fdiv_rd (float x, float y)

Divide two floating point values in round-down mode.

Returns
Returns x / y.

Description
Divide two floating point values x by y in round-down (to negative infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fdiv_rn (float x, float y)

Divide two floating point values in round-to-nearest-even mode.

Returns
Returns x / y.

Description
Divide two floating point values x by y in round-to-nearest-even mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fdiv_ru (float x, float y)

Divide two floating point values in round-up mode.

Returns
Returns x / y.

[Link]
CUDA Math API vRelease Version | 263
 Modules

Description
Divide two floating point values x by y in round-up (to positive infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fdiv_rz (float x, float y)

Divide two floating point values in round-towards-zero mode.

Returns
Returns x / y.

Description
Divide two floating point values x by y in round-towards-zero mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fdividef (float x, float y)

Calculate the fast approximate division of the input arguments.

Returns
Returns x / y.

‣ __fdividef( , y) returns NaN for .

‣ __fdividef(x, y) returns 0 for and .

Description
Calculate the fast approximate division of x by y.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.

[Link]
CUDA Math API vRelease Version | 264
 Modules

__device__ float __fmaf_rd (float x, float y, float z)

Compute as a single operation, in round-down mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact .
‣ fmaf(x, y, ) returns NaN if is an exact .

Description
Computes the value of as a single ternary operation, rounding the result once
in round-down (to negative infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fmaf_rn (float x, float y, float z)

Compute as a single operation, in round-to-nearest-even mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact .
‣ fmaf(x, y, ) returns NaN if is an exact .

Description
Computes the value of as a single ternary operation, rounding the result once
in round-to-nearest-even mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 265
 Modules

__device__ float __fmaf_ru (float x, float y, float z)

Compute as a single operation, in round-up mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact .
‣ fmaf(x, y, ) returns NaN if is an exact .

Description
Computes the value of as a single ternary operation, rounding the result once
in round-up (to positive infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fmaf_rz (float x, float y, float z)

Compute as a single operation, in round-towards-zero mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact .
‣ fmaf(x, y, ) returns NaN if is an exact .

Description
Computes the value of as a single ternary operation, rounding the result once
in round-towards-zero mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 266
 Modules

__device__ float __fmul_rd (float x, float y)

Multiply two floating point values in round-down mode.

Returns
Returns x * y.

Description
Compute the product of x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fmul_rn (float x, float y)

Multiply two floating point values in round-to-nearest-even mode.

Returns
Returns x * y.

Description
Compute the product of x and y in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fmul_ru (float x, float y)

Multiply two floating point values in round-up mode.

Returns
Returns x * y.

Description
Compute the product of x and y in round-up (to positive infinity) mode.

[Link]
CUDA Math API vRelease Version | 267
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fmul_rz (float x, float y)

Multiply two floating point values in round-towards-zero mode.

Returns
Returns x * y.

Description
Compute the product of x and y in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __frcp_rd (float x)

Compute in round-down mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-down (to negative infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __frcp_rn (float x)

Compute in round-to-nearest-even mode.

Returns

Returns .

[Link]
CUDA Math API vRelease Version | 268
 Modules

Description
Compute the reciprocal of x in round-to-nearest-even mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __frcp_ru (float x)

Compute in round-up mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-up (to positive infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __frcp_rz (float x)

Compute in round-towards-zero mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-towards-zero mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

[Link]
CUDA Math API vRelease Version | 269
 Modules

__device__ float __frsqrt_rn (float x)

Compute in round-to-nearest-even mode.

Returns

Returns .

Description
Compute the reciprocal square root of x in round-to-nearest-even mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fsqrt_rd (float x)

Compute in round-down mode.

Returns

Returns .

Description
Compute the square root of x in round-down (to negative infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fsqrt_rn (float x)

Compute in round-to-nearest-even mode.

Returns

Returns .

Description
Compute the square root of x in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 270
 Modules

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fsqrt_ru (float x)

Compute in round-up mode.

Returns

Returns .

Description
Compute the square root of x in round-up (to positive infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fsqrt_rz (float x)

Compute in round-towards-zero mode.

Returns

Returns .

Description
Compute the square root of x in round-towards-zero mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.

__device__ float __fsub_rd (float x, float y)

Subtract two floating point values in round-down mode.

Returns
Returns x - y.

[Link]
CUDA Math API vRelease Version | 271
 Modules

Description
Compute the difference of x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fsub_rn (float x, float y)

Subtract two floating point values in round-to-nearest-even mode.

Returns
Returns x - y.

Description
Compute the difference of x and y in round-to-nearest-even rounding mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __fsub_ru (float x, float y)

Subtract two floating point values in round-up mode.

Returns
Returns x - y.

Description
Compute the difference of x and y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

[Link]
CUDA Math API vRelease Version | 272
 Modules

__device__ float __fsub_rz (float x, float y)

Subtract two floating point values in round-towards-zero mode.

Returns
Returns x - y.

Description
Compute the difference of x and y in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 6.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ float __log10f (float x)

Calculate the fast approximate base 10 logarithm of the input argument.

Returns
Returns an approximation to .

Description
Calculate the fast approximate base 10 logarithm of the input argument x.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Most input and output values around denormal range are flushed to sign
preserving 0.0.

__device__ float __log2f (float x)

Calculate the fast approximate base 2 logarithm of the input argument.

Returns
Returns an approximation to .

Description
Calculate the fast approximate base 2 logarithm of the input argument x.

[Link]
CUDA Math API vRelease Version | 273
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Input and output in the denormal range is flushed to sign preserving 0.0.

__device__ float __logf (float x)

Calculate the fast approximate base logarithm of the input argument.

Returns
Returns an approximation to .

Description
Calculate the fast approximate base logarithm of the input argument x.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Most input and output values around denormal range are flushed to sign
preserving 0.0.

__device__ float __powf (float x, float y)

Calculate the fast approximate of .

Returns
Returns an approximation to .

Description
Calculate the fast approximate of x, the first input argument, raised to the power of y,
the second input argument, .

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Most input and output values around denormal range are flushed to sign
preserving 0.0.

[Link]
CUDA Math API vRelease Version | 274
 Modules

__device__ float __saturatef (float x)

Clamp the input argument to [+0.0, 1.0].

Returns
‣ __saturatef(x) returns 0 if x < 0.
‣ __saturatef(x) returns 1 if x > 1.
‣ __saturatef(x) returns x if .
‣ __saturatef(NaN) returns 0.

Description
Clamp the input argument x to be within the interval [+0.0, 1.0].

__device__ void __sincosf (float x, float *sptr, float

*cptr)
Calculate the fast approximate of sine and cosine of the first input argument.

Returns
‣ none

Description
Calculate the fast approximate of sine and cosine of the first input argument x
(measured in radians). The results for sine and cosine are written into the second
argument, sptr, and, respectively, third argument, cptr.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Denorm input/output is flushed to sign preserving 0.0.

__device__ float __sinf (float x)

Calculate the fast approximate sine of the input argument.

Returns
Returns the approximate sine of x.

Description
Calculate the fast approximate sine of the input argument x, measured in radians.

[Link]
CUDA Math API vRelease Version | 275
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ Input and output in the denormal range is flushed to sign preserving 0.0.

__device__ float __tanf (float x)

Calculate the fast approximate tangent of the input argument.

Returns
Returns the approximate tangent of x.

Description
Calculate the fast approximate tangent of the input argument x, measured in radians.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.2, Table 9.
‣ The result is computed as the fast divide of __sinf() by __cosf(). Denormal input
and output are flushed to sign-preserving 0.0 at each step of the computation.

1.7. Double Precision Intrinsics

This section describes double precision intrinsic functions that are only supported in
device code. To use these functions you do not need to include any additional header
files in your program.

__device__ double __dadd_rd (double x, double y)

Add two floating point values in round-down mode.

Returns
Returns x + y.

Description
Adds two floating point values x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 276
 Modules

‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dadd_rn (double x, double y)

Add two floating point values in round-to-nearest-even mode.

Returns
Returns x + y.

Description
Adds two floating point values x and y in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dadd_ru (double x, double y)

Add two floating point values in round-up mode.

Returns
Returns x + y.

Description
Adds two floating point values x and y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dadd_rz (double x, double y)

Add two floating point values in round-towards-zero mode.

Returns
Returns x + y.

Description
Adds two floating point values x and y in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 277
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __ddiv_rd (double x, double y)

Divide two floating point values in round-down mode.

Returns
Returns x / y.

Description
Divides two floating point values x by y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __ddiv_rn (double x, double y)

Divide two floating point values in round-to-nearest-even mode.

Returns
Returns x / y.

Description
Divides two floating point values x by y in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __ddiv_ru (double x, double y)

Divide two floating point values in round-up mode.

Returns
Returns x / y.

[Link]
CUDA Math API vRelease Version | 278
 Modules

Description
Divides two floating point values x by y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __ddiv_rz (double x, double y)

Divide two floating point values in round-towards-zero mode.

Returns
Returns x / y.

Description
Divides two floating point values x by y in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __dmul_rd (double x, double y)

Multiply two floating point values in round-down mode.

Returns
Returns x * y.

Description
Multiplies two floating point values x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

[Link]
CUDA Math API vRelease Version | 279
 Modules

__device__ double __dmul_rn (double x, double y)

Multiply two floating point values in round-to-nearest-even mode.

Returns
Returns x * y.

Description
Multiplies two floating point values x and y in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dmul_ru (double x, double y)

Multiply two floating point values in round-up mode.

Returns
Returns x * y.

Description
Multiplies two floating point values x and y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dmul_rz (double x, double y)

Multiply two floating point values in round-towards-zero mode.

Returns
Returns x * y.

Description
Multiplies two floating point values x and y in round-towards-zero mode.

[Link]
CUDA Math API vRelease Version | 280
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __drcp_rd (double x)

Compute in round-down mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __drcp_rn (double x)

Compute in round-to-nearest-even mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

[Link]
CUDA Math API vRelease Version | 281
 Modules

__device__ double __drcp_ru (double x)

Compute in round-up mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __drcp_rz (double x)

Compute in round-towards-zero mode.

Returns

Returns .

Description
Compute the reciprocal of x in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __dsqrt_rd (double x)

Compute in round-down mode.

Returns

Returns .

Description
Compute the square root of x in round-down (to negative infinity) mode.

[Link]
CUDA Math API vRelease Version | 282
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __dsqrt_rn (double x)

Compute in round-to-nearest-even mode.

Returns

Returns .

Description
Compute the square root of x in round-to-nearest-even mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __dsqrt_ru (double x)

Compute in round-up mode.

Returns

Returns .

Description
Compute the square root of x in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

[Link]
CUDA Math API vRelease Version | 283
 Modules

__device__ double __dsqrt_rz (double x)

Compute in round-towards-zero mode.

Returns

Returns .

Description
Compute the square root of x in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ Requires compute capability >= 2.0.

__device__ double __dsub_rd (double x, double y)

Subtract two floating point values in round-down mode.

Returns
Returns x - y.

Description
Subtracts two floating point values x and y in round-down (to negative infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dsub_rn (double x, double y)

Subtract two floating point values in round-to-nearest-even mode.

Returns
Returns x - y.

Description
Subtracts two floating point values x and y in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 284
 Modules

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dsub_ru (double x, double y)

Subtract two floating point values in round-up mode.

Returns
Returns x - y.

Description
Subtracts two floating point values x and y in round-up (to positive infinity) mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

__device__ double __dsub_rz (double x, double y)

Subtract two floating point values in round-towards-zero mode.

Returns
Returns x - y.

Description
Subtracts two floating point values x and y in round-towards-zero mode.

‣ For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.
‣ This operation will never be merged into a single multiply-add instruction.

[Link]
CUDA Math API vRelease Version | 285
 Modules

__device__ double __fma_rd (double x, double y,

double z)
Compute as a single operation in round-down mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact
‣ fmaf(x, y, ) returns NaN if is an exact

Description
Computes the value of as a single ternary operation, rounding the result once
in round-down (to negative infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double __fma_rn (double x, double y,

double z)
Compute as a single operation in round-to-nearest-even mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact
‣ fmaf(x, y, ) returns NaN if is an exact

Description
Computes the value of as a single ternary operation, rounding the result once
in round-to-nearest-even mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 286
 Modules

__device__ double __fma_ru (double x, double y,

double z)
Compute as a single operation in round-up mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact
‣ fmaf(x, y, ) returns NaN if is an exact

Description
Computes the value of as a single ternary operation, rounding the result once
in round-up (to positive infinity) mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

__device__ double __fma_rz (double x, double y, double

z)
Compute as a single operation in round-towards-zero mode.

Returns
Returns the rounded value of as a single operation.

‣ fmaf( , , z) returns NaN.

‣ fmaf( , , z) returns NaN.
‣ fmaf(x, y, ) returns NaN if is an exact
‣ fmaf(x, y, ) returns NaN if is an exact

Description
Computes the value of as a single ternary operation, rounding the result once
in round-towards-zero mode.

For accuracy information for this function see the CUDA C Programming Guide,
Appendix D.1, Table 7.

[Link]
CUDA Math API vRelease Version | 287
 Modules

1.8. Integer Intrinsics

This section describes integer intrinsic functions that are only supported in device code.
To use these functions you do not need to include any additional header files in your
program.

__device__ unsigned int __brev (unsigned int x)

Reverse the bit order of a 32 bit unsigned integer.

Returns
Returns the bit-reversed value of x. i.e. bit N of the return value corresponds to bit 31-N
of x.

Description
Reverses the bit order of the 32 bit unsigned integer x.

__device__ unsigned long long int __brevll (unsigned

long long int x)
Reverse the bit order of a 64 bit unsigned integer.

Returns
Returns the bit-reversed value of x. i.e. bit N of the return value corresponds to bit 63-N
of x.

Description
Reverses the bit order of the 64 bit unsigned integer x.

__device__ unsigned int __byte_perm (unsigned int x,

unsigned int y, unsigned int s)
Return selected bytes from two 32 bit unsigned integers.

Returns
The returned value r is computed to be: result[n] := input[selector[n]]
where result[n] is the nth byte of r.

[Link]
CUDA Math API vRelease Version | 288
 Modules

Description
byte_perm(x,y,s) returns a 32-bit integer consisting of four bytes from eight input bytes
provided in the two input integers x and y, as specified by a selector, s.
The input bytes are indexed as follows: input[0] = x<7:0> input[1] = x<15:8> input[2]
= x<23:16> input[3] = x<31:24> input[4] = y<7:0> input[5] = y<15:8> input[6] = y<23:16>
input[7] = y<31:24> The selector indices are as follows (the upper 16-bits of the selector
are not used): selector[0] = s<2:0> selector[1] = s<6:4> selector[2] = s<10:8> selector[3] =
s<14:12>

__device__ int __clz (int x)

Return the number of consecutive high-order zero bits in a 32 bit integer.

Returns
Returns a value between 0 and 32 inclusive representing the number of zero bits.

Description
Count the number of consecutive leading zero bits, starting at the most significant bit
(bit 31) of x.

__device__ int __clzll (long long int x)

Count the number of consecutive high-order zero bits in a 64 bit integer.

Returns
Returns a value between 0 and 64 inclusive representing the number of zero bits.

Description
Count the number of consecutive leading zero bits, starting at the most significant bit
(bit 63) of x.

__device__ int __ffs (int x)

Find the position of the least significant bit set to 1 in a 32 bit integer.

Returns
Returns a value between 0 and 32 inclusive representing the position of the first bit set.

‣ __ffs(0) returns 0.

[Link]
CUDA Math API vRelease Version | 289
 Modules

Description
Find the position of the first (least significant) bit set to 1 in x, where the least significant
bit position is 1.

__device__ int __ffsll (long long int x)

Find the position of the least significant bit set to 1 in a 64 bit integer.

Returns
Returns a value between 0 and 64 inclusive representing the position of the first bit set.

‣ __ffsll(0) returns 0.

Description
Find the position of the first (least significant) bit set to 1 in x, where the least significant
bit position is 1.

__device__ unsigned int __funnelshift_l (unsigned int lo,

unsigned int hi, unsigned int shift)
Concatenate hi : lo, shift left by shift & 31 bits, return the most significant 32 bits.

Returns
Returns the most significant 32 bits of the shifted 64-bit value.

Description
Shift the 64-bit value formed by concatenating argument lo and hi left by the amount
specified by the argument shift. Argument lo holds bits 31:0 and argument hi holds
bits 63:32 of the 64-bit source value. The source is shifted left by the wrapped value of
shift (shift & 31). The most significant 32-bits of the result are returned.

__device__ unsigned int __funnelshift_lc (unsigned int

lo, unsigned int hi, unsigned int shift)
Concatenate hi : lo, shift left by min(shift, 32) bits, return the most significant 32 bits.

Returns
Returns the most significant 32 bits of the shifted 64-bit value.

Description
Shift the 64-bit value formed by concatenating argument lo and hi left by the amount
specified by the argument shift. Argument lo holds bits 31:0 and argument hi holds

[Link]
CUDA Math API vRelease Version | 290
 Modules

bits 63:32 of the 64-bit source value. The source is shifted left by the clamped value of
shift (min(shift, 32)). The most significant 32-bits of the result are returned.

__device__ unsigned int __funnelshift_r (unsigned int

lo, unsigned int hi, unsigned int shift)
Concatenate hi : lo, shift right by shift & 31 bits, return the least significant 32 bits.

Returns
Returns the least significant 32 bits of the shifted 64-bit value.

Description
Shift the 64-bit value formed by concatenating argument lo and hi right by the amount
specified by the argument shift. Argument lo holds bits 31:0 and argument hi holds
bits 63:32 of the 64-bit source value. The source is shifted right by the wrapped value of
shift (shift & 31). The least significant 32-bits of the result are returned.

__device__ unsigned int __funnelshift_rc (unsigned int

lo, unsigned int hi, unsigned int shift)
Concatenate hi : lo, shift right by min(shift, 32) bits, return the least significant 32
bits.

Returns
Returns the least significant 32 bits of the shifted 64-bit value.

Description
Shift the 64-bit value formed by concatenating argument lo and hi right by the amount
specified by the argument shift. Argument lo holds bits 31:0 and argument hi holds
bits 63:32 of the 64-bit source value. The source is shifted right by the clamped value of
shift (min(shift, 32)). The least significant 32-bits of the result are returned.

__device__ int __hadd (int, int)

Compute average of signed input arguments, avoiding overflow in the intermediate
sum.

Returns
Returns a signed integer value representing the signed average value of the two inputs.

[Link]
CUDA Math API vRelease Version | 291
 Modules

Description
Compute average of signed input arguments x and y as ( x + y ) >> 1, avoiding overflow
in the intermediate sum.

__device__ int __mul24 (int x, int y)

Calculate the least significant 32 bits of the product of the least significant 24 bits of two
integers.

Returns
Returns the least significant 32 bits of the product x * y.

Description
Calculate the least significant 32 bits of the product of the least significant 24 bits of x
and y. The high order 8 bits of x and y are ignored.

__device__ long long int __mul64hi (long long int x, long

long int y)
Calculate the most significant 64 bits of the product of the two 64 bit integers.

Returns
Returns the most significant 64 bits of the product x * y.

Description
Calculate the most significant 64 bits of the 128-bit product x * y, where x and y are 64-
bit integers.

__device__ int __mulhi (int x, int y)

Calculate the most significant 32 bits of the product of the two 32 bit integers.

Returns
Returns the most significant 32 bits of the product x * y.

Description
Calculate the most significant 32 bits of the 64-bit product x * y, where x and y are 32-bit
integers.

[Link]
CUDA Math API vRelease Version | 292
 Modules

__device__ int __popc (unsigned int x)

Count the number of bits that are set to 1 in a 32 bit integer.

Returns
Returns a value between 0 and 32 inclusive representing the number of set bits.

Description
Count the number of bits that are set to 1 in x.

__device__ int __popcll (unsigned long long int x)

Count the number of bits that are set to 1 in a 64 bit integer.

Returns
Returns a value between 0 and 64 inclusive representing the number of set bits.

Description
Count the number of bits that are set to 1 in x.

__device__ int __rhadd (int, int)

Compute rounded average of signed input arguments, avoiding overflow in the
intermediate sum.

Returns
Returns a signed integer value representing the signed rounded average value of the two
inputs.

Description
Compute average of signed input arguments x and y as ( x + y + 1 ) >> 1, avoiding
overflow in the intermediate sum.

__device__ unsigned int __sad (int x, int y, unsigned int

z)
Calculate , the sum of absolute difference.

Returns
Returns .

[Link]
CUDA Math API vRelease Version | 293
 Modules

Description
Calculate , the 32-bit sum of the third argument z plus and the absolute value
of the difference between the first argument, x, and second argument, y.
Inputs x and y are signed 32-bit integers, input z is a 32-bit unsigned integer.

__device__ unsigned int __uhadd (unsigned int,

unsigned int)
Compute average of unsigned input arguments, avoiding overflow in the intermediate
sum.

Returns
Returns an unsigned integer value representing the unsigned average value of the two
inputs.

Description
Compute average of unsigned input arguments x and y as ( x + y ) >> 1, avoiding
overflow in the intermediate sum.

__device__ unsigned int __umul24 (unsigned int x,

unsigned int y)
Calculate the least significant 32 bits of the product of the least significant 24 bits of two
unsigned integers.

Returns
Returns the least significant 32 bits of the product x * y.

Description
Calculate the least significant 32 bits of the product of the least significant 24 bits of x
and y. The high order 8 bits of x and y are ignored.

__device__ unsigned long long int __umul64hi (unsigned

long long int x, unsigned long long int y)
Calculate the most significant 64 bits of the product of the two 64 unsigned bit integers.

Returns
Returns the most significant 64 bits of the product x * y.

[Link]
CUDA Math API vRelease Version | 294
 Modules

Description
Calculate the most significant 64 bits of the 128-bit product x * y, where x and y are 64-
bit unsigned integers.

__device__ unsigned int __umulhi (unsigned int x,

unsigned int y)
Calculate the most significant 32 bits of the product of the two 32 bit unsigned integers.

Returns
Returns the most significant 32 bits of the product x * y.

Description
Calculate the most significant 32 bits of the 64-bit product x * y, where x and y are 32-bit
unsigned integers.

__device__ unsigned int __urhadd (unsigned int,

unsigned int)
Compute rounded average of unsigned input arguments, avoiding overflow in the
intermediate sum.

Returns
Returns an unsigned integer value representing the unsigned rounded average value of
the two inputs.

Description
Compute average of unsigned input arguments x and y as ( x + y + 1 ) >> 1, avoiding
overflow in the intermediate sum.

__device__ unsigned int __usad (unsigned int x,

unsigned int y, unsigned int z)
Calculate , the sum of absolute difference.

Returns
Returns .

Description
Calculate , the 32-bit sum of the third argument z plus and the absolute value
of the difference between the first argument, x, and second argument, y.

[Link]
CUDA Math API vRelease Version | 295
 Modules

Inputs x, y, and z are unsigned 32-bit integers.

1.9. Type Casting Intrinsics

This section describes type casting intrinsic functions that are only supported in device
code. To use these functions you do not need to include any additional header files in
your program.

__device__ float __double2float_rd (double x)

Convert a double to a float in round-down mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a single-precision floating point
value in round-down (to negative infinity) mode.

__device__ float __double2float_rn (double x)

Convert a double to a float in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a single-precision floating point
value in round-to-nearest-even mode.

__device__ float __double2float_ru (double x)

Convert a double to a float in round-up mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a single-precision floating point
value in round-up (to positive infinity) mode.

[Link]
CUDA Math API vRelease Version | 296
 Modules

__device__ float __double2float_rz (double x)

Convert a double to a float in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a single-precision floating point
value in round-towards-zero mode.

__device__ int __double2hiint (double x)

Reinterpret high 32 bits in a double as a signed integer.

Returns
Returns reinterpreted value.

Description
Reinterpret the high 32 bits in the double-precision floating point value x as a signed
integer.

__device__ int __double2int_rd (double x)

Convert a double to a signed int in round-down mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed integer value in round-
down (to negative infinity) mode.

__device__ int __double2int_rn (double x)

Convert a double to a signed int in round-to-nearest-even mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 297
 Modules

Description
Convert the double-precision floating point value x to a signed integer value in round-
to-nearest-even mode.

__device__ int __double2int_ru (double x)

Convert a double to a signed int in round-up mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed integer value in round-
up (to positive infinity) mode.

__device__ int __double2int_rz (double)

Convert a double to a signed int in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed integer value in round-
towards-zero mode.

__device__ long long int __double2ll_rd (double x)

Convert a double to a signed 64-bit int in round-down mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed 64-bit integer value in
round-down (to negative infinity) mode.

[Link]
CUDA Math API vRelease Version | 298
 Modules

__device__ long long int __double2ll_rn (double x)

Convert a double to a signed 64-bit int in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed 64-bit integer value in
round-to-nearest-even mode.

__device__ long long int __double2ll_ru (double x)

Convert a double to a signed 64-bit int in round-up mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed 64-bit integer value in
round-up (to positive infinity) mode.

__device__ long long int __double2ll_rz (double)

Convert a double to a signed 64-bit int in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to a signed 64-bit integer value in
round-towards-zero mode.

__device__ int __double2loint (double x)

Reinterpret low 32 bits in a double as a signed integer.

Returns
Returns reinterpreted value.

[Link]
CUDA Math API vRelease Version | 299
 Modules

Description
Reinterpret the low 32 bits in the double-precision floating point value x as a signed
integer.

__device__ unsigned int __double2uint_rd (double x)

Convert a double to an unsigned int in round-down mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned integer value in
round-down (to negative infinity) mode.

__device__ unsigned int __double2uint_rn (double x)

Convert a double to an unsigned int in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned integer value in
round-to-nearest-even mode.

__device__ unsigned int __double2uint_ru (double x)

Convert a double to an unsigned int in round-up mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned integer value in
round-up (to positive infinity) mode.

[Link]
CUDA Math API vRelease Version | 300
 Modules

__device__ unsigned int __double2uint_rz (double)

Convert a double to an unsigned int in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned integer value in
round-towards-zero mode.

__device__ unsigned long long int __double2ull_rd

(double x)
Convert a double to an unsigned 64-bit int in round-down mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned 64-bit integer value
in round-down (to negative infinity) mode.

__device__ unsigned long long int __double2ull_rn

(double x)
Convert a double to an unsigned 64-bit int in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned 64-bit integer value
in round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 301
 Modules

__device__ unsigned long long int __double2ull_ru

(double x)
Convert a double to an unsigned 64-bit int in round-up mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned 64-bit integer value
in round-up (to positive infinity) mode.

__device__ unsigned long long int __double2ull_rz

(double)
Convert a double to an unsigned 64-bit int in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the double-precision floating point value x to an unsigned 64-bit integer value
in round-towards-zero mode.

__device__ long long int __double_as_longlong (double

x)
Reinterpret bits in a double as a 64-bit signed integer.

Returns
Returns reinterpreted value.

Description
Reinterpret the bits in the double-precision floating point value x as a signed 64-bit
integer.

[Link]
CUDA Math API vRelease Version | 302
 Modules

__device__ int __float2int_rd (float x)

Convert a float to a signed integer in round-down mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed integer in round-down (to
negative infinity) mode.

__device__ int __float2int_rn (float x)

Convert a float to a signed integer in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed integer in round-to-
nearest-even mode.

__device__ int __float2int_ru (float)

Convert a float to a signed integer in round-up mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed integer in round-up (to
positive infinity) mode.

__device__ int __float2int_rz (float x)

Convert a float to a signed integer in round-towards-zero mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 303
 Modules

Description
Convert the single-precision floating point value x to a signed integer in round-towards-
zero mode.

__device__ long long int __float2ll_rd (float x)

Convert a float to a signed 64-bit integer in round-down mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed 64-bit integer in round-
down (to negative infinity) mode.

__device__ long long int __float2ll_rn (float x)

Convert a float to a signed 64-bit integer in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed 64-bit integer in round-to-
nearest-even mode.

__device__ long long int __float2ll_ru (float x)

Convert a float to a signed 64-bit integer in round-up mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed 64-bit integer in round-up
(to positive infinity) mode.

[Link]
CUDA Math API vRelease Version | 304
 Modules

__device__ long long int __float2ll_rz (float x)

Convert a float to a signed 64-bit integer in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to a signed 64-bit integer in round-
towards-zero mode.

__device__ unsigned int __float2uint_rd (float x)

Convert a float to an unsigned integer in round-down mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned integer in round-
down (to negative infinity) mode.

__device__ unsigned int __float2uint_rn (float x)

Convert a float to an unsigned integer in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned integer in round-to-
nearest-even mode.

__device__ unsigned int __float2uint_ru (float x)

Convert a float to an unsigned integer in round-up mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 305
 Modules

Description
Convert the single-precision floating point value x to an unsigned integer in round-up
(to positive infinity) mode.

__device__ unsigned int __float2uint_rz (float x)

Convert a float to an unsigned integer in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned integer in round-
towards-zero mode.

__device__ unsigned long long int __float2ull_rd (float

x)
Convert a float to an unsigned 64-bit integer in round-down mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned 64-bit integer in
round-down (to negative infinity) mode.

__device__ unsigned long long int __float2ull_rn (float

x)
Convert a float to an unsigned 64-bit integer in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned 64-bit integer in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 306
 Modules

__device__ unsigned long long int __float2ull_ru (float

x)
Convert a float to an unsigned 64-bit integer in round-up mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned 64-bit integer in
round-up (to positive infinity) mode.

__device__ unsigned long long int __float2ull_rz (float

x)
Convert a float to an unsigned 64-bit integer in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the single-precision floating point value x to an unsigned 64-bit integer in
round-towards_zero mode.

__device__ int __float_as_int (float x)

Reinterpret bits in a float as a signed integer.

Returns
Returns reinterpreted value.

Description
Reinterpret the bits in the single-precision floating point value x as a signed integer.

__device__ unsigned int __float_as_uint (float x)

Reinterpret bits in a float as a unsigned integer.

Returns
Returns reinterpreted value.

[Link]
CUDA Math API vRelease Version | 307
 Modules

Description
Reinterpret the bits in the single-precision floating point value x as a unsigned integer.

__device__ double __hiloint2double (int hi, int lo)

Reinterpret high and low 32-bit integer values as a double.

Returns
Returns reinterpreted value.

Description
Reinterpret the integer value of hi as the high 32 bits of a double-precision floating
point value and the integer value of lo as the low 32 bits of the same double-precision
floating point value.

__device__ double __int2double_rn (int x)

Convert a signed int to a double.

Returns
Returns converted value.

Description
Convert the signed integer value x to a double-precision floating point value.

__device__ float __int2float_rd (int x)

Convert a signed integer to a float in round-down mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-
down (to negative infinity) mode.

__device__ float __int2float_rn (int x)

Convert a signed integer to a float in round-to-nearest-even mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 308
 Modules

Description
Convert the signed integer value x to a single-precision floating point value in round-to-
nearest-even mode.

__device__ float __int2float_ru (int x)

Convert a signed integer to a float in round-up mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-up
(to positive infinity) mode.

__device__ float __int2float_rz (int x)

Convert a signed integer to a float in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-
towards-zero mode.

__device__ float __int_as_float (int x)

Reinterpret bits in an integer as a float.

Returns
Returns reinterpreted value.

Description
Reinterpret the bits in the signed integer value x as a single-precision floating point
value.

[Link]
CUDA Math API vRelease Version | 309
 Modules

__device__ double __ll2double_rd (long long int x)

Convert a signed 64-bit int to a double in round-down mode.

Returns
Returns converted value.

Description
Convert the signed 64-bit integer value x to a double-precision floating point value in
round-down (to negative infinity) mode.

__device__ double __ll2double_rn (long long int x)

Convert a signed 64-bit int to a double in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the signed 64-bit integer value x to a double-precision floating point value in
round-to-nearest-even mode.

__device__ double __ll2double_ru (long long int x)

Convert a signed 64-bit int to a double in round-up mode.

Returns
Returns converted value.

Description
Convert the signed 64-bit integer value x to a double-precision floating point value in
round-up (to positive infinity) mode.

__device__ double __ll2double_rz (long long int x)

Convert a signed 64-bit int to a double in round-towards-zero mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 310
 Modules

Description
Convert the signed 64-bit integer value x to a double-precision floating point value in
round-towards-zero mode.

__device__ float __ll2float_rd (long long int x)

Convert a signed integer to a float in round-down mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-
down (to negative infinity) mode.

__device__ float __ll2float_rn (long long int x)

Convert a signed 64-bit integer to a float in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the signed 64-bit integer value x to a single-precision floating point value in
round-to-nearest-even mode.

__device__ float __ll2float_ru (long long int x)

Convert a signed integer to a float in round-up mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-up
(to positive infinity) mode.

[Link]
CUDA Math API vRelease Version | 311
 Modules

__device__ float __ll2float_rz (long long int x)

Convert a signed integer to a float in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the signed integer value x to a single-precision floating point value in round-
towards-zero mode.

__device__ double __longlong_as_double (long long int

x)
Reinterpret bits in a 64-bit signed integer as a double.

Returns
Returns reinterpreted value.

Description
Reinterpret the bits in the 64-bit signed integer value x as a double-precision floating
point value.

__device__ double __uint2double_rn (unsigned int x)

Convert an unsigned int to a double.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a double-precision floating point value.

__device__ float __uint2float_rd (unsigned int x)

Convert an unsigned integer to a float in round-down mode.

Returns
Returns converted value.

[Link]
CUDA Math API vRelease Version | 312
 Modules

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
down (to negative infinity) mode.

__device__ float __uint2float_rn (unsigned int x)

Convert an unsigned integer to a float in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
to-nearest-even mode.

__device__ float __uint2float_ru (unsigned int x)

Convert an unsigned integer to a float in round-up mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
up (to positive infinity) mode.

__device__ float __uint2float_rz (unsigned int x)

Convert an unsigned integer to a float in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 313
 Modules

__device__ float __uint_as_float (unsigned int x)

Reinterpret bits in an unsigned integer as a float.

Returns
Returns reinterpreted value.

Description
Reinterpret the bits in the unsigned integer value x as a single-precision floating point
value.

__device__ double __ull2double_rd (unsigned long long

int x)
Convert an unsigned 64-bit int to a double in round-down mode.

Returns
Returns converted value.

Description
Convert the unsigned 64-bit integer value x to a double-precision floating point value in
round-down (to negative infinity) mode.

__device__ double __ull2double_rn (unsigned long long

int x)
Convert an unsigned 64-bit int to a double in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the unsigned 64-bit integer value x to a double-precision floating point value in
round-to-nearest-even mode.

[Link]
CUDA Math API vRelease Version | 314
 Modules

__device__ double __ull2double_ru (unsigned long long

int x)
Convert an unsigned 64-bit int to a double in round-up mode.

Returns
Returns converted value.

Description
Convert the unsigned 64-bit integer value x to a double-precision floating point value in
round-up (to positive infinity) mode.

__device__ double __ull2double_rz (unsigned long long

int x)
Convert an unsigned 64-bit int to a double in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the unsigned 64-bit integer value x to a double-precision floating point value in
round-towards-zero mode.

__device__ float __ull2float_rd (unsigned long long int

x)
Convert an unsigned integer to a float in round-down mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
down (to negative infinity) mode.

[Link]
CUDA Math API vRelease Version | 315
 Modules

__device__ float __ull2float_rn (unsigned long long int

x)
Convert an unsigned integer to a float in round-to-nearest-even mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
to-nearest-even mode.

__device__ float __ull2float_ru (unsigned long long int

x)
Convert an unsigned integer to a float in round-up mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
up (to positive infinity) mode.

__device__ float __ull2float_rz (unsigned long long int

x)
Convert an unsigned integer to a float in round-towards-zero mode.

Returns
Returns converted value.

Description
Convert the unsigned integer value x to a single-precision floating point value in round-
towards-zero mode.

[Link]
CUDA Math API vRelease Version | 316
 Modules

1.10. SIMD Intrinsics

This section describes SIMD intrinsic functions that are only supported in device code.
To use these functions you do not need to include any additional header files in your
program.

__device__ unsigned int __vabs2 (unsigned int a)

Computes per-halfword absolute value.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 2 parts, each consisting of 2 bytes, then computes
absolute value for each of parts. Result is stored as unsigned int and returned.

__device__ unsigned int __vabs4 (unsigned int a)

Computes per-byte absolute value.

Returns
Returns computed value.

Description
Splits argument by bytes. Computes absolute value of each byte. Result is stored as
unsigned int.

__device__ unsigned int __vabsdiffs2 (unsigned int a,

unsigned int b)
Computes per-halfword sum of absolute difference of signed integer.

Returns
Returns computed value.

Description
Splits 4 bytes of each into 2 parts, each consisting of 2 bytes. For corresponding parts
function computes absolute difference. Result is stored as unsigned int and returned.

[Link]
CUDA Math API vRelease Version | 317
 Modules

__device__ unsigned int __vabsdiffs4 (unsigned int a,

unsigned int b)
Computes per-byte absolute difference of signed integer.

Returns
Returns computed value.

Description
Splits 4 bytes of each into 4 parts, each consisting of 1 byte. For corresponding parts
function computes absolute difference. Result is stored as unsigned int and returned.

__device__ unsigned int __vabsdiffu2 (unsigned int a,

unsigned int b)
Performs per-halfword absolute difference of unsigned integer computation: |a - b|.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes absolute difference. Result is stored as unsigned
int and returned.

__device__ unsigned int __vabsdiffu4 (unsigned int a,

unsigned int b)
Computes per-byte absolute difference of unsigned integer.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes absolute difference. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 318
 Modules

__device__ unsigned int __vabsss2 (unsigned int a)

Computes per-halfword absolute value with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 2 parts, each consisting of 2 bytes, then computes
absolute value with signed saturation for each of parts. Result is stored as unsigned int
and returned.

__device__ unsigned int __vabsss4 (unsigned int a)

Computes per-byte absolute value with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 4 parts, each consisting of 1 byte, then computes absolute
value with signed saturation for each of parts. Result is stored as unsigned int and
returned.

__device__ unsigned int __vadd2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed addition, with wrap-around: a + b.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes, then performs
unsigned addition on corresponding parts. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 319
 Modules

__device__ unsigned int __vadd4 (unsigned int a,

unsigned int b)
Performs per-byte (un)signed addition.

Returns
Returns computed value.

Description
Splits 'a' into 4 bytes, then performs unsigned addition on each of these bytes with the
corresponding byte from 'b', ignoring overflow. Result is stored as unsigned int and
returned.

__device__ unsigned int __vaddss2 (unsigned int a,

unsigned int b)
Performs per-halfword addition with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes, then performs
addition with signed saturation on corresponding parts. Result is stored as unsigned int
and returned.

__device__ unsigned int __vaddss4 (unsigned int a,

unsigned int b)
Performs per-byte addition with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte, then performs
addition with signed saturation on corresponding parts. Result is stored as unsigned int
and returned.

[Link]
CUDA Math API vRelease Version | 320
 Modules

__device__ unsigned int __vaddus2 (unsigned int a,

unsigned int b)
Performs per-halfword addition with unsigned saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes, then performs
addition with unsigned saturation on corresponding parts.

__device__ unsigned int __vaddus4 (unsigned int a,

unsigned int b)
Performs per-byte addition with unsigned saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte, then performs
addition with unsigned saturation on corresponding parts.

__device__ unsigned int __vavgs2 (unsigned int a,

unsigned int b)
Performs per-halfword signed rounded average computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. then computes
signed rounded avarege of corresponding parts. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 321
 Modules

__device__ unsigned int __vavgs4 (unsigned int a,

unsigned int b)
Computes per-byte signed rounder average.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. then computes
signed rounded avarege of corresponding parts. Result is stored as unsigned int and
returned.

__device__ unsigned int __vavgu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned rounded average computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. then computes
unsigned rounded avarege of corresponding parts. Result is stored as unsigned int and
returned.

__device__ unsigned int __vavgu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned rounded average.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. then computes
unsigned rounded avarege of corresponding parts. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 322
 Modules

__device__ unsigned int __vcmpeq2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed comparison.

Returns
Returns 0xffff computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if they are equal, and 0000 otherwise. For example
__vcmpeq2(0x1234aba5, 0x1234aba6) returns 0xffff0000.

__device__ unsigned int __vcmpeq4 (unsigned int a,

unsigned int b)
Performs per-byte (un)signed comparison.

Returns
Returns 0xff if a = b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts result is ff if they are equal, and 00 otherwise. For example __vcmpeq4(0x1234aba5,
0x1234aba6) returns 0xffffff00.

__device__ unsigned int __vcmpges2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison: a >= b ? 0xffff : 0.

Returns
Returns 0xffff if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part >= 'b' part, and 0000 otherwise. For example
__vcmpges2(0x1234aba5, 0x1234aba6) returns 0xffff0000.

[Link]
CUDA Math API vRelease Version | 323
 Modules

__device__ unsigned int __vcmpges4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 0xff if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part >= 'b' part, and 00 otherwise. For example
__vcmpges4(0x1234aba5, 0x1234aba6) returns 0xffffff00.

__device__ unsigned int __vcmpgeu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison: a >= b ? 0xffff : 0.

Returns
Returns 0xffff if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part >= 'b' part, and 0000 otherwise. For example
__vcmpgeu2(0x1234aba5, 0x1234aba6) returns 0xffff0000.

__device__ unsigned int __vcmpgeu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 0xff if a = b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part >= 'b' part, and 00 otherwise. For example
__vcmpgeu4(0x1234aba5, 0x1234aba6) returns 0xffffff00.

[Link]
CUDA Math API vRelease Version | 324
 Modules

__device__ unsigned int __vcmpgts2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison: a > b ? 0xffff : 0.

Returns
Returns 0xffff if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part > 'b' part, and 0000 otherwise. For example
__vcmpgts2(0x1234aba5, 0x1234aba6) returns 0x00000000.

__device__ unsigned int __vcmpgts4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 0xff if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part > 'b' part, and 00 otherwise. For example
__vcmpgts4(0x1234aba5, 0x1234aba6) returns 0x00000000.

__device__ unsigned int __vcmpgtu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison: a > b ? 0xffff : 0.

Returns
Returns 0xffff if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part > 'b' part, and 0000 otherwise. For example
__vcmpgtu2(0x1234aba5, 0x1234aba6) returns 0x00000000.

[Link]
CUDA Math API vRelease Version | 325
 Modules

__device__ unsigned int __vcmpgtu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 0xff if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part > 'b' part, and 00 otherwise. For example
__vcmpgtu4(0x1234aba5, 0x1234aba6) returns 0x00000000.

__device__ unsigned int __vcmples2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison: a <= b ? 0xffff : 0.

Returns
Returns 0xffff if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part <= 'b' part, and 0000 otherwise. For example
__vcmples2(0x1234aba5, 0x1234aba6) returns 0xffffffff.

__device__ unsigned int __vcmples4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 0xff if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part <= 'b' part, and 00 otherwise. For example
__vcmples4(0x1234aba5, 0x1234aba6) returns 0xffffffff.

[Link]
CUDA Math API vRelease Version | 326
 Modules

__device__ unsigned int __vcmpleu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison: a <= b ? 0xffff : 0.

Returns
Returns 0xffff if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part <= 'b' part, and 0000 otherwise. For example
__vcmpleu2(0x1234aba5, 0x1234aba6) returns 0xffffffff.

__device__ unsigned int __vcmpleu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 0xff if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part <= 'b' part, and 00 otherwise. For example
__vcmpleu4(0x1234aba5, 0x1234aba6) returns 0xffffffff.

__device__ unsigned int __vcmplts2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison: a < b ? 0xffff : 0.

Returns
Returns 0xffff if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part < 'b' part, and 0000 otherwise. For example
__vcmplts2(0x1234aba5, 0x1234aba6) returns 0x0000ffff.

[Link]
CUDA Math API vRelease Version | 327
 Modules

__device__ unsigned int __vcmplts4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 0xff if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part < 'b' part, and 00 otherwise. For example
__vcmplts4(0x1234aba5, 0x1234aba6) returns 0x000000ff.

__device__ unsigned int __vcmpltu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison: a < b ? 0xffff : 0.

Returns
Returns 0xffff if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part < 'b' part, and 0000 otherwise. For example
__vcmpltu2(0x1234aba5, 0x1234aba6) returns 0x0000ffff.

__device__ unsigned int __vcmpltu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 0xff if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part < 'b' part, and 00 otherwise. For example
__vcmpltu4(0x1234aba5, 0x1234aba6) returns 0x000000ff.

[Link]
CUDA Math API vRelease Version | 328
 Modules

__device__ unsigned int __vcmpne2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed comparison: a != b ? 0xffff : 0.

Returns
Returns 0xffff if a != b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts result is ffff if 'a' part != 'b' part, and 0000 otherwise. For example
__vcmplts2(0x1234aba5, 0x1234aba6) returns 0x0000ffff.

__device__ unsigned int __vcmpne4 (unsigned int a,

unsigned int b)
Performs per-byte (un)signed comparison.

Returns
Returns 0xff if a != b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For
corresponding parts result is ff if 'a' part != 'b' part, and 00 otherwise. For example
__vcmplts4(0x1234aba5, 0x1234aba6) returns 0x000000ff.

__device__ unsigned int __vhaddu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned average computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. then computes
unsigned avarege of corresponding parts. Result is stored as unsigned int and returned.

[Link]
CUDA Math API vRelease Version | 329
 Modules

__device__ unsigned int __vhaddu4 (unsigned int a,

unsigned int b)
Computes per-byte unsigned average.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. then computes
unsigned avarege of corresponding parts. Result is stored as unsigned int and returned.

__device__ unsigned int __vmaxs2 (unsigned int a,

unsigned int b)
Performs per-halfword signed maximum computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes signed maximum. Result is stored as unsigned
int and returned.

__device__ unsigned int __vmaxs4 (unsigned int a,

unsigned int b)
Computes per-byte signed maximum.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes signed maximum. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 330
 Modules

__device__ unsigned int __vmaxu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned maximum computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes unsigned maximum. Result is stored as
unsigned int and returned.

__device__ unsigned int __vmaxu4 (unsigned int a,

unsigned int b)
Computes per-byte unsigned maximum.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes unsigned maximum. Result is stored as unsigned int and
returned.

__device__ unsigned int __vmins2 (unsigned int a,

unsigned int b)
Performs per-halfword signed minimum computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes signed minimum. Result is stored as unsigned
int and returned.

[Link]
CUDA Math API vRelease Version | 331
 Modules

__device__ unsigned int __vmins4 (unsigned int a,

unsigned int b)
Computes per-byte signed minimum.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes signed minimum. Result is stored as unsigned int and returned.

__device__ unsigned int __vminu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned minimum computation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes unsigned minimum. Result is stored as
unsigned int and returned.

__device__ unsigned int __vminu4 (unsigned int a,

unsigned int b)
Computes per-byte unsigned minimum.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes unsigned minimum. Result is stored as unsigned int and
returned.

[Link]
CUDA Math API vRelease Version | 332
 Modules

__device__ unsigned int __vneg2 (unsigned int a)

Computes per-halfword negation.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 2 parts, each consisting of 2 bytes. For each part function
computes negation. Result is stored as unsigned int and returned.

__device__ unsigned int __vneg4 (unsigned int a)

Performs per-byte negation.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 4 parts, each consisting of 1 byte. For each part function
computes negation. Result is stored as unsigned int and returned.

__device__ unsigned int __vnegss2 (unsigned int a)

Computes per-halfword negation with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of argument into 2 parts, each consisting of 2 bytes. For each part function
computes negation. Result is stored as unsigned int and returned.

__device__ unsigned int __vnegss4 (unsigned int a)

Performs per-byte negation with signed saturation.

Returns
Returns computed value.

[Link]
CUDA Math API vRelease Version | 333
 Modules

Description
Splits 4 bytes of argument into 4 parts, each consisting of 1 byte. For each part function
computes negation. Result is stored as unsigned int and returned.

__device__ unsigned int __vsads2 (unsigned int a,

unsigned int b)
Performs per-halfword sum of absolute difference of signed.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts functions computes absolute difference and sum it up. Result is
stored as unsigned int and returned.

__device__ unsigned int __vsads4 (unsigned int a,

unsigned int b)
Computes per-byte sum of abs difference of signed.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts functions computes absolute difference and sum it up. Result is stored as unsigned
int and returned.

__device__ unsigned int __vsadu2 (unsigned int a,

unsigned int b)
Computes per-halfword sum of abs diff of unsigned.

Returns
Returns computed value.

[Link]
CUDA Math API vRelease Version | 334
 Modules

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function computes absolute differences, and returns sum of those
differences.

__device__ unsigned int __vsadu4 (unsigned int a,

unsigned int b)
Computes per-byte sum af abs difference of unsigned.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function computes absolute differences, and returns sum of those differences.

__device__ unsigned int __vseteq2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed comparison.

Returns
Returns 1 if a = b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part == 'b' part. If both equalities
are satisfiad, function returns 1.

__device__ unsigned int __vseteq4 (unsigned int a,

unsigned int b)
Performs per-byte (un)signed comparison.

Returns
Returns 1 if a = b, else returns 0.

[Link]
CUDA Math API vRelease Version | 335
 Modules

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part == 'b' part. If both equalities are satisfiad,
function returns 1.

__device__ unsigned int __vsetges2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison.

Returns
Returns 1 if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part >= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetges4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 1 if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part >= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetgeu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned minimum unsigned comparison.

Returns
Returns 1 if a >= b, else returns 0.

[Link]
CUDA Math API vRelease Version | 336
 Modules

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part >= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetgeu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 1 if a >= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part >= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetgts2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison.

Returns
Returns 1 if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part > 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetgts4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 1 if a > b, else returns 0.

[Link]
CUDA Math API vRelease Version | 337
 Modules

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part > 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetgtu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison.

Returns
Returns 1 if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part > 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetgtu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 1 if a > b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part > 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetles2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned minimum computation.

Returns
Returns 1 if a <= b, else returns 0.

[Link]
CUDA Math API vRelease Version | 338
 Modules

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part <= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetles4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 1 if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part <= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetleu2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison.

Returns
Returns 1 if a <= b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part <= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetleu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 1 if a <= b, else returns 0.

[Link]
CUDA Math API vRelease Version | 339
 Modules

Description
Splits 4 bytes of each argument into 4 part, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part <= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetlts2 (unsigned int a,

unsigned int b)
Performs per-halfword signed comparison.

Returns
Returns 1 if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part <= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetlts4 (unsigned int a,

unsigned int b)
Performs per-byte signed comparison.

Returns
Returns 1 if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part <= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetltu2 (unsigned int a,

unsigned int b)
Performs per-halfword unsigned comparison.

Returns
Returns 1 if a < b, else returns 0.

[Link]
CUDA Math API vRelease Version | 340
 Modules

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part <= 'b' part. If both inequalities
are satisfied, function returns 1.

__device__ unsigned int __vsetltu4 (unsigned int a,

unsigned int b)
Performs per-byte unsigned comparison.

Returns
Returns 1 if a < b, else returns 0.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part <= 'b' part. If both inequalities are satisfied,
function returns 1.

__device__ unsigned int __vsetne2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed comparison.

Returns
Returns 1 if a != b, else returns 0.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts function performs comparison 'a' part != 'b' part. If both conditions
are satisfied, function returns 1.

__device__ unsigned int __vsetne4 (unsigned int a,

unsigned int b)
Performs per-byte (un)signed comparison.

Returns
Returns 1 if a != b, else returns 0.

[Link]
CUDA Math API vRelease Version | 341
 Modules

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts function performs comparison 'a' part != 'b' part. If both conditions are satisfied,
function returns 1.

__device__ unsigned int __vsub2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed substraction, with wrap-around.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts functions performs substraction. Result is stored as unsigned int
and returned.

__device__ unsigned int __vsub4 (unsigned int a,

unsigned int b)
Performs per-byte substraction.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts functions performs substraction. Result is stored as unsigned int and returned.

__device__ unsigned int __vsubss2 (unsigned int a,

unsigned int b)
Performs per-halfword (un)signed substraction, with signed saturation.

Returns
Returns computed value.

[Link]
CUDA Math API vRelease Version | 342
 Modules

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts functions performs substraction with signed saturation. Result is
stored as unsigned int and returned.

__device__ unsigned int __vsubss4 (unsigned int a,

unsigned int b)
Performs per-byte substraction with signed saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts functions performs substraction with signed saturation. Result is stored as
unsigned int and returned.

__device__ unsigned int __vsubus2 (unsigned int a,

unsigned int b)
Performs per-halfword substraction with unsigned saturation.

Returns
Returns computed value.

Description
Splits 4 bytes of each argument into 2 parts, each consisting of 2 bytes. For
corresponding parts functions performs substraction with unsigned saturation. Result is
stored as unsigned int and returned.

__device__ unsigned int __vsubus4 (unsigned int a,

unsigned int b)
Performs per-byte substraction with unsigned saturation.

Returns
Returns computed value.

[Link]
CUDA Math API vRelease Version | 343
 Modules

Description
Splits 4 bytes of each argument into 4 parts, each consisting of 1 byte. For corresponding
parts functions performs substraction with unsigned saturation. Result is stored as
unsigned int and returned.

[Link]
CUDA Math API vRelease Version | 344
Notice
ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS,
DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY,
"MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES,
EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE
MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF
NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR
PURPOSE.
Information furnished is believed to be accurate and reliable. However, NVIDIA
Corporation assumes no responsibility for the consequences of use of such
information or for any infringement of patents or other rights of third parties
that may result from its use. No license is granted by implication of otherwise
under any patent rights of NVIDIA Corporation. Specifications mentioned in this
publication are subject to change without notice. This publication supersedes and
replaces all other information previously supplied. NVIDIA Corporation products
are not authorized as critical components in life support devices or systems
without express written approval of NVIDIA Corporation.

Trademarks
NVIDIA and the NVIDIA logo are trademarks or registered trademarks of NVIDIA
Corporation in the U.S. and other countries. Other company and product names
may be trademarks of the respective companies with which they are associated.

Copyright
© 2007-2019 NVIDIA Corporation. All rights reserved.

[Link]