DynamicTextIterateLanguages (FUN)

FUNCTION DynamicTextIterateLanguages : RTS_IEC_RESULT

This function allows to iterate over all languages This function can be used to iterate over all loaded languages. An according callback will be called once for each language. Please remark: The order of the entries that are returned may be undefined.

InOut:

Scope

Name

Type

Comment

Return

DynamicTextIterateLanguages

RTS_IEC_RESULT

Input

pfIterationCallback

POINTER TO BYTE

The callback function that will be called for every language The expected signature is a function returning BOOL with two arguments:

  • a POINTER TO STRING argument reflecting the language. The given POINTER should not be stored for time longer than the overall iteration and the

    POINTER should not be dereferenced directly but instead it should be copied to a temporary variable before access.

  • a __UXINT value reflecting the value passed in iterationData

If the callback function returns FALSE, then the iteration will be cancelled.

iterationData

__UXINT

User provided value that will transparently be passed to all calls of pfIterationCallback