local.adoc

_header.adoc

__local

Address Space Qualifier.

__local
local

Description

The local or local address space name is used to describe variables that need to be allocated in local memory and are shared by all work-items of a work-group. Pointers to the local address space are allowed as arguments to functions (including kernel functions). Variables allocated in the __local address space inside a kernel function must occur at kernel function scope.

Notes

addressSpaceQualifiersInc.adoc

Example

// Examples of variables allocated in the __local address space
// inside a kernel function

kernel void my_func(...)
{
      local float      a;       // A single float allocated
                                // in local address space

      local float      b[10];   // An array of 10 floats
                                // allocated in local address space.
      if (...)
      {
          // example of variable in __local address space but not
          // declared at __kernel function scope.
          local float c;        // not allowed.
      }
}

Variables allocated in the __local address space inside a kernel function cannot be initialized.

    kernel void my_func(...)
    {
       local float a = 1;    // not allowed

       local float b;
       b = 1;                // allowed
    }

Note	Variables allocated in the __local address space inside a kernel function are allocated for each work-group executing the kernel and exist only for the lifetime of the work-group executing the kernel.

qualifierExampleInc.adoc

Also see

global, constant, __private, qualifiers

_footer.adoc