WORKITEMFUNCTIONS(3clc)

💖 WORK-ITEM BUILT-IN (3clc) 💖

okay bestie, welcome to the OpenCL Manual ✨ — specifically the page all about work-item built-ins, and honestly? this one is the moment. 🫶

---

🌸 NAME 🌸

Work-Item_Built-In_Functions — click an item in the table below for details about that function. (yes it's a table in the original, and no we're not doing tables here, so it's a list now, but every single entry is still here, no cap 💅)

• get_work_dim(3clc) — Number of dimensions in use
• get_global_size(3clc) — Number of global work items
• get_global_id(3clc) — Global work item ID value
• get_local_size(3clc) — Number of local work items
• get_local_id(3clc) — Local work item ID
• get_num_groups(3clc) — Number of work groups
• get_group_id(3clc) — Work group ID
• get_global_offset(3clc) — Work offset

---

✨ DESCRIPTION ✨

so, built-in work-item functions? they're your little intel crew 🕵️♀️💖 you use them to query:

• the number of dimensions
• the global and local work size that got specified to clEnqueueNDRangeKernel(3clc)
• the global and local identifier of each work-item while that kernel is being executed on a device

and here's the tea ☕ — when you're executing a kernel using clEnqueueTask(3clc), the number of dimensions, the global work size, and the local work size are all one. literally just 1. iconic behaviour honestly. 👑

---

📜 SPECIFICATION 📜

OpenCL Specification[1] — that's the source of truth, bestie. 🎀

---

👀 SEE ALSO 👀

• clEnqueueNDRangeKernel(3clc)
• clEnqueueTask(3clc)

go read those next, iykyk 🦋

---

🫶 AUTHORS 🫶

The Khronos Group — the collective. the moment. the icons. 👑

---

💜 COPYRIGHT 💜

Copyright © 2007-2011 The Khronos Group Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the following condition:

the above copyright notice and this permission notice shall be included in all copies or substantial portions of the Materials.

(that condition is not optional, bestie, don't skip it 🙈)

---

🎀 NOTES 🎀

1. OpenCL Specification page 242, section 6.12.1 - Work-Item Functions

---

and that's the whole page!! 🌈 from The Khronos Group, dated 01/14/2021, living under the title WORK-ITEM BUILT-IN(3clc) forever and ever. go query some work items, bestie, you got this 💅✨🍓