Différences entre versions de « RB-ARD-YUN-Bridge-Func-get »
| Ligne 1 : | Ligne 1 : | ||
{{Arduino Yun-NAV}} | {{Arduino Yun-NAV}} | ||
| − | <h4> | + | <h4>get()</h4> |
== Description == | == Description == | ||
| − | + | '''get()''' allows you to read a key/value item previously saved on the Linux processor. 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 | + | 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. |
== Syntaxe == | == Syntaxe == | ||
| − | bridge. | + | bridge.get(key, buffer, buffer_length) |
== Paramètres == | == Paramètres == | ||
| − | * '''key''': | + | * '''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. | ||
== Résultat == | == Résultat == | ||
| − | + | The function returns the length of the read byte of the requested value. | |
== Exemple == | == Exemple == | ||
Version du 4 décembre 2013 à 11:41
get()
Description
get() allows you to read a key/value item previously saved on the Linux processor. 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.
Syntaxe
bridge.get(key, buffer, buffer_length)
Paramètres
- 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.
Résultat
The function returns the length of the read byte of the requested value.
Exemple
aucun
Voir aussi
Source: Arduino Yun, Guide to the Arduino Yún. Crédit: Arduino.cc, licence Creative Common Attribution ShareAlike.
Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : « Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.
L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.