Modifications

Lorsque vous l'exécuterez, vous devriez voir ceci:

Lorsque vous l'exécuterez, vous devriez voir ceci:

[[Fichier:ADF-MICROSD-BREAKOUT-Func00.jpg]]

{{ADFImage|ADF-MICROSD-BREAKOUT-Func00.jpg}}

Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch aura été exécuté. C'est-à-dire que le sketch '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.

Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch aura été exécuté. C'est-à-dire que le sketch '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.

[[Fichier:ADF-MICROSD-BREAKOUT-Func01.jpg]]

{{ADFImage|ADF-MICROSD-BREAKOUT-Func01.jpg}}

Certains point sont à relever :

Certains point sont à relever :

== Enumérer / lire récursivement  les fichiers ==

== Enumérer / lire récursivement  les fichiers ==

Le dernier exemple nous montre une utilisation plus avancée. Une demande courante est par exemple de vouloir énumérer tous les fichiers de la carte SD, ou de jouer un fichier musical ou autre. Dans la dernière version de la bibliothèque SD, vous pouvez parcourir un répertoire et appeler '''openNextFile()''' pour obtenir le fichier disponible suivant. Ils n’apparaîtront pas dans l'ordre alphabétique, mais dans l'ordre de leur création; ayez conscience de ce fait!

Le dernier exemple nous montre une utilisation plus avancée. Un besoin courant est, par exemple, énumération tous les fichiers de la carte SD ou de jouer les fichiers musicaux les un après les autres. Dans la dernière version de la bibliothèque SD, vous pouvez parcourir un répertoire et appeler '''openNextFile()''' pour obtenir et ouvrir le fichier suivant disponible dans le répertoire. Ils n’apparaîtront pas dans l'ordre alphabétique, mais dans l'ordre de leur création; souvenez vous en car cela est important!

Pour le voir, exécutez le sketch d'exemple '''SD→listfiles'''

Pour voir l'exemple, chargez et exécutez le sketch d'exemple '''SD→listfiles'''

Vous pouvez voir que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont). Les chiffres à la suite des noms de fichier sont la taille en octets des fichiers. Ce sketch est utile pour apprendre comment sont appelés les fichiers sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)

Vous pouvez constater que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont placés). Les chiffres à la suite des noms de fichier représentent la taille en octets des fichiers.  

[[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]

 

{{ADFImage|ADF-MICROSD-BREAKOUT-Func02.jpg}}

== Autres fonctions utiles ==

== Autres fonctions utiles ==

Quelques manipulations utiles sont possibles avec des fonctions '''SD''' nous allons en énumérer quelques-unes ici:

Quelques manipulations utiles sont possibles avec des fonctions '''SD''', nous allons en énumérer quelques-unes ici:

* Si vous voulez juste vérifier qu'un fichier existe, utilisez '''SD.exists("filename.txt")''' elle retournera vrai ou faux (1 ou 0)

* Si vous voulez juste vérifier l'existence d'un fichier, utilisez '''SD.exists("filename.txt")''' elle retournera vrai ou faux (1 ou 0)

* Vous pouvez supprimer un fichier en appelant '''SD.remove("unwanted.txt")''' - attention! Elle supprimera vraiment le fichier, et il n'y a pas de «poubelle» pour corriger une erreur.

* Vous pouvez supprimer un fichier en appelant '''SD.remove("unwanted.txt")''' - attention! Elle supprimera vraiment le fichier, et il n'y a pas de "poubelle" pour corriger une erreur.

* Vous pouvez créer un sous-répertoire en appelant '''SD.mkdir("/mynewdir")''' très pratique lorsque vous voulez rassembler des fichiers dans un emplacement commun. Rien ne se passe si il existe déjà, mais vous pouvez toujours appeler '''SD.exists()''' en premier comme ci-dessus.

* Vous pouvez créer un sous-répertoire en appelant '''SD.mkdir("/mynewdir")''' très pratique lorsque vous voulez rassembler des fichiers dans un emplacement commun (un fichier par jour... et un répertoire par semaine). Rien ne se passe si il existe déjà, mais vous pouvez toujours appeler '''SD.exists()''' en premier tel que décrit ci-dessus.

Quelques fonctions de '''fichier''' utiles pour les manipuler :

Quelques fonctions utiles pour manipuler des fichiers :

* Vous pouvez appeler '''seek()''' sur un fichier. Ceci déplacera le pointeur de lecture/écriture vers un nouvel emplacement. Par exemple '''seek(0)''' vous amène au début du fichier, ce qui peut être très pratique!

* Vous pouvez appeler '''seek()''' sur un fichier. Ceci déplacera le pointeur de lecture/écriture vers le nouvel emplacement indiqué. Par exemple '''seek(0)''' vous amène au début du fichier, ce qui peut être très pratique!

* De même, vous pouvez appeler la fonction '''position()''' elle vous renverra où vous en êtes dans le fichier (nombre d'octets parcourus).

* De même, vous pouvez appeler la fonction '''position()''' elle renvoi l'emplacement actuel du pointeur de lecture/écriture dans le fichier (nombre d'octets parcourus).

* Si vous voulez connaître la taille d'un fichier, appelez '''size()''' pour obtenir sa dimension en nombre d'octets dans le fichier.

* Si vous voulez connaître la taille d'un fichier, appelez '''size()''' pour obtenir la taille du fichier en octets (bytes).

* Les répertoires/dossiers sont des fichiers spéciaux, vous pouvez déterminer si un fichier est un répertoire en appelant '''isDirectory()'''

* Les répertoires/dossiers sont des fichiers spéciaux, vous pouvez déterminer si un fichier est un répertoire en appelant '''isDirectory()'''

* Lorsqu'un répertoire est reconnu, vous pouvez commencer à passer par tous les fichiers dans ce répertoire en appelant '''openNextFile()'''

* Lorsqu'un répertoire est reconnu, vous pouvez commencer à énumerer tous les fichiers disponibles dans ce répertoire en appelant '''openNextFile()'''

* S'il est nécessaire de connaître le nom d'un fichier, par exemple si vous avez appelé '''openNextFile()''' dans un répertoire. Dans ce cas, la fonction '''name()''' retourne un pointeur vers le tableau de caractères au format

* S'il est nécessaire de connaître le nom d'un fichier (par exemple lorsque vous avez appelé '''openNextFile()''') dans un répertoire. Dans ce cas, la fonction '''name()''' retourne un pointeur vers le tableau de caractères contenant le nom de fichier au format 8.3. Vous pouvez envoyer directement le contenu du tableau directement sur la console avec '''Serial.print()'''.

8.3, vous pouvez l'envoyer directement à la console avec '''Serial.print()''' si vous voulez.

{{ADF-MICROSD-BREAKOUT-TRAILER}}

{{ADF-MICROSD-BREAKOUT-TRAILER}}