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

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(Une version intermédiaire par le même utilisateur non affichée)
Ligne 4 : Ligne 4 :
  
 
== 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.
+
{{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 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.  
+
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 ==
Ligne 13 : Ligne 15 :
  
 
== Paramètres ==
 
== Paramètres ==
* '''key''': The name of the key associated with the value you are requesting.
+
* '''key''': Clé, le nom de la clé (étiquette) associé à la valeur désirée.
* '''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''': 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''': the length of the buffer passed to the function.  
+
* '''buffer_length''': Informe la fonction de taille de la mémoire tampon mis à disposition de la fonction.  
  
 
== Résultat ==
 
== Résultat ==
  
The function returns the length of the read byte of the requested value.  
+
La fonction retourne le nombre de byte/octet lu pour la valeur demandée.  
  
 
== Exemple ==
 
== Exemple ==

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.