Small Basic: Fichiers, Répertoires et Réseau (fr-FR)

Article
17/01/2024

Cet article traite de la manière dont sont gérés les fichiers, dossier et le réseau dans Microsoft Small Basic.

Qu'est-ce qu'un fichier ?

Un fichier est un ensemble de données stocké sur le disque d'un ordinateur. De base Small Basic possède des opérations permettant d'utiliser les trois type de fichiers suivants :

Fichiers Audio
Fichiers Image
Fichiers Texte

Un fichier possède un nom. Par exemple, readme.txt est un nom de fichier. Un nom de fichier est composé d'une base de nom d'une extension. Dans le cas de readme.txt, "readme" est la base du nom et ".txt" est l'extension. Les extensions de fichier représentent le type du fichier.

Les Fichiers Texte

".txt" est l'extension pour les fichiers de texte simple. Mais il existe d'autres fichiers au format texte :

.csv : Fichiers CSV (Comma Separated Values) contenant des lignes de données séparées par des virgules
.html : Fichiers HTML (Hyper Text Markup Language) comme les pages Web
.ppm : Fichiers "Pixmap Portable" contenant la définition d'une image bitmap au format texte
.rtf : Fichiers RTF (Rich Text Format) document de type traitement de texte
.sgf : Fichiers SGF (Smart Game Format)
.svg : Fichiers SVG (Scalable Vector Graphics)
.xml : Fichiers XML (eXtensible Markup Language)

Small Basic peut lire et écrire tous ces formats de fichiers si ils sont encodés en UTF-8 (en-US).

Qu'est-ce qu'un Répertoire ?

Un répertoire est également appelé "dossier". Un répertoire est un endroit qui contient des fichiers et des sous-répertoires.

Qu'est-ce que le Chemin ?

Un chemin est un nom de répertoire ou de fichier. Les noms qui suivent sont des exemples de chemins complets. Un chemin complet est un nom commençant par le nom du lecteur et d'un dossier racine. Le premier exemple est un chemin de répertoire (pour le dossier "Documents" d'un utilisateur). Le second exemple est le chemin complet du Small Basic,.

C:\Users\Nonki\Documents
C:\Program Files (x86)\Microsoft\Small Basic\SB.exe

Un chemin est construit avec les noms des répertoires séparés par séparateurs "\ (barre inverse ou Backslash), comme ceci :

<drive>:\<root>\<child>\<grandchild>\<basename>.<extension>

Dans Small Basic, tous les noms des chemins fournis comme paramètres aux opérations qui suivent sont des chemins complets.

Qu'est-ce qu'une URL ?

Une URL (Uniform Resource Locator ou Localisateur Uniforme de Ressource en français) est un chemin pour les fichiers internet. Par exemple, cet article à l'URL suivante :

http://social.technet.microsoft.com/wiki/contents/articles/25576.small-basic-file.aspx

Une URL est ensemble de nom séparés par "/" (barre de division ou slash), et qui commence par un Nom de Protocole Réseau.

Les Opérations sur les Fichiers

Les trois opérations qui suivent fonctionnent avec tous les types de fichiers. La première copie un fichier. La seconde supprime un fichier. La dernière retourne le nom du fichier depuis un chemin complet fourni.

' Pour les fichiers locaux
err = File.CopyFile(path1 , path2)
err = File.DeleteFile(path)
files = File.GetFiles(path)

Opérations et Propriété pour les Répertoires

Dans la liste suivante, les trois premières opérations permettent la création, suppression et récupération des noms de répertoires. Pour finir on a une propriété pour obtenir le chemin du répertoire où se trouve le programme en cours d'exécution.

' pour les dossiers locaux
err = File.CreateDirectory(path)
err = File.DeleteDirectory(path)
dirs = File.GetDirectories(path)
path = Program.Directory

Opérations pour les Fichiers Texte

Il y a sept opérations de l'objet File dans Small Basic pour gérer les fichiers texte. Les deux premières permettent d'obtenir des chemins de fichier. La suivante permet de lire un fichier. Les quatre dernières permettent d'écrire dans des fichiers. Toutes ces opérations traitent uniquement des fichiers encodés en UTF-8 (en-US) .

' pour les fichiers texte locaux
' permet d'obtenir des chemins de fichier
path = File.GetSettingsFilePath()
path = File.GetTemporaryFilePath()
' pour lire des fichiers
txt = File.ReadContents(path)
' pour écrire des fichiers
err = File.AppendContents(path , txt)
err = File.InsertLine(path , lno,  txt)
err = File.WriteContents(path , txt)
err = File.WriteLine(path , lno,  txt)

Opérations pour les Fichiers Internet

L'objet Network dans Small Basic possède deux opérations. L'une permet de télécharger n'importe quel type de fichier depuis Internet. L'autre permet de lire (get) le contenu d'une page Web. Ces deux opérations permettent de lire des fichiers locaux également.

' pour des fichiers locaux ou sur internet
path = Network.DownloadFile(url)
' pour des fichiers texte locaux ou sur internet
txt = Network.GetWebPageContents(url)

Opérations pour les Fichiers Audio

Ces quatre opérations permettent de jouer, mettre en pause et arrêter des fichiers audio au format .mp3, .wav, or .wma. Plus de détails sont disponibles dans cet article en anglais.

' pour les fichiers audio locaux ou internet
Sound.Play(url)
Sound.PlayAndWait(url)
Sound.Stop(url)
Sound.Pause(url)

Opérations pour les Fichiers Image

Les cinq opérations permettent de récupérer les images depuis internet, disque local ou pour les dessiner.

' pour les fichiers Image locaux ou sur internet
url = Flickr.GetPictureOfMoment()
url = Flickr.GetRandomPicture(tag)
img = ImageList.LoadImage(url)
GraphicsWindow.DrawImage(url , x,  y)
obj = Shapes.AddImage(url)

Programmes d'Exemple

Exécutez ces programmes en local (utiliser le bouton [Importer] depuis l'environnement Small Basic), retirez les apostrophes des lignes contenant l'objet File, et exécutez le (avec le bouton [Exécuter]).

Converti un Chemin Relatif en Chemin Absolu (JQK779) - Ce programme converti un chemin reatif d'un fichier local, en chemin absolu pour le même fichier.
Recherche Générique (SVV671) - Ce programme recherche les noms de fichier qui correspondent avec les caractères joker "*" or "?" dans le dossier Program.Directory et en fait une liste dans un tableau. Le caractère "*" fait correspondre n'importe quel ensemble de caractères (même vide) et "?" fait correspondre n'importe quel caractère.
Liste des Articles de Blog (CPP576) - Ce programme créé une liste des articles du Blog Officiel de Small Basic.

Problèmes Connus

Dans les problèmes suivant, "distant" indique que le programme Small Basic s'exécute dans la bibliothèque de programmes du site smallbasic.com dans un navigateur avec Silverlight.

ImageList.GetHeightOfImage() et ImageList.GetWidthOfImage() retourne zéro en distant.
Network.GetWebPageContents() ne fonctionne pas en distant.
Program.Directory contient le dossier local en local, et l'URL du programme en distant.

Partager via