RB-ARD-YUN-Bridge-Func-get

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


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.