Existe-t-il un moyen dans Xcode de générer automatiquement un commentaire de méthode similaire à ce que vous faites dans Eclipse pour les commentaires de javadoc.
Par exemple, vous pouvez frapper /** une ligne avant une déclaration de méthode et eclipse génère automatiquement le squelette des commentaires de méthode.
Est-ce que quelqu'un sait s'il est possible de passer au commentaire multi-lignes avec \** y *\ Au lieu de la ligne unique ` \\\ ` ? ?
Vous pouvez utiliser la bibliothèque Code Snippets pour cela. Elle ne génère pas automatiquement des espaces réservés pour chaque paramètre, mais elle est néanmoins très utile. Voici ce que vous devez faire :
<#xyz#> où vous voulez qu'un espace nommé 'xyz' apparaisse. (Ceux-ci sont comme des espaces réservés de complétion de paramètres, vous pouvez donc tabuler entre eux et les écraser).Par exemple :
/**
* Method name: <#name#>
* Description: <#description#>
* Parameters: <#parameters#>
*/Désormais, lorsque vous tapez "comblk" n'importe où dans vos éditeurs, la fenêtre de saisie semi-automatique apparaît et vous pouvez appuyer sur "return" pour coller l'extrait. Le premier espace réservé sera sélectionné et vous pourrez commencer à taper le nom de la méthode. Appuyez sur tab pour passer à la description, et ainsi de suite.
Ce n'est pas idéal mais c'est mieux que rien. Les snippets sont une bonne idée qu'Apple n'a pas encore fini de mettre en œuvre.
Vous pouvez utiliser une syntaxe de commentaire pour générer une doc.
Editor -> Structure -> Add Documentation
command option /
/// <#Description#>
///
/// - Parameter param: <#param description#>
/// - Returns: <#return value description#>
/// - Throws: <#throws value description#>
func fun(param: String) throws -> String? {
return false;
}
Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.
