Functions (all)

GetFact

Function Name:

GetFact

Description:

Returns a fact of a specified type (and, optionally, for a specified instance or year) for a given person - if there is one. The person may be a principal or a witness with respect to the fact in question.  See also the GetRole function.

Minimum FH Version:

7.0

No. of Parameters:

2

Return Type:

A reference to a data item (or NULL if none is found).

Parameter 1:

A reference to an Individual record

Parameter 2:

A text expression that contains the tag name of the type in question - such as "BIRT" (for birth) or "CENS" (for census).  Optionally, the tag name can also be qualifed by either the required instance, or the required year, in square brackets following the tag name.  For example, if you want to specify the second Birth fact for a person, you could use "BIRT[2]".  If you wanted to specify a 1881 Census event, you could use "CENS[year=1881]".

Examples:

=GetFact(%INDI%, "CENS[year=1881]")