Guide de style F#

Les articles suivants décrivent les instructions relatives à la mise en forme du code F# et des conseils d’actualité pour les fonctionnalités du langage et la façon dont ils doivent être utilisés.

Ce guide a été formulé en fonction de l’utilisation de F# dans de grandes bases de code avec un groupe diversifié de programmeurs. Ce guide conduit généralement à une utilisation réussie de F# et réduit les frustrations lorsque les exigences des programmes changent au fil du temps.

Cinq principes du bon code F#

Gardez à l’esprit les principes suivants chaque fois que vous écrivez du code F#, en particulier dans les systèmes qui changeront au fil du temps. Tous les conseils fournis dans d’autres articles proviennent de ces cinq points.

1. Un bon code F# est succinct, expressif et composable

   F# a de nombreuses fonctionnalités qui vous permettent d’exprimer des actions dans moins de lignes de code et de réutiliser des fonctionnalités génériques. La bibliothèque principale F# contient également de nombreux types et fonctions utiles pour travailler avec des collections courantes de données. La composition de vos propres fonctions et celles de la bibliothèque principale F# (ou d’autres bibliothèques) fait partie de la programmation F# idiomatique de routine. En règle générale, si vous pouvez exprimer une solution à un problème dans moins de lignes de code, d’autres développeurs (ou votre futur soi) seront reconnaissants. Il est également vivement recommandé d’utiliser une bibliothèque telle que FSharp.Core, les vastes bibliothèques .NET sur lesquelles F# s’exécute ou un package tiers sur NuGet lorsque vous devez effectuer une tâche nontriviale.

2. Un bon code F# est interopérable

   L’interopérabilité peut prendre plusieurs formes, notamment consommer du code dans différents langages. Les limites du code avec lequel d’autres appelants interagissent sont des éléments critiques à mettre en place, même si les appelants utilisent également F#. Lorsque vous écrivez F#, vous devez toujours réfléchir à la façon dont d’autres codes appelleront le code que vous écrivez, y compris s’ils le font à partir d’un autre langage comme C#. Les instructions de conception des composants F# décrivent en détail l’interopérabilité.

3. Un bon code F# utilise la programmation d’objets, et non l’orientation de l’objet

   F# prend entièrement en charge la programmation avec des objets dans .NET, notamment les classes, les interfaces, les modificateurs d’accès, lesclasses abstraites, et ainsi de suite. Pour un code fonctionnel plus complexe, tel que les fonctions qui doivent être sensibles au contexte, les objets peuvent facilement encapsuler des informations contextuelles d'une manière que les fonctions ne peuvent pas. Des fonctionnalités telles que les paramètres facultatifs et l’utilisation prudente de la surcharge peuvent faciliter la consommation de cette fonctionnalité pour les appelants.

4. Le code F# correct s’exécute correctement sans exposer de mutation

   Il n’est pas secret que pour écrire du code hautes performances, vous devez utiliser la mutation. C’est la façon dont les ordinateurs fonctionnent, après tout. Ce code est souvent sujet à des erreurs et difficile à maîtriser. Évitez d’exposer la mutation aux appelants. Au lieu de cela, créez une interface fonctionnelle qui masque une implémentation basée sur des mutations lorsque les performances sont critiques.

5. Un bon code F# est utilisable

   Les outils sont précieux pour travailler dans de grandes bases de code et vous pouvez écrire du code F# afin qu’il puisse être utilisé plus efficacement avec les outils de langage F#. Par exemple, veillez à ne pas abuser d’un style de programmation sans point afin de pouvoir inspecter les valeurs intermédiaires avec un débogueur. Un autre exemple consiste à utiliser des commentaires de documentation XML qui décrivent les constructions de manière à ce que les info-bulles dans les éditeurs puissent afficher ces commentaires sur le site d’appel. Pensez toujours à la façon dont votre code sera lu, parcouru, débogué et manipulé par d’autres programmeurs avec leurs outils.

Étapes suivantes

Les instructions de mise en forme du code F# fournissent des conseils sur la façon de mettre en forme le code afin qu’il soit facile à lire.

Les conventions de codage F# fournissent des conseils pour les idiomes de programmation F# qui aideront à la maintenance à long terme des bases de code F# plus volumineuses.

Les instructions de conception des composants F# fournissent des conseils pour créer des composants F#, tels que des bibliothèques.