---
name: "PX_get_data_alpha"
section: "3"
platform: "linux"
package: "pxlib-dev"
version: "0.6.9-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PX_get_data_alpha"
---

# PX\_get\_data\_alpha(3)

Get alpha data field

## NAME

PX\_get\_data\_alpha — Get alpha data field

## SYNOPSIS

\#include \<paradox.h\>

int PX\_get\_data\_alpha(pxdoc\_t \*pxdoc, char \*data, int len, char \*\*value)

## DESCRIPTION

Converts a data field as it is stored in the database file into  a string for the given encoding. You must set the target encoding  before in order to recode the string. If you do not set the encoding  the data will be returned as is. You should use this function  instead of accessing the data directly.

**data** points to the start of the data field in the  record. It must be calculated by summing up all field length before  the field to operate on and add it to the base pointer of the  record.

The function allocates memory for the string returned in  **\*value**. This memory has to be freed by the application.

**Note:**

**This function is deprecated and obsolete if**  **[PX\_retrieve\_record(3)](/PX_retrieve_record/3.md) is used.**

## RETURN VALUE

**Returns 0 if the field data starts with a null byte,**  **-1 in case of an error and 1 otherwise.**

## SEE ALSO

**[PX\_get\_data\_byte(3)](/PX_get_data_byte/3.md), [PX\_get\_data\_long(3)](/PX_get_data_long/3.md), [PX\_get\_data\_short(3)](/PX_get_data_short/3.md),**  **[PX\_get\_data\_double(3)](/PX_get_data_double/3.md), [PX\_get\_data\_bcd(3)](/PX_get_data_bcd/3.md), [PX\_get\_data\_blob(3)](/PX_get_data_blob/3.md)**

## AUTHOR

**This manual page was written by Uwe Steinmann uwe@steinmann.cx.**