The function get() is used to read a key/value item previously saved on the Linux processor using put().
You can request for a value stored in the datastore by passing get() the Key you want to search for, the support buffer, and its size.
The Key is similar to a label, used to identify an associated value.
The key name must be unique in order to identify the correct value.
The datastore is saved in RAM, you will lose the datastore when you restart the bridge software on the Linux side (through power cycling, resetting the Linux processor, or uploading a sketch through WiFi or Ethernet). You will not lose the datastore if you reset the ATMega32u4 processor.
bridge.get(key, buffer, buffer_length)
- key: The name of the key associated with the value you are requesting.
- buffer: The support buffer used to save the value returned from the searched Key. A string terminator is added after the last byte that compose the value filed has been read.
- buffer_length: the length of the buffer passed to the function.
returns the length of the read byte of the requested value.