SaveString (Function)

SaveString will save a string to a specific location in the persistent FLASH memory.

Note: there is a limited number of writes to the Flash Memory that make use of this function. Please read the Persistent Memory introductory section.

Input:                

index : INT (1..192)

Location number the string should be saved in.

str : STRING

String that is to be saved.

Returns: INT

(Only reported from firmware version 5.00 / R1.30.00)

Declaration:

FUNCTION SaveString;
VAR_INPUT
  index : INT;
  str   : STRING;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
BEGIN
  ...
SaveString(index:=10, str:="hello world");
  // Persistent memory location number 10 will contain "hello world" after the call
  ...
END;
 
END_PROGRAM;