startsWith

Short summary

This assertion method for UTF-16 strings checks if the current string stringToCheck strats with the string start

Attention: All strings are handled as null terminated word streams. For UTF-16 is end of the string 16#00_00

Attention: start of the string is ALWAYS the left side of the string even for writings which written from right to left like Hebrew or Arabic

Parameters

Name	Type	Comment	Kind
stringToCheck	POINTER TO WORD	current string to check	input
start	POINTER TO WORD	expected start of stringToCheck	input
ignoreCases	BOOL	TRUE means ignore cases; FALSE means cases must be equal too	input
trim	BOOL	TRUE means truncation of spaces on the right side of stringToCheck	input
message	AssertMessage	message if the assertion is false	input
normalizeStrings	BOOL	normalize both strings for check	input

Code

Declaration

METHOD startsWith
VAR_INPUT
	(* current string to check *)
	stringToCheck	:POINTER TO WORD;
	(* expected start of ``stringToCheck`` *)
	start			:POINTER TO WORD;
	(* ``TRUE`` means ignore cases; ``FALSE`` means cases must be equal too *)
	ignoreCases		:BOOL;
	(* ``TRUE`` means truncation of spaces on the right side of ``stringToCheck``*)
	trim			:BOOL;
	(* message if the assertion is false *)
	message			:AssertMessage;
	(*normalize both strings for check*)
	normalizeStrings :BOOL := TRUE;
END_VAR