Regular API function

simPersistentDataRead

Description Reads a block of persistent data. See also simPersistentDataWrite, simGetStringSignal, simGetIntegerSignal, simGetFloatSignal and simReadCustomDataBlock.
C synopsis simChar* simPersistentDataRead(const simChar* dataName,simInt* dataLength)
C parameters
dataName: name of the data block
dataLength: the size of the returned data block, since it may contain any data (also embedded zeros).
C return value
NULL if operation was not successful or data block does not exist, otherwise the data block (which may contain any value, including embedded zeros). In that case the returned buffer should be released with simReleaseBuffer
Lua synopsis string dataValue=simPersistentDataRead(string dataName)
Lua parameters
dataName: name of the data block
Lua return values
dataValue: value of the data block, or nil if operation was not successful or data block does not exist. The returned data block may contain any value, including embedded zeros.

All regular API functions on one page