LinkedDonorFor()

<< Click to Display Table of Contents >>

Navigation:  Available Functions >

LinkedDonorFor()

Syntax

LinkedDonorFor( <CharacterValue> )

 

Purpose

LinkedDonorFor() is a numeric function that returns the ID number of a donor who is linked to the current donor via a specific linkage code.

 

Parameters

A linkage code.

 

Returns

The ID number of a linked donor corresponding to the specified linkage code.

 

Usage

LinkedDonorFor() is primarily a reporting function which is used to fetch the ID number of a donor who is linked to the current donor via a specific linkage code. This ID number may then be used with other functions (such as the IDLookUp() function) to print information about the linked donor.

 

Example

The following examples illustrate LinkedDonorFor():

 

CALL

RESULT

LinkedDonorFor( "FATHER" )

236281

IDLookUp( LinkedDonorFor( "FATHER" ), .Last_Name. )

Weston

IDLookUp( LinkedDonorFor( "FATHER" ), .First_Name. )

James

 

If for the current donor there is no linked donor for a specific linkage code, then LinkedDonorFor() would return zero, and in the above example, IDLookup() would return nothing (resulting in nothing printing).