Pesquisar aqui

Mostrar mensagens com a etiqueta Comentários. Mostrar todas as mensagens
Mostrar mensagens com a etiqueta Comentários. Mostrar todas as mensagens

segunda-feira, 8 de junho de 2020

JavaScript - Comentários

NESTA PUBLICAÇÃO IREI ENSINAR A ESCREVER COMENTÁRIOS EM JAVASCRIPT. SÃO BASTANTE ÚTEIS EM TODOS OS TIPOS DE CÓDIGO SEJA QUAL FOR A LINGUAGEM DE PROGRAMAÇÃO E JAVASCRIPT NÃO É EXCEPÇÃO.

Nem todas as linhas de código em JavaScript são executados. Os comentários são linhas de código que são ignoradas e não são executadas e têm como função explicar alguma linha de código. Em projetos grandes com muito código normalmente este está dividido por diversos comentários que explicam o que cada bloco de código faz.
Para escrever um comentário basta escrever depois de // como no exemplo a seguir:


<script>
   // Isto é uma linha única de comentário
</script>

Para criar comentários de múltiplas linhas basta usar  /*   */ como no exemplo a seguir:


<script>
   /* Isto é um
   comentário que ocupa
   múltiplas linhas */
</script>


Referências:



sexta-feira, 5 de junho de 2020

Iniciação ao CSS: comentários

No CSS, tal como em outras linguagens de programação, existem comentários. Estes são extremamente importantes, sendo uma peça crucial de qualquer código. O mais interessante? Não alteram nada no mesmo. A única função dos comentários é apenas deixar uma breve descrição do nosso raciocínio ou da funcionalidade de determinada linha ou conjuntos da mesma. Desta maneira, alguém que venha editar o nosso código, pode mais facilmente entender o que escrevemos. Para além disso, pode ser muito útil para nós próprios.
Ao contrário da maioria das linguagens de programação, o CSS tem apenas um tipo de comentário (que serve tanto para comentários de linha única, ou comentários de várias linhas).


Print do autor.


quarta-feira, 27 de maio de 2020

Iniciação ao HTML: comentários

Os comentários são algo transversal a todas as linguagens de programação, possuindo um papel fundamental, principalmente para quem trabalha em equipa. Com os mesmos é possível escrever detalhes e/ou o raciocínio que tivemos na escrita de determinada linha ou estrutura. Desta maneira, outra pessoa que mexa no nosso código (ou até nós mesmos), entenderá o que foi escrito.




É importante que tenham a noção de que qualquer coisa que esteja dentro de um comentário não será interpretada e executada pelo compilador, logo, não tenham medo, pois não alterará a página.

Imagens produzidas pelo autor.

sexta-feira, 8 de maio de 2020

Iniciação ao JS: Comentários

Os comentários são cruciais em qualquer linguagem de programação. Ajuda nós e os outros a perceber o qual o raciocínio seguido na escrita daquele pedaço de código ou o seu objetivo ou aquilo que se refere. Pode parecer uma ferramenta exclusivamente útil para programadores em equipa, mas acredite, também é muito útil quando vamos mexer num pojeto que já não tocávamos à muito tempo.



Como puderam ver nos exemplos acima, os comentários podem ser feitos numa linha apenas, sendo apenas necessário iniciá-lo com "//". Caso necessite escrever um comentário que se prolongue por mais do que uma linha, terá que iniciar o mesmo com "/*" e terminá-lo com "*/". 

Imagens produzidas pelo autor

quarta-feira, 27 de novembro de 2019

Python - Comentários

COMENTÁRIOS SÃO BASTANTE IMPORTANTES EM QUALQUER CÓDIGO DE QUALQUER LINGUAGEM DE PROGRAMAÇÃO, VISTO QUE AJUDAM A ORGANIZAÇÃO DE IDEIAS DO PROGRAMADOR!

Comentários são como post its que o programador coloca no seu código, assim como os estudantes colam post its com informação ou notas que complementam o estudo, os programadores fazem o mesmo. O Python ignora tudo o que está escrito no comentário, complementando apenas o código.


Porque é que comentários são importantes:
  • Quando está a ler o seu código, os comentários ajudam a organizar as ideias ou a explicar alguma linha de código ou opção;
  • Quando alguém está a ler o código de outra pessoa, para perceber o que é que a outra pessoa escreveu e porque fez daquela maneira;
Em Python, existem dois tipos de comentários:
  • Comentário Simples - apenas uma linha de comentário; para escrever um comentário simples basta digitar cardinal '#' e depois escrever o comentário à sua frente, como no exemplo:
1
#isto é um comentário
  • Comentário múltiplo - múltiplas linhas de comentário, como por exemplo:
1
2
3
4
5
"""
isto é um 
comentário 
composto
"""

ou assim:


1
2
3
#isto é um 
#comentário 
#composto


Shortcuts de comentários múltiplos:

  • Pressione a tecla "Ctrl" e clique com o lado esquerdo do rato nas linhas em que deseja escrever, e basta digitar! Isto é útil quando quer escrever o mesmo comentário em linhas diferentes do seu código:


  • Selecione as linhas que deseja transformar em comentário e clique a tecla "Ctrl"+"/":


Tente nunca escrever comentários de uma forma insultuosa ou errada, e pronto, agora já sabe escrever comentários em Python, já consegue organizar o seu código!



Referências:


segunda-feira, 4 de novembro de 2019

C++ - Comentários

Uma parte importante da programação e escrita de código é identificar e explicar o que escrevemos de modo a facilitar a leitura, seja para nós próprios ou para os outros que poderão lê-lo.
Isto faz-se partir de uma ferramenta chamada comentário.
Os comentários não são lidos pelo compiler, ou seja, são apenas úteis para o programador, seja para organizar ou para explicar o código. No fundo, é como se nem estivessem lá. Mas é preciso ter cuidado para não interferirem com o código, se estiverem mal posicionados.

Linha única (//)
Para adicionar um comentário de um linha no C++, é necessário colocar "//" antes das palavras do comentário.
Exemplo:
int num = 1;
//Olá! Isto é um comentário!
char h = 'H';

Como veem, o que está depois do "//" é um comentário.
Pode ser colocado em cima, em baixo, e há direita de código, mas nunca há esquerda (e obviamente também não no meio do código). Se à esquerda, todo o código que está à direita transforma-se num comentário.

À direita:
int num = 3; //Aqui, criamos uma variável de valor 3

À esquerda:
//Aqui, criamos uma variável de valor 3 int num = 3;


Múltiplas linhas (/* */)
Para adicionar um comentário de várias linhas, é necessário colocar "/*" no início, e "*/" no fim.
Exemplo:
/* Isto
   é
   um
   comentário */

O comentário engloba então essas 3 linhas mais um restinho da quarta.

Não necessariamente tem de ser de várias linhas. Pelo contrário, posso usar este tipo de comentário para criar um comentário ainda mais pequeno, com os limites definidos. Diferente do comentário de uma linha ("//") que começa num lugar e vai até o fim da linha.

Exemplo:
/* Comentário */ int num = 3;
int number = 5; /* Comentário 2 */


Vou também usar os comentários para explicar certas partes de códigos futuramente.
É sempre um bom hábito comentar os nossos códigos, nem que seja para ficar mais bonito. É muito importante no caso de nos esquecermos o que o código faz. Muitas vezes, vamos ter escrito tanto código que ficamos perdidos!

Referências

sexta-feira, 31 de março de 2017

Inserir comentários em Javascript

Um comentário é uma parte do código que não é interpretada pelo navegador, sendo frequentemente utilizado para escrever textos que ajudam a identificar o que representa o um dado bloco de código. Pensando num trabalho em equipa, esta é uma excelente prática.



– Para fazer um comentário com uma linha de código utiliza-se a dupla barra, //:
<script>
// window.alert("Este alerta não será mostrado");
</script>

– Para comentar várias linhas, deve-se iniciar o texto com /* e terminar com */.

<script>
/* Exemplo de comentário para
várias linhas.
Basta escolher o início e fim. */
</script>

domingo, 29 de janeiro de 2017

Comentários em HTML e CSS

A apresentação de comentários é uma boa prática para quem está a programar.

Os comentários são geralmente utilizados para explicar o código, revelando-se bastante úteis quando se pretender modificar o código mais tarde (especialmente, se este for muito extenso), já que permitem manter uma apresentação mais organizada, estruturada e de leitura fácil.


Em HTML, a estrutura do comentário é a seguinte:

<!--Isto é um comentário. Os comentários não são exibidos no browser-->

<p>This is a paragraph.</p>
























Em CSS, os comentários apresentam-se da seguinte forma:

p {
    color: red;
    /* Isto é um comentário */
 }