PRESENT

The PRESENT function tests for the presence of an object.

PRESENT is commonly used with the IF function in a map rule to provide conditional logic. For example, if the object is present, do this; otherwise, do something else.

Similarly, PRESENT is commonly used with the WHEN function in component rules to provide conditional validation logic.

Syntax:
PRESENT (single-object-expression)
Meaning:
PRESENT (object_to_look_for)
Returns:
"True" or "false"

PRESENT returns "true" if the input argument does not evaluate to "none"; the object is present. It returns "false" if the input argument evaluates to "none"; the object is not present.

Examples

  • PRESENT (Trailer:File)

    This example returns "true" if Trailer is present and returns "false" if Trailer is absent.

  • IF (PRESENT(MiddleInitial:.:Input), MiddleInitial:.:Input, "***" )

    This example in a map rule maps MiddleInitial if it is present. If MiddleInitial is not present, three asterisks are mapped.

  • WHEN (PRESENT (AreaCode Field), PRESENT (PhoneNo Field))

    In this example, PRESENT is being used in conjunction with the WHEN function in a component rule to determine whether a particular object is valid.

Related functions

  • ABSENT
  • IF
  • WHEN

Feedback