Functions (all)

FactOwner

Function Name:

FactOwner

Description:

Individual facts (events or attributes) are said to be 'owned' by whichever individual they are 'about'. A Family fact is 'owned' by both of the parents in the family. This function can be used to return the fact owner.

For individual facts, the function will only ever return anybody if parameter 2 is set to 1. If it is, and if parameter 3 is either MALES_FIRST or FEMALES_FIRST, the fact owner will be returned.

For family facts, if parameter 3 is set to MALES_FIRST, the first fact owner is deemed to be the father if there is one, and the second fact owner is the mother. If there is no father, the mother is the first fact owner.

If parameter 3 is set to FEMALES_FIRST, the first fact owner is deemed to be the mother if there is one, and the second fact owner is the father. If there is no mother, the father is the first fact owner.

If parameter 3 is set to MALES_ONLY, parameter 2 must be set to 1, and the male fact owner will be returned, if there is one. If there isn't, NULL is returned. If parameter 3 is set to FEMALES_ONLY, parameter 2 must again be set to 1, and the female fact owner will be returned, if there is one.

Minimum FH Version:

4.0

No. of Parameters:

1

Return Type:

An Individual record

Parameter 1:

A data reference to a fact (event or attribute).

Parameter 2:

A number - must be either 1 or 2.

Parameter 3:

This must be one of the following values:

• MALES_FIRST
• FEMALES_FIRST
• MALES_ONLY
• FEMALES_ONLY

Examples:

=FactOwner(%FACT%, 2, MALES_FIRST)
=FactOwner(%FACT%, 1, FEMALES_ONLY)