reach()

Purpose

Obtains the parent of a record. This function is regarded as obsolete in 4.500

Syntax

int reach(par_rec, child_rec, role, mapnr)

Parameters

short* par_rec

Pointer to parent record

short* child_rec

Pointer to child record

char* role

Role to use

int mapnr

Number of remark map to display if parent not found

Description

The reach() function can be used to fetch the parent of a child record with the given role. This involves a call to the database manager to perform the field transcriptions. This is inefficient, particularly in networking applications. It is better to do the transfer explicitly in the program.

If the parent is not found and a valid map number is passed in the parameter mapnr, this map is displayed as a remark.

This function is implemented using the functions copy2parent() and rec_fetch_main().

If the global variable realpass is set to TRUE, this function always returns TRUE and sets the global variable there to TRUE.

Return values

Returns TRUE if the parent is successfully fetched, otherwise FALSE, unless the global variable realpass is FALSE when TRUE is always returned

See also

scanreach(), cycle()