FindAttribute

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

SalString FindAttribute( SalString sName, SalString sDefault )

The FindAttribute gets the value of an attribute in a message.

Parameters

Name Description
SalString sName Name of the attribute to get value for. This name should always be in uppercase.
SalString sDefault Value to return in the case when the attribute does not exist in the message.

Returns

The return value is the value of the attribute, or sDefault if the attribute did not exist in the message.

Comments

FindAttribute does not require the attribute to exist in the message. If the attribute does not exist, the specified default value is returned.

To retrieve attribute values requiring the attribute to exist in the message, applications should use the GetAttribute method.

Example provided here