F_ToLCase

F_ToLCase 1:

The F_ToLCase function converts all upper-case letters in a string into lower-case letters.

F_ToLCase 2:

Character set

By default the conversion function uses the character set of the Windows code page 1252 Latin 1, SBCS (single-byte character set). A different character set can be selected at runtime (currently only Windows code page 1250 Central European) via the global variable GLOBAL_SBCS_TABLE (see example).

F_ToLCase 3: Return value

Name

Type

Description

F_ToLCase

T_MaxString

 

F_ToLCase 4: Inputs

VAR_INPUT
    in : T_MaxString;
END_VAR

Name

Type

Description

in

T_MaxString

The string to be converted (type: T_MaxString).

Example:

PROGRAM MAIN
VAR
    sLCase : STRING;
END_VAR
sLCase := F_ToLCase( 'TO LOWER CASE 1234567890 ÄÖÜß' );

The result of the conversion is: 'to lower case 1234567890 äöüß'

GLOBAL_SBCS_TABLE := eSBCS_CentralEuropean;
sLCase := F_ToLCase( 'TO LOWER CASE 1234567890 ĄĘŚĆŻŹŁÓ' );

The result of the conversion is: 'to lower case 1234567890 ąęśćżźłó'

Requirements

Development environment

Target platform

PLC libraries to be integrated (category group)

TwinCAT v3.1.0

PC or CX (x86, x64, Arm®)

Tc2_Utilities (System)