cfunc.root C Function/C Functions

cfunc.root

Command cfunc.root C Function/C Functions
Applicable release versions: AP 6.1
Category C Functions (120)
Description equivalent to the Pick/BASIC statement: root string1, string2 to result.

This function returns -1 if an error occurs. The error code is contained in _CP_errno.
Syntax int _CP_root(CPSTR* string1, CPSTR* string2, int* result)
Options
Example
/* The following gets the first item-id which contains "a" as 
attribute 1. */

CPSTR * n = _CP_mkstr("myfile");
CPSTR * a = _CP_mkstr("a1");
CPSTR * op = _CP_mkstr("n");
CPSTR * k = _CP_mkstr("a");
CPSTR * i = _CP_str_null;
int r,dummy;

_CP_root(n,a,&r);
_CP_key(op,r,&k,&i,&dummy);
Purpose
Related cfunc.introduction