vload_half3clc

float vload_half(size_t offset, const __global half *p);

float vload_half(size_t offset, const __local half *p);

float vload_half(size_t offset, const __constant half *p);

float vload_half(size_t offset, const __private half *p);

Overview

Read sizeof(half) bytes of data from address (p + offset). The data read is interpreted as a half value.

The half value is converted to a float value and the float value is returned. The read address computed as (p + offset) must be 16-bit aligned.

An application that wants to use half and halfn types will need to include the #pragma OPENCL EXTENSION cl_khr_fp16(3clc) : enable directive.

Notes

Vector Data Load and Store Functions allow you to read and write vector types from a pointer to memory.

The generic type gentype is used to indicate the built-in data types char, uchar, short, ushort, int, uint, long, ulong, float, or double.

The generic type name gentypen represents n-element vectors of gentype elements. The suffix n is also used in the function names (i.e. vloadn, vstoren, etc.), where n = 2, 3, 4, 8, or 16.

The results of vector data load and store functions are undefined if the address being read from or written to is not correctly aligned. The pointer argument p can be a pointer to global(3clc), local(3clc), or private(3clc) memory for store functions. The pointer argument p can be a pointer to __global, __local, constant(3clc) or __private memory for load functions.

Specification

OpenCL Specification[1]

Notes

1.

OpenCL Specification

page 267, section 6.12.7 - Vector Data Load and Store Functions