---
title: dispatch_workloop_create
framework: dispatch
role: symbol
role_heading: Function
path: dispatch/dispatch_workloop_create
---

# dispatch_workloop_create

Creates a new workloop with the specified label.

## Declaration

```occ
extern dispatch_workloop_tdispatch_workloop_create(const char *label);
```

## Parameters

- `label`: A string label to attach to the queue to uniquely identify it in debugging tools such as Instruments, sample, stackshots, and crash reports. Because apps, libraries, and frameworks can all create their own dispatch queues, a reverse-DNS naming style (com.example.myqueue) is recommended. This parameter is optional and can be NULL.

## Return Value

Return Value The newly created workloop.

## Discussion

Discussion The returned workloop is active, and you may submit blocks to it immediately.

## See Also

### Creating a Dispatch Workloop

- [dispatch_workloop_create_inactive](dispatch/dispatch_workloop_create_inactive.md)
- [dispatch_workloop_t](dispatch/dispatch_workloop_t.md)
- [OS_dispatch_workloop](dispatch/os_dispatch_workloop.md)