Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples de code
Amazon Q peut suggérer du code dans différents scénarios. Pour comprendre comment il peut vous aider à écrire du code dans le langage de programmation de votre choix, consultez les exemples de code suivants.
**Topics**
+ [Utilisation d’Amazon Q Developer pour la saisie semi-automatique d’une ligne de code](single-line-completion.md)
+ [Utilisation d’Amazon Q Developer pour la génération de fonctions complètes](full-function-generation.md)
+ [Utilisation d’Amazon Q Developer pour la saisie semi-automatique de blocs](code-block.md)
+ [Utilisation d’Amazon Q Developer pour la saisie semi-automatique de docstrings, JSDoc et Javadoc](docstring-javadoc.md)
+ [Utilisation d’Amazon Q Developer pour les recommandations ligne par ligne](line-by-line-1.md)
# Utilisation d’Amazon Q Developer pour la saisie semi-automatique d’une ligne de code
Lorsque vous commencez à taper des lignes de code individuelles, Amazon Q formule des suggestions sur la base de vos saisies précédentes et en cours.
------
#### [ C\$1\$1 ]
![\[Exemple de saisie semi-automatique d’une ligne de code en langage C++.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/single-line-completion-c-plus.gif)
------
#### [ JavaScript ]
Dans cet exemple, Amazon Q complète une ligne de code que le développeur commence.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/javascript_vscode_SingleLine.gif)
------
#### [ TypeScript ]
Dans cet exemple, l’utilisateur saisit un commentaire complet, puis Amazon Q fournit le code correspondant.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_single-line.gif)
------
#### [ C\$1 ]
Dans cet exemple, Amazon Q recommande une ligne de code sur la base d’un commentaire.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/c-sharp-single-line.gif)
------
#### [ Shell ]
Dans l’image ci-dessous, Amazon Q propose des recommandations sur la manière de compléter une ligne de code.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/jb-single-line-shell.gif)
------
#### [ Java ]
Lorsque vous commencez à taper des lignes de code individuelles, Amazon Q formule des suggestions sur la base de vos saisies précédentes et en cours.
Dans l’exemple ci-dessous, en Java, un utilisateur saisit la chaîne `public` dans une classe existante.
Sur la base de la saisie, Amazon Q génère une suggestion pour la signature de la méthode principale.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-c9-single-line-completion.gif)
------
#### [ Python ]
Dans cet exemple, Amazon Q recommande une ligne de code, sur la base du commentaire du développeur.
![\[Exemple de saisie semi-automatique d’une ligne de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_singleline.gif)
------
# Utilisation d’Amazon Q Developer pour la génération de fonctions complètes
Amazon Q peut générer une fonction complète sur la base du commentaire que vous avez écrit. Une fois que vous avez terminé votre commentaire, Amazon Q suggère une signature pour la fonction. Si vous acceptez la suggestion, Amazon Q avance automatiquement votre curseur à la partie suivante de la fonction et formule une suggestion. Même si vous saisissez un commentaire ou une ligne de code supplémentaire entre les suggestions, Amazon Q effectue une refactorisation sur la base de votre saisie.
------
#### [ C ]
![\[Exemple de saisie semi-automatique d’une fonction complète en langage C.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ C\$1\$1 ]
![\[Exemple de saisie semi-automatique d’une fonction complète en langage C++.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ JavaScript ]
Dans l’exemple suivant, l’utilisateur génère, puis modifie une fonction complète sur la base d’un ensemble de commentaires.
![\[Exemple de génération de fonction complète.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/javascript_lambda_FullFunctionGeneration.gif)
Dans l’image suivante, un utilisateur a écrit une signature de fonction pour la lecture d’un fichier depuis Amazon S3. Amazon Q suggère ensuite une implémentation complète de la méthode `read_from_s3`.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-function-read-from-s3.png)
**Note**
Quelques fois, comme dans l’exemple précédent, Amazon Q inclut des instructions `import` dans ses suggestions. Il est recommandé de déplacer manuellement ces instructions `import` en haut de votre fichier.
Autre exemple, l’image suivante présente un utilisateur ayant écrit une signature de fonction. Amazon Q suggère ensuite une implémentation complète de la méthode `quicksort`.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-function-quicksort.png)
Amazon Q prend en compte d’anciens extraits de code lorsqu’il formule des suggestions. Dans l’image suivante, l’utilisateur de l’exemple précédent a accepté l’implémentation suggérée pour `quicksort` ci-dessus. L’utilisateur écrit ensuite une autre signature de fonction pour une méthode de `sort` générique. Amazon Q suggère alors une implémentation sur la base de ce qui a déjà été écrit.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-function-from-context-sort.png)
Dans l’image suivante, un utilisateur a écrit un commentaire. Amazon Q suggère alors une signature de fonction sur la base de ce commentaire.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-comment-binary-search.png)
Dans l’image suivante, l’utilisateur de l’exemple précédent a accepté la signature de fonction suggérée. Amazon Q peut alors suggérer une implémentation complète de la fonction `binary_search`.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-function-binary-search.png)
------
#### [ Java ]
La liste suivante contient des exemples expliquant comment Amazon Q formule des suggestions et vous guide tout au long du processus de création d’une fonction.
1. Dans l’exemple ci-dessous, un utilisateur saisit un commentaire. Amazon Q suggère une signature de fonction.
Après que l’utilisateur a accepté cette suggestion, Amazon Q suggère un corps pour la fonction.
![\[Exemple de fonction générée à partir d’un commentaire.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment.gif)
1. Dans l’image ci-dessous, un utilisateur saisit un commentaire dans le corps de la fonction avant d’accepter une suggestion d’Amazon Q. Sur la ligne suivante, Amazon Q génère une suggestion sur la base du commentaire.
![\[Exemple de fonction générée à partir d’un commentaire à l’intérieur d’un bloc de code existant.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment-within-block.gif)
------
#### [ C\$1 ]
Dans l’exemple suivant, Amazon Q recommande une fonction complète.
![\[Function declaration for ListTables with AmazonDynamoDBClient parameter in code editor.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/c-sharp-full-function.gif)
------
#### [ TypeScript ]
Dans l’exemple suivant, Amazon Q génère une fonction sur la base des docstrings de l’utilisateur.
![\[Exemple de saisie semi-automatique d’une fonction complète.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_function.gif)
------
#### [ Python ]
Amazon Q peut générer une fonction complète sur la base du commentaire que vous avez écrit. Une fois que vous avez terminé votre commentaire, Amazon Q suggère une signature pour la fonction. Si vous acceptez la suggestion, Amazon Q avance automatiquement votre curseur à la partie suivante de la fonction et formule une suggestion. Même si vous saisissez un commentaire ou une ligne de code supplémentaire entre les suggestions, Amazon Q effectue une refactorisation sur la base de votre saisie.
Dans l’exemple suivant, Amazon Q génère à la fois une fonction complète et le test unitaire correspondant.
![\[Exemple de saisie semi-automatique d’une fonction complète.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_pycharm_fullfunction_unittests.GIF)
La liste suivante contient des exemples expliquant comment Amazon Q formule des suggestions et vous guide tout au long du processus de création d’une fonction.
1. Dans l’image ci-dessous, un utilisateur saisit un commentaire. La signature de fonction, située sous le commentaire, est une suggestion d’Amazon Q.
![\[alt_text\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-jb-comment-062022.png)
1. Dans l’image ci-dessous, l’utilisateur a accepté la suggestion de signature de fonction d’Amazon Q. L’acceptation de la suggestion a automatiquement fait avancer le curseur et Amazon Q a formulé une nouvelle suggestion pour le corps de la fonction.
![\[alt_text\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunctionadvance-062022.png)
1. Dans l’image ci-dessous, un utilisateur saisit un commentaire dans le corps de la fonction avant d’accepter une suggestion d’Amazon Q. Sur la ligne suivante, Amazon Q a généré une nouvelle suggestion sur la base du commentaire.
![\[Génération d’une nouvelle suggestion sur la base d’un commentaire\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunction-062022.png)
Dans cet exemple, Amazon Q recommande une fonction complète après que l’utilisateur a saisi une partie de la signature.
![\[Exemple de fonction complète.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_fullfunction.gif)
------
# Utilisation d’Amazon Q Developer pour la saisie semi-automatique de blocs
La saisie semi-automatique de blocs sert à compléter vos blocs de code `if/for/while/try`.
------
#### [ C ]
![\[Exemple de saisie semi-automatique de bloc en langage C.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/block-completion-c.gif)
------
#### [ C\$1\$1 ]
![\[Exemple de saisie semi-automatique de bloc en langage C++.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/block-completion-c-plus.gif)
------
#### [ Java ]
Dans l’exemple ci-dessous, un utilisateur saisit la signature d’une instruction `if`. Le corps de l’instruction est une suggestion d’Amazon Q.
![\[Exemple de saisie semi-automatique de bloc.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-c9-block-completion.gif)
------
#### [ C\$1 ]
Dans l’image ci-dessous, Amazon Q recommande un moyen de compléter la fonction.
![\[Exemple de saisie semi-automatique de bloc.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/c-sharp-block.gif)
------
#### [ TypeScript ]
Dans l’image ci-dessous, Amazon Q recommande un moyen de compléter la fonction.
![\[Exemple de saisie semi-automatique de bloc.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_block-completion.gif)
------
#### [ Python ]
Dans cet exemple, Amazon Q recommande un bloc de code sur la base du contexte.
![\[Exemple de bloc de code.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_codeblock.gif)
------
# Utilisation d’Amazon Q Developer pour la saisie semi-automatique de docstrings, JSDoc et Javadoc
Amazon Q peut vous aider à générer ou à compléter la documentation de votre code.
------
#### [ C\$1\$1 ]
![\[Exemple de saisie semi-automatique de docstrings en langage C++.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/docstring-completion-c-plus.gif)
------
#### [ Javascript ]
Dans cet exemple, Amazon Q renseigne les paramètres JSDoc sur la base des constantes existantes.
![\[Exemple de saisie semi-automatique de paramètres JSDoc.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/javascript_vscode_JSDocCompletion.gif)
------
#### [ C\$1 ]
Dans cet exemple, Amazon Q renseigne les paramètres JSDoc sur la base des constantes existantes.
![\[Exemple de saisie semi-automatique de docstrings en langage C+.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/c-sharp-docstring.gif)
------
#### [ Java ]
L’exemple suivant est adapté d’[un exemple du site Web d’Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Dans l’image ci-dessous, l’utilisateur a commencé à saisir une docstring. Amazon Q a suggéré des mots à ajouter à celle-ci.
![\[suggestion de fonction pour compléter une docstring\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/jb-docstring-java.png)
L’exemple suivant est adapté d’[un exemple du site Web d’Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Dans l’exemple ci-dessous, l’utilisateur saisit une docstring en Java. Amazon Q suggère une fonction pour traiter la docstring.
![\[Exemple de saisie semi-automatique de code basé sur Javadoc.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/cw-c9-javadoc.gif)
------
#### [ Python ]
Dans cet exemple, Amazon Q recommande une docstring sur la base du contexte environnant.
![\[Exemple de docstring.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_commentblock.gif)
------
# Utilisation d’Amazon Q Developer pour les recommandations ligne par ligne
Selon votre cas d’utilisation, Amazon Q peut ne pas être capable de générer un bloc de fonction complet dans une recommandation. En revanche, Amazon Q peut vous fournir des recommandations ligne par ligne.
------
#### [ Go and GoLand ]
Dans cet exemple, Amazon Q fournit des recommandations ligne par ligne.
![\[Exemple de saisie semi-automatique ligne par ligne.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-go.gif)
Voici un autre exemple de recommandations ligne par ligne, cette fois-ci avec un test unitaire.
![\[Exemple de saisie semi-automatique ligne par ligne.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-unit-test-go.gif)
------
#### [ C\$1\$1 and CLion ]
Dans cet exemple, Amazon Q fournit des recommandations ligne par ligne.
![\[Exemple de saisie semi-automatique ligne par ligne.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-cpp.gif)
------
#### [ Python ]
Dans l’image suivante, le client a écrit un premier commentaire indiquant son souhait de publier un message dans un groupe Amazon CloudWatch Logs. Dans ce contexte, Amazon Q ne peut suggérer que le code d’initialisation du client dans sa première recommandation, comme le montre l’image suivante.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-1.png)
Toutefois, tant que l’utilisateur continue à demander des recommandations ligne par ligne, Amazon Q continue à suggérer des lignes de code sur la base de ce qui est déjà écrit.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-2.png)
**Note**
Dans l’exemple ci-dessus, `VPCFlowLogs` peut ne pas être la valeur constante correcte. Étant donné qu’Amazon Q formule des suggestions, n’oubliez pas de renommer les constantes si besoin.
Amazon Q finit par compléter l’ensemble du bloc de code, comme le montre l’image suivante.
![\[\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-3.png)
Dans cet exemple, Amazon Q fournit des recommandations ligne par ligne.
![\[Exemple de saisie semi-automatique ligne par ligne.\]](http://docs.aws.amazon.com/fr_fr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_linebyline.gif)
------