Skip to main content

lengthIsExact

Short summary​

This assertion method checks if the current string stringToCheck length is equal to expectedLength. Processed strings must be in Windows-1252 or Windows-1251 encoding

Attention: All strings are handled as null-terminated byte streams

Parameters​

NameTypeCommentKind
stringToCheckPOINTER TO BYTEcurrent string to checkinput
expectedLengthUDINTexpected length of stringToCheckinput
messageAssertMessagemessage if the assertion is falseinput

Code​

Declaration​

METHOD lengthIsExact
VAR_INPUT
	(* current string to check *)
	stringToCheck	:POINTER TO BYTE;
	(* expected length of ``stringToCheck`` *)
	expectedLength	:UDINT;
	(* message if the assertion is false *)
	message			:AssertMessage;
END_VAR

Implementation​

IF (THIS^.getStringLength(stringToCheck) <> expectedLength) THEN
	THIS^.assertionWasWrong(message, THIS^.getDebugInfo('LengthIsExact'));
END_IF