Function Blocks

 

FB_MeasurandList

Overview

Type:

Function block

Available as of:

V1.0.0.0

Task

Recording the measured values.

Functional Description

The function block FB_MeasurandList manages the values measured with the AddMeasurand method.

AddMeasurand Method

The AddMeasurand method stores external recorded measured values as a STRING value. For example, the execution times of a function while using specific parameters or the data size of a structure (determined with SIZEOF) can be recorded or stored.

The method can be called at any position within a test case. A test case can provide any number of measured values by calling the method several times. For further information, refer to the chapter Record Measured Values.

Interface

Input

Data type

Description

i_sModule

STRING[255]

Name of the unit that transfers the measured value. Used to assign the measured value to a library, function block, or function.

i_sName

STRING[255]

Name of the measured value.

i_etType

ET_MeasurandTypes

Type of the measured value.

Also refer to the enumeration ET_MeasurandTypes.

This entry is optional.

i_sValue

STRING[255]

Measured value.

Return value

Data type

Description

UDINT

Indicates the number of stored measured values. The return value is equal to zero if the maximum number of measured values that can be recorded was exceeded and no measured value can be stored anymore.

Refer to the parameter Gc_uiMaxNumberOfMeasurands.