Différences entre versions de « RB-ARD-YUN-Bridge-Func-get »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(8 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Arduino Yun-NAV}}
 
{{Arduino Yun-NAV}}
  
−
<h4>begin()</h4>
+
<h4>get()</h4>
  
 
== Description ==
 
== Description ==
−
The ''put()'' function allows you to store data on the Linux processor using a Key/Value structure. The Key field is like a label and you can associate a value to it. The key name must be unique in order to identify the correct value. On the Linux side there is a data store where all the keys and the values are saved.
+
{{bloc-etroit|text='''get()''' vous permet de lire une paire clé/valeur ("''key/value''") précédemment sauvé dans le processeur Linux. Vous pouvez obtenir une valeur recherchée et stockée dans le ''data store'' en passant la valeur de la clé à la fonction ''get()'' ainsi que la mémoire tampon (buffer) et sa taille. La mémoire tampon est destinée à recevoir la valeur. La clé ("''Key''") est similaire à une étiquette destinée à identifier la valeur qui y est associé. Le nom de la clé doit, bien entendu, être unique pour permet d'identifier la valeur correcte.
  
−
The datastore is saved in the RAM of the AR9331, 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.
+
Le ''data store'' est sauvé en RAM. Le contenu du ''data store'' est perdu lorsque vous redémarrez le ''bridge'' côté Linux (soit via coupure d'alimentation, reset du processeur Linux, téléversement d'un sketch/croquis par l'intermédiaire du WiFi ou Ethernet).  
 +
 
 +
Le contenu du ''data store'' est préservé sur vous faite un Reset de votre processeur ATMega32u4.}}
  
 
== Syntaxe ==
 
== Syntaxe ==
  
−
Bridge.begin()  
+
bridge.get(key, buffer, buffer_length)  
  
 
== Paramètres ==
 
== Paramètres ==
−
 
+
* '''key''': Clé, le nom de la clé (étiquette) associé à la valeur désirée.
−
aucun
+
* '''buffer''': Mémoire tampon qui sera utilisée pour sauver la valeur retournée par la recherche de la clé. Une ''string terminator'' (fin de chaine de caractère) est ajouter après le dernier byte/octet de la valeur retournée.
 +
* '''buffer_length''': Informe la fonction de taille de la mémoire tampon mis à disposition de la fonction.
  
 
== Résultat ==
 
== Résultat ==
  
−
aucun
+
La fonction retourne le nombre de byte/octet lu pour la valeur demandée.
  
 
== Exemple ==
 
== Exemple ==
Ligne 25 : Ligne 28 :
  
 
== Voir aussi ==
 
== Voir aussi ==
−
* [[RB-ARD-YUN-Class-Bridge|constructeur Bridge]]
+
* [[RB-ARD-YUN-Bridge-Func-put|Bridge.put()]]
−
* [[RB-ARD-YUN-Process-Func-begin|Process.begin()]]
 
−
* [[RB-ARD-YUN-Console-Func-begin|Console.begin()]]
 
−
* [[RB-ARD-YUN-Bridge-Func-readMessage|Bridge.readMessage()]] [http://arduino.cc/en/Reference/YunReadMessage src]
 
−
* [[RB-ARD-YUN-Bridge-Func-writeMessage|Bridge.writeMessage()]] [http://arduino.cc/en/Reference/YunWriteMessage src]
 
−
* [[RB-ARD-YUN-Bridge-Func-messageAvailable|Bridge.messageAvailable()]] [http://arduino.cc/en/Reference/YunMessageAvailable src]
 
−
 
 
  
 
{{Arduino Yun-TRAILER}}
 
{{Arduino Yun-TRAILER}}

Version actuelle datée du 6 décembre 2013 à 12:09


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

get()

Description

get() vous permet de lire une paire clé/valeur ("key/value") précédemment sauvé dans le processeur Linux. Vous pouvez obtenir une valeur recherchée et stockée dans le data store en passant la valeur de la clé à la fonction get() ainsi que la mémoire tampon (buffer) et sa taille. La mémoire tampon est destinée à recevoir la valeur. La clé ("Key") est similaire à une étiquette destinée à identifier la valeur qui y est associé. Le nom de la clé doit, bien entendu, être unique pour permet d'identifier la valeur correcte.

Le data store est sauvé en RAM. Le contenu du data store est perdu lorsque vous redémarrez le bridge côté Linux (soit via coupure d'alimentation, reset du processeur Linux, téléversement d'un sketch/croquis par l'intermédiaire du WiFi ou Ethernet).

Le contenu du data store est préservé sur vous faite un Reset de votre processeur ATMega32u4.

Syntaxe

bridge.get(key, buffer, buffer_length)

Paramètres

  • key: Clé, le nom de la clé (étiquette) associé à la valeur désirée.
  • buffer: Mémoire tampon qui sera utilisée pour sauver la valeur retournée par la recherche de la clé. Une string terminator (fin de chaine de caractère) est ajouter après le dernier byte/octet de la valeur retournée.
  • buffer_length: Informe la fonction de taille de la mémoire tampon mis à disposition de la fonction.

Résultat

La fonction retourne le nombre de byte/octet lu pour la valeur demandée.

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.

Récupérée de « https://wiki.mchobby.be/index.php?title=RB-ARD-YUN-Bridge-Func-get&oldid=8247 »