Grass Valley K2 TX/MAM Database Protocol Manual v.2.2 - Manual (Page 18)

TX/MAM Database Protocol Manual - document version: 2.2 – Page 18
7.4 Adding a field request for a string database field
int cob_fieldlist_get_string( char *field, char **result_target, int data_type );
The result is temporarily placed in a library variable. Copy this to a local variable to save the value
even after a cob_fieldlist_clear call.
Parameters
Name Description
char *field The field to get, e.g. "artist".
char **result_target The pointer to the pointer that contains the result, e.g. _artist with the
declaration char *_artist;.
int data_type The origin of the data, e.g. CUSTOM_DATA.
Result
The result of the function is an integer that can have following values:
Value Description
0 Success, the field has been added.
-1 Failure, the field could not be added.
Example
This example retrieves details for asset_element record with id == 1035:
char *_artist;
int *_status_int;
long long *_id_category;
char artist[256];
int status_int;
long long category_id;
[..]
cob_fieldlist_clear();
cob_fieldlist_get_long( "id_category", &_id_category, ORIGINAL_DATA );
cob_fieldlist_get_string( "artist", &_artist, CUSTOM_DATA );
cob_fieldlist_get_integer( "status_int", &_status_int, ORIGINAL_DATA );
result = cob_get_field_values( "asset_element", 1035 );
if ( result == -1 ) {
printf( "Can't find asset_element: %Ld -> exit \n", 1035 );
return -1;
}
category_id = *_id_category;
strcpy( _artist, artist );
status_int = *_status_int;