SaveStringF (Function)

Top  Previous  Next

Architecture:

X32 / NX32 / NX32L

Device support:

ALL

Firmware version:

1.00 / 1.00.00


SaveStringF will save a string to a specific location in the persistent FRAM memory.

 
A total of 20 (X32) / 100 (NX32/NX32L) FRAM entries are available.
 

Input:                

index : INT (1..20, 1..100)

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)

0

- Success.

1

- Invalid index.

3

- Invalid length.

 

Declaration:

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

 

 

Example:

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