# classname_fieldname_get_chars(numeric or decimal)

> This function returns a numeric value in character string format.

### Prototype

>         MCO_RET	classname_fieldname_get_chars(	/*IN*/ classname *handle,
>                                 /*OUT*/ char *buf,
>                                 /*IN*/ uint2 buf_size);

### Arguments

handle | A pointer to a classname handle
buf | A pointer to a buffer to receive the value as a character string
buf_size | The size of the buffer

### Description

> This function is generated only for decimal or numeric fields. It converts the numeric or decimal value to a character string with the number of digits to the right of the decimal point defined by the precision specified in the database schema. If the value stored occupies fewer digits than the defined width, the character value returned is zero filled on the right.

### Return Codes

MCO_S_OK | The value was read successfully
MCO_E_TRANSACT |
MCO_ERR_OBJECT_HANDLE |

Related Topics