fsFileReadString (Function)

This reads a string from a FILE - starting from the location set by the data pointer (fsFileSeek). The length of the string will either be the maximum string length as defined by the STRING variable or a carriage return value (0D hex or 13 decimal) followed by a new line value (0A hex or 10 decimal). After each successful read operation, the file data pointer is automatically incremented

Input:                

fd : FILE

FILE descriptor for the file retrieved from fsFileOpen or fsFileCreate.

Returns: STRING

The string read. Or an empty string if none is present.

Declaration:

FUNCTION fsFileReadString : STRING;
VAR_INPUT
   fd : FILE;
END_VAR;

Example:

...
IF fsFileExists(name := "\prg1.log") THEN
   fdLog := fsFileOpen(name := "\prg1.log");
   IF fsFileStatus(fd := fdLog) = 0 THEN
      // Is file empty?
      IF fsFilePosition(fd := fdLog) > 0 THEN
         rc := fsFileSeek(fd := fdLog, offset := 0);
         IF rc = 0 THEN
            // Iterate file
            REPEAT
               str := fsFileReadString(fd := fdLog);
               IF strLen(str := str) > 0 THEN
                  // Data is read
                  ...
               END_IF;
            UNTIL strLen(str := str) = 0
            END_REPEAT;
         ELSE
            // Error
         END_IF;
      ELSE
         // No data
      END_IF;
      fsFileClose(fd := fdLog);
   ELSE
      // Could not open file
   END_IF;
ELSE
   // File dont exist
END_IF;
...