# GetCtrlValStringLength

int GetCtrlValStringLength (int panelHandle, int controlID, int *numberOfCharacters);

## Purpose

Returns the number of bytes (excluding the ASCII NUL byte) in the text value for the control.

## Parameters

Input
Name | Type | Description
panelHandle | integer | The specifier for a particular panel that is currently in memory. You obtain the handle by calling the LoadPanel, NewPanel, or DuplicatePanel function.
controlID | integer | The defined constant (located in the UIR header file) that you assign to the control in the User Interface Editor, or the ID that you obtain by calling the NewCtrl or DuplicateCtrl function.
Output
Name | Type | Description
numberOfCharacters | integer * | Returns the number of bytes (excluding the ASCII NUL byte) in the text value for the control.

## Return Value

Name | Type | Description
status | integer | Returns a negative error code if an error occurs.