2013
Khronos Group
glObjectPtrLabel
3G

# glObjectPtrLabel

label a a sync object identified by a pointer

## C Specification

                    void glObjectPtrLabel
                    void * ptr
                    GLsizei length
                    const char * label

## Parameters

`ptr`

  A pointer identifying a sync object.

`length`

  The length of the label to be used for the object.

`label`

  The address of a string containing the label to assign to the object.

## Description

`glObjectPtrLabel` labels the sync object identified by `ptr`.

`label` is the address of a string that will be used to label the object. `length` contains the number of characters in `label`. If `length` is negative, it is implied that `label` contains a null-terminated string. If `label` is NULL, any debug label is effectively removed from the object.

## Errors

`GL_INVALID_VALUE` is generated if `ptr` is not a valid sync object.

`GL_INVALID_VALUE` is generated if the number of characters in `label`, excluding the null terminator when `length` is negative, is greater than the value of `GL_MAX_LABEL_LENGTH`.

## Associated Gets

glGet with argument `GL_MAX_LABEL_LENGTH`.

## See Also

glPushDebugGroup, glPopDebugGroup, glObjectLabel.

## Copyright

Copyright 2013 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.