Wikifunctions:Introduction

Les fonctions sont des instructions informatiques qui effectuent des calculs sur les données fournies et qui répondent aux questions que vous avez à leur sujet. Par exemple, lorsque vous demandez à un assistant vocal combien de miles il y a dans un kilomètre, l’assistant vocal appelle une fonction pour le calculer pour vous.

Wikifunctions est un projet open source qui permet à quiconque de créer des fonctions et de les partager pour que d’autres puissent les utiliser, les remixer, les tester et apprendre d’elles.

Utilisez les guides suivants pour essayer les fonctionnalités basiques de Wikifunctions. Nous attendons avec impatience vos commentaires et vos contributions !

Évaluer une fonction

Vous pouvez essayer directement les fonctions fournies par la communauté sur Wikifunctions ! Choisissez-en une dans notre bibliothèque de fonctions, et donnez des valeurs d’entrée pour découvrir la sortie.

Étapes :

1. Trouvez une fonction sur la page d’accueil.

   

2. Allez sur la page d’une fonction.

   

3. Entrez une valeur d’entrée.

   

4. Exécutez la fonction.

   

Résultats :

1. Est-ce la valeur de sortie attendue ?
2. Avez-vous des corrections ou des commentaires à rapporter ?

Créer une fonction

Vous pouvez ajouter vos propres fonctions à Wikifunctions ! Créez une nouvelle fonction à utiliser dans vos propres implémentations et permettez à d’autres de l’utiliser également. De nouvelles fonctions peuvent être écrites dans votre langage préféré.

Étapes :

1. Allez sur la page de création d’une fonction.

   

2. Donnez un nom à votre fonction.

   

3. Définissez les valeurs d’entrée de votre fonction :
   1. Ajoutez/retirez des entrées.
   2. Définissez le type de chaque entrée.
   3. Nommez chaque entrée.

   

4. Définissez le type de la sortie de votre fonction.

   

5. Vous pouvez éventuellement fournir des valeurs multilingues pour l'un de ces champs :
   • Nom de la fonction, alias, libellés d’entrée.

   

6. Publiez votre fonction.

   

Résultats :

1. La fonction a-t-elle été sauvergardée avec succès ?
2. Avez-vous des corrections ou des commentaires à rapporter ?

Éditer une fonction

Vous pouvez contribuer à Wikifunctions en éditant sa bibliothèque de fonctions. Ajoutez ou éditez des informations multilingues aux fonctions, développez ou modifiez les définitions des fonctions.

Étapes :

1. Trouvez une fonction sur la page d’accueil.

   

2. Rendez-vous sur la page de la fonction.

   

3. Cliquez sur "Modifier le wikicode" afin de voir les options d'édition pour cette fonction.

   

4. Optionnellement, modifiez les valeurs de :
   1. Nom de fonction,
   2. Alias de fonction,
   3. Liste des entrées
      1. Ajouter/retirer des entrées
      2. Modifier le type d'entrée
      3. Modifier les étiquettes des entrées
   4. Type de sortie.
5. Vous pouvez éventuellement fournir des valeurs multilingues pour l'un de ces champs :
   1. Nom de la fonction
   2. alias de fonction
   3. étiquettes des entrées.
6. Publiez vos modifications.

Résultats :

1. Vos modifications ont-elles été sauvegardées avec succès ?
2. Avez-vous des corrections ou des commentaires à rapporter ?

Créer des tests

Vous pouvez créer des tests pour les implémentations de votre fonctions dans Wikifunctions, pour vous assurer de leur bon fonctionnement.

Étapes :

1. Trouver une fonction sur la Page d'accueil ou la fonction que vous avez créée à l'étape précédente.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Cliquez sur le lien "Créer un nouveau test".

   

4. Cliquez sur « Séléctionner la fonction » en dessous de « Appeller »
   1. Dans le champ au dessous de « Fonction », tapez le nom de la fonction que vous testez et sélectionnez la fonction lorsqu'elle apparaît.
   2. Ajoutez des valeurs pour les entrées dans les champs respectifs.

   

5. Cliquez sur « Sélectionner la fonction » en dessous de « Validation du résultat ». Dans le champ au dessous de « Fonction », tapez le nom de la fonction que vous souhaiteriez utiliser afin de vérifier le résultat.
   • Pour une fonction dont le rendu est une chaîne de caractères, ce sera l'« égalité des chaînes ». Au contraire, pour une fonction dont le rendu est un booléen, ce sera l'« égalité booléenne ».
   • Ajoutez la valeur attendue dans le champ donné (soit « « Seconde chaîne » ou « Second booléen »).

   

6. Publiez vos modifications.

Résultats :

1. Le test a-t-il été sauvegardé avec succès ?
2. Avez-vous des corrections ou remarques dont vous voudriez en faire part?

Créer une implémentation

Les fonctions prennent vie dans des implémentations créées afin de subvenir à vos besoins. Exécutez, remixez et combinez des fonctions via des implémentations dans Wikifunctions. Consultez la section ci-dessous pour savoir comment connecter votre implémentation aux fonctions. Nous recommandons de créer et connecter un test avant de créer une implémentation. Un guide plus complet pour créer des implémentations est disponible à Wikifunctions:How to create implementations.

Étapes :

1. Trouvez une fonction sur la page d’accueil.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Cliquez sur le lien "Créer une nouvelle implémentation".
4. Vous pouvez créer une nouvelle implémentation de deux façons :
   1. Code
      • Sélectionnez le langage de programmation parmi les langages proposés.
      • Entrez votre code.
   2. Composition :
      • Créez une composition en utilisant des fonctions existantes.

   

5. Publiez vos modifications (après avoir lancé un test en cliquant sur la flèche ronde sur la droite de l'encadré intitulé "Tests unitaires").

Résultats :

1. L'implémentation a-t-elle été sauvegardée avec succès ?
2. Avez-vous des corrections ou des commentaires à rapporter ?

Connecter une Implémentation ou un Test à une Fonction

Remarque : Cette fonctionnalité n'est disponible que pour les Fonctionnaires.

Connectez des tests et des implémentations à votre fonction pour la voir prendre vie.

Étapes :

1. Trouvez une fonction sur la page d’accueil.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Sélectionnez un ou plusieurs tests ou une ou plusieurs implémentations.

   

4. Cliquez sur le bouton “Connect”.

Résultats :

1. L’état d’attachement/détachement a-t-il été modifié avec succès ?
2. Avez-vous des corrections ou des commentaires à rapporter ?