As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de código
O Amazon Q pode sugerir código em diferentes cenários. Para entender como isso pode ajudá-lo a escrever código na linguagem de programação de sua escolha, veja os exemplos de código a seguir.
**Topics**
+ [Usando o Amazon Q Developer para preenchimento de código de linha única](single-line-completion.md)
+ [Usando o Amazon Q Developer para geração completa de funções](full-function-generation.md)
+ [Usando o Amazon Q Developer para conclusão de blocos](code-block.md)
+ [Usando o Amazon Q Developer para conclusão de Docstring, JSDoc e Javadoc](docstring-javadoc.md)
+ [Usando o Amazon Q Developer para recomendações linha por linha](line-by-line-1.md)
# Usando o Amazon Q Developer para preenchimento de código de linha única
Quando você começa a digitar um código de linha única, o Amazon Q faz sugestões com base nas entradas atuais e anteriores.
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento de linha única usando o C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/single-line-completion-c-plus.gif)
------
#### [ JavaScript ]
Neste exemplo, o Amazon Q completa uma linha de código que o desenvolvedor inicia.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_vscode_SingleLine.gif)
------
#### [ TypeScript ]
Neste exemplo, o usuário insere um comentário completo e, em seguida, a Amazon Q fornece o código que o acompanha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_single-line.gif)
------
#### [ C\$1 ]
Neste exemplo, o Amazon Q fornece uma recomendação de linha única com base em um comentário.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-single-line.gif)
------
#### [ Shell ]
Na imagem abaixo, o Amazon Q oferece recomendações sobre como preencher uma única linha de código.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-single-line-shell.gif)
------
#### [ Java ]
Quando você começa a digitar um código de linha única, o Amazon Q faz sugestões com base nas entradas atuais e anteriores.
No exemplo abaixo, em Java, um usuário insere a cadeia de caracteres `public` em uma classe existente.
Com base na entrada, o Amazon Q gera uma sugestão para a assinatura do método principal.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-single-line-completion.gif)
------
#### [ Python ]
Neste exemplo, a Amazon Q recomenda uma única linha de código, com base no comentário do desenvolvedor.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_singleline.gif)
------
# Usando o Amazon Q Developer para geração completa de funções
O Amazon Q consegue gerar uma função inteira com base em um comentário que você escreveu. Ao terminar seu comentário, o Amazon Q sugerirá uma assinatura de função. Se você aceitar a sugestão, o Amazon Q avançará automaticamente o cursor para a próxima parte da função e fará uma sugestão. Mesmo que você insira outro comentário ou uma linha de código entre as sugestões, o Amazon Q refatorará com base na entrada.
------
#### [ C ]
![\[Um exemplo do atributo de preenchimento completo da função usando C.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento completo da função usando C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ JavaScript ]
No exemplo a seguir, o usuário gera e, em seguida, edita uma função completa com base em um conjunto de comentários.
![\[Um exemplo do atributo de geração de funções completas.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_lambda_FullFunctionGeneration.gif)
Na imagem a seguir, o usuário escreveu uma assinatura de função para ler um arquivo do Amazon S3. Em seguida, o Amazon Q sugere uma implementação completa do método `read_from_s3`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-read-from-s3.png)
**nota**
Às vezes, como no exemplo anterior, o Amazon Q inclui declarações `import` como parte das sugestões. Como prática recomendada, mova manualmente essas declarações `import` para a parte superior do arquivo.
Como outro exemplo, na imagem a seguir, o usuário escreveu uma assinatura de função. Em seguida, o Amazon Q sugere uma implementação completa do método `quicksort`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-quicksort.png)
Ao fazer sugestões, o Amazon Q leva em consideração trechos de código anteriores. Na imagem a seguir, o usuário do exemplo anterior aceitou a implementação sugerida para `quicksort` acima. O usuário então grava outra assinatura de função para um método `sort` genérico. O Amazon Q sugere uma implementação com base no que já foi gravado.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-from-context-sort.png)
Na imagem a seguir, o usuário escreveu um comentário. Com base nesse comentário, o Amazon Q sugere uma assinatura de função.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-comment-binary-search.png)
Na imagem a seguir, o usuário do exemplo anterior aceitou a assinatura de função sugerida. O Amazon Q pode então sugerir uma implementação completa da função `binary_search`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-binary-search.png)
------
#### [ Java ]
A lista a seguir contém exemplos de como o Amazon Q faz sugestões e orienta você por todo o processo de criar uma função.
1. No exemplo a seguir, um usuário insere um comentário. O Amazon Q sugere uma assinatura de função.
Depois que o usuário aceita a sugestão, o Amazon Q sugere um corpo da função.
![\[Um exemplo de função gerada com base em um comentário.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment.gif)
1. Na imagem abaixo, o usuário insere um comentário no corpo da função antes de aceitar uma sugestão do Amazon Q. Na linha a seguir, o Amazon Q gera uma sugestão com base no comentário.
![\[Um exemplo de função gerada com base em um comentário dentro de um bloco de código existente.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment-within-block.gif)
------
#### [ C\$1 ]
No exemplo a seguir, o Amazon Q recomenda uma função completa.
![\[Function declaration for ListTables with AmazonDynamoDBClient parameter in code editor.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-full-function.gif)
------
#### [ TypeScript ]
No exemplo a seguir, o Amazon Q gera uma função com base nas docstrings do usuário.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_function.gif)
------
#### [ Python ]
O Amazon Q consegue gerar uma função inteira com base em um comentário que você escreveu. Ao terminar seu comentário, o Amazon Q sugerirá uma assinatura de função. Se você aceitar a sugestão, o Amazon Q avançará automaticamente o cursor para a próxima parte da função e fará uma sugestão. Mesmo que você insira outro comentário ou uma linha de código entre as sugestões, o Amazon Q refatorará com base na entrada.
No exemplo a seguir, o Amazon Q gera uma função completa e o teste de unidade correspondente.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_pycharm_fullfunction_unittests.GIF)
A lista a seguir contém exemplos de como o Amazon Q faz sugestões e orienta você por todo o processo de criar uma função.
1. Na imagem abaixo, um usuário inseriu um comentário. A assinatura da função, localizada abaixo do comentário, é uma sugestão da Amazon Q.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-comment-062022.png)
1. Na imagem abaixo, o usuário aceitou a sugestão do Amazon Q para uma assinatura de função. Aceitar a sugestão avançou automaticamente o cursor e a Amazon Q fez uma nova sugestão para o corpo da função.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunctionadvance-062022.png)
1. Na imagem abaixo, o usuário insere um comentário no corpo da função antes de aceitar uma sugestão do Amazon Q. Na linha a seguir, o Amazon Q gerou uma nova sugestão com base no conteúdo do comentário.
![\[gerando uma nova sugestão com base no conteúdo de um comentário\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunction-062022.png)
Neste exemplo, a Amazon Q recomenda uma função completa após o usuário digitar parte da assinatura.
![\[Um exemplo do atributo de função completa.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_fullfunction.gif)
------
# Usando o Amazon Q Developer para conclusão de blocos
O preenchimento do bloco é usado para preencher blocos de código `if/for/while/try`.
------
#### [ C ]
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/block-completion-c.gif)
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/block-completion-c-plus.gif)
------
#### [ Java ]
No exemplo abaixo, em Java, um usuário insere a assinatura de uma instrução `if`. O corpo da instrução é uma sugestão do Amazon Q.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-block-completion.gif)
------
#### [ C\$1 ]
Na imagem abaixo, a Amazon Q recomenda uma forma de concluir a função.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-block.gif)
------
#### [ TypeScript ]
Na imagem abaixo, a Amazon Q recomenda uma forma de concluir a função.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_block-completion.gif)
------
#### [ Python ]
Neste exemplo, o Amazon Q recomenda um bloco de código, com base no contexto.
![\[Um exemplo do atributo de bloco de código.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_codeblock.gif)
------
# Usando o Amazon Q Developer para conclusão de Docstring, JSDoc e Javadoc
O Amazon Q pode ajudar você a gerar ou completar a documentação dentro do seu código.
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento de docstring usando C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/docstring-completion-c-plus.gif)
------
#### [ Javascript ]
Neste exemplo, o Amazon Q preenche os parâmetros do JSDoc com base nas constantes existentes.
![\[Um exemplo do atributo de conclusão do JSDoc.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_vscode_JSDocCompletion.gif)
------
#### [ C\$1 ]
Neste exemplo, o Amazon Q preenche os parâmetros do JSDoc com base nas constantes existentes.
![\[Um exemplo de C3 com conclusão de DocString.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-docstring.gif)
------
#### [ Java ]
O exemplo a seguir foi adaptado de [um exemplo no site da Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Na imagem abaixo, o usuário começou a inserir uma docstring. O Amazon Q sugeriu palavras para adicionar à docstring.
![\[sugerindo uma função para completar uma docstring\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-docstring-java.png)
O exemplo a seguir foi adaptado de [um exemplo no site da Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
No exemplo abaixo, em Java, o usuário insere uma docstring. O Amazon Q sugere uma função para processar a docstring.
![\[Um exemplo de preenchimento de código baseado em um Javadoc.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-javadoc.gif)
------
#### [ Python ]
Neste exemplo, o Amazon Q recomenda uma Docstring, com base no contexto circundante.
![\[Um exemplo do atributo Docstring.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_commentblock.gif)
------
# Usando o Amazon Q Developer para recomendações linha por linha
Conforme o caso de uso, o Amazon Q pode não conseguir gerar um bloco de função inteiro em uma recomendação. Porém, o Amazon Q ainda pode fornecer recomendações linha por linha.
------
#### [ Go and GoLand ]
Neste exemplo, o Amazon Q fornece recomendações linha por linha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-go.gif)
Aqui está outro exemplo de recomendações linha por linha, desta vez com um teste unitário.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-unit-test-go.gif)
------
#### [ C\$1\$1 and CLion ]
Neste exemplo, o Amazon Q fornece recomendações linha por linha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-cpp.gif)
------
#### [ Python ]
Na imagem a seguir, o cliente escreveu um comentário inicial indicando que deseja publicar uma mensagem em um grupo do Amazon CloudWatch Logs. Nesse contexto, o Amazon Q só pode sugerir o código de inicialização do cliente na primeira recomendação, como mostra a imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-1.png)
Porém, se o usuário continuar solicitando recomendações linha por linha, o Amazon Q também continuará sugerindo linhas de código com base no que já foi escrito.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-2.png)
**nota**
No exemplo acima, `VPCFlowLogs` pode não ser o valor constante correto. À medida que o Amazon Q faz sugestões, lembre-se de renomear as constantes, conforme necessário.
O Amazon Q pode chegar a preencher todo o bloco de código, como mostra a imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-3.png)
Neste exemplo, o Amazon Q fornece recomendações, uma linha por vez.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_linebyline.gif)
------