Olá, seja bem-vindo de volta.
Estamos começando uma nova seção.
E nesta seção, quero falar sobre alguns dos conceitos básicos em C.
Quero descrever algumas das coisas que tivemos em nosso exemplo ou nosso primeiro desafio,
nosso programa principal aqui.
Então, eu tenho esse desafio, você provavelmente se lembra dele.
Ele possui várias instruções diferentes nas linhas de código.
Vou tentar cobrir alguns dos conceitos aqui. Vou voltar e voltar a este exemplo.
A primeira coisa que quero discutir é o conceito de um comentário.
Então, vamos voltar a isso em um segundo. Eu quero ir para alguns slides neste momento.
Portanto, os comentários são usados em um programa para documentar um programa
e melhorar sua legibilidade.
Eu disse a você por que é importante que seu programa seja legível.
Porque você vai manter o código e precisa ser capaz de olhar para ele e
entender o que ele está fazendo. Portanto, com comentários, pode
ajudar um
pouco neste conceito de legibilidade.
Os comentários existem para lembrar você ou outra pessoa que está lendo seu
código o que o programa está fazendo ou o que uma linha específica de código está fazendo.
Portanto, os comentários estão aí para seu benefício.
Os comentários são ignorados pelo compilador.
Portanto, não importa se você seguir a sintaxe dos comentários, o compilador não vai lançar
nenhum erro, seja o que for que esteja dentro do comentário.
Então, novamente, eles são muito úteis e você deseja usá-los em seus programas.
E eles são um conceito básico de todas as linguagens de programação.
E, portanto, não há realmente nada de novo aqui para ver.
Novamente, você pode, como um programador, escrever algum código, voltar a ele em 6
meses e você pode não se
lembrar por que escreveu o código da maneira que o fez.
Você pode não entender a funcionalidade, pode não entender a lógica.
Ao fornecer um comentário no
código, ele pode economizar uma quantidade significativa de tempo que você perde reaprendendo
coisas, especialmente reaprendendo esse código.
Ou imagine que você escreveu
algum código e é um programa grande, há muitos programadores trabalhando nele
e outra pessoa precisa olhar esse código.
Se houver comentários e eles estiverem descrevendo o que o código está fazendo,
essa outra pessoa será capaz de entender o código muito mais rápido.
Vai ficar mais legível. Portanto, novamente, os comentários ajudam a legibilidade,
ou ajudam a legibilidade do programador que escreveu o código, ou ajudam
a legibilidade de outra pessoa que está olhando o código.
Você pode facilmente olhar para o código-fonte e então entender rapidamente o que o código está fazendo.
E então você deseja fornecer comentários em seu código.
A sintaxe para fornecer comentários em seu código é
que há 2 maneiras de fornecer comentários em seu código.
E, novamente, isso é muito, muito semelhante ao java, muito semelhante a muitas linguagens.
Mas em c, você pode ter comentários de várias linhas ou comentários únicos.
Se você usar 2 caracteres, a barra seguida do asterisco, isso
significará um comentário de várias linhas, um comentário que
se estende por muitas linhas.
E a estrela de barra marca o início desse comentário.
E quando você tem esses comentários de várias linhas porque eles têm um comentário
inicial, você precisa ter algo que diga que está terminando.
Portanto, para encerrar os comentários, coloque os caracteres asterisco e
barra no final, sem espaços entre eles.
E então qualquer coisa entre a estrela de
barra e a barra final da estrela
é considerada um comentário,
tudo em azul isso. E dessa forma você pode abranger várias linhas.
A outra maneira de adicionar um comentário ao programa c é usar comentários de
uma única linha.
Os comentários de uma linha são apenas 2 barras.
Qualquer coisa após as 2 barras nessa linha é
ignorado pelo compilador e considerado um comentário.
Qualquer coisa depois disso não é um comentário, é uma nova linha de código.
Portanto, realmente depende do comentário
que você está fornecendo, se você deseja ou não usar comentários de várias linhas ou de uma única linha.
E vou mostrar como você pode adicioná-los ao seu código em um segundo.
Agora, no que diz respeito ao estilo, quer você use comentários de várias linhas ou
comentários de uma única linha, você provavelmente vai usar ambos, dependendo do que está tentando fazer
ou de quantas linhas tem para descrever ou do tamanho do seu comentário.
Neste exemplo, estamos usando um comentário de várias linhas aqui, e isso
normalmente ficaria no topo do arquivo. Ele descreve quem escreveu
o arquivo, o autor do arquivo e os direitos autorais.
Você também pode fornecer comentários que se destacam se
algo realmente importante em seu código estiver
acontecendo, fornecendo muitos asteriscos.
E então o segundo exemplo aqui onde diz que este é um comentário muito importante,
ele realmente se destaca por causa de todos aqueles asteriscos.
Portanto, é um estilo meio diferente do comentário do título na parte
superior do primeiro exemplo.
Agora, o último exemplo aqui, que é apenas um comentário de uma única linha,
está no final de uma linha de código e basicamente diz a você o que uma única linha está fazendo.
Então, você vê esses estilos diferentes de comentários de várias linhas em comparação com comentários de uma única linha.
Aqui está um exemplo comum que você veria em um programa.
Este é um programa que contém código C.
Você provavelmente não sabe realmente o que diabos isso está fazendo.
Mas você pode olhar os comentários e identificar o que está acontecendo.
Portanto, há um comentário no topo que diz que este programa adiciona 2 valores inteiros e exibe os resultados.
Está dizendo a você o propósito do programa,
o que está fazendo.
E então você vê alguns comentários de uma única linha.
E como você sabe que são comentários de uma única linha? Porque eles têm 2 barras.
Portanto, você vê um comentário de uma única linha que diz declarando variáveis.
Você vê outro que diz atribuir valores e calcular sua soma.
E então você vê um que diz exibir o resultado.
Cada comentário de uma única linha descreve cada um dos grupos de código, informando o que
eles estão fazendo.
E assim você pode olhar rapidamente
para este código e entender o que ele está fazendo olhando os comentários.
Isso torna o programa mais legível.
A legibilidade é uma vantagem porque torna o código mais fácil de manter.
Portanto, é importante usar comentários. E este é um exemplo rápido de
adição de comentários a algum código.
Agora, com que frequência devemos utilizar os comentários.
Existe o conceito de ter muitos comentários.
Você não quer que seu código tenha um comentário para cada linha.
Na verdade, isso diminui a legibilidade do código porque ele está apenas transbordando.
Na verdade, está dificultando a leitura porque é simplesmente opressor.
Portanto, você não deseja colocar um comentário para cada linha de código.
Você deve escolher seus comentários com sabedoria e usá-los de forma inteligente.
Isso virá com a prática, quando
adicionar comentários, quando não adicionar comentários, onde colocá-los.
Normalmente, terei comentários no topo do meu arquivo de origem
com informações padrão como o autor, o propósito, a descrição, a data
de criação dos comentários e, em seguida, intercalados em todo o meu código, descrevendo
algumas linhas de código onde a lógica está um pouco mais complicado.
Nem sempre incluirei comentários apenas para declarar variáveis, porque é meio óbvio.
Posso não incluir comentários para certas funções, descrições porque
a própria descrição pode ser mais significativa.
Tudo depende e vem com a prática.
Mas sempre que você adiciona comentários, é tradicionalmente uma boa
ideia adicioná-los ao escrever o código.
Um porque se você fizer isso então, você terá o programa comentado e
não se esquecerá de fazê-lo.
Também é mais fácil documentar o programa por que você
realmente entende o que ele está fazendo enquanto escreve o código.
Ainda fresco em sua mente, você não precisa voltar um mês depois
e dizer o que eu quis dizer aqui e agora tenho que adicionar um comentário.
Portanto, adicione os comentários enquanto escreve o código.
E os comentários também podem ajudar quando você está tentando encontrar e corrigir seus
erros, durante a fase de depuração. Se houver erros de lógica,
você pode olhar os comentários e pode isolar, bem, foi
esse o erro que aconteceu.
Esse comentário se alinha com essa funcionalidade.
Aposto que o erro está neste grupo de código. Portanto, ajuda a isolar erros na depuração.
Um comentário pode ajudá-lo a ler o programa, mas também pode apontar o caminho para a
origem de um erro lógico, portanto, os comentários são importantes.
Agora, o outro argumento ao fornecer comentários é,
novamente, que há um grande debate com os programadores, quantos comentários você fornece?
E existe um bom livro chamado Clean Code, que fala sobre
como escrever código de qualidade. Acredite ou não, pode
haver código bom ou código ruim, e isso é
conhecido como qualidade do código.
Você deseja escrever código de alta qualidade.
Falaremos sobre isso ao longo do curso, mas muitos alunos que aprendem novas linguagens pensam, desde que a
saída corresponda ao que eu preciso, não importa
como escrevo o código. Isso não é verdade.
Porque, novamente, lembre-se dessa fase de manutenção.
Lembre-se de que o produto
ou programa que você lança ficará em campo por alguns anos.
E se você quiser encontrar bugs existentes ou adicionar novos recursos, é importante
que o código seja de alta qualidade, mais fácil de manter, muito
fracamente acoplado e altamente coeso.
E falaremos sobre esses conceitos à medida que avançarmos.
Estaremos escrevendo código de alta qualidade durante a aula.
Uma das maneiras de escrever código de alta qualidade é fornecer comentários, mas
também fornecer comentários autodocumentados.
O que isso significa é realmente usar nomes significativos. É disso que fala o livro Código Limpo.
Ao criar uma variável, use um nome significativo.
Portanto, quando você olha para a variável, sabe exatamente para que ela está sendo usada,
não é necessário fornecer um comentário.
Se você tem uma função que adiciona 2 números, nomeie a função adicionar 2 números.
Então você precisa de um comentário para dizer o que essa função está fazendo, não.
Porque o nome está dizendo a você o que está fazendo.
Portanto, nomes significativos são uma boa maneira de fornecer comentários autodocumentados.
Vamos voltar ao nosso exemplo do nosso
desafio e quero mostrar exatamente
como você pode adicionar comentários e onde adicioná-los.
E você notará que o compilador irá ignorar esses comentários.
Portanto, em nosso primeiro exemplo aqui, que é um programa
básico, normalmente adicionarei comentários de várias linhas na parte superior do arquivo antes de quaisquer linhas de código.
E lembre-se de que podemos adicionar esses comentários de várias linhas fornecendo apenas uma barra, estrela
ou asterisco para iniciar o comentário.
E então qualquer coisa entre o comentário
será o comentário,
qualquer coisa entre a estrela e o asterisco.
E você notará quando eu fizer aquela barra estrela que tudo está cinza porque
isso está me dizendo que eu não tenho meu comentário final agora.
Portanto, você deve adicionar essa barra
estrela para encerrar o comentário. E você verá que as cores agora mudam.
É por isso que gosto de usar um IDE, porque ele diz muito sobre essa formatação coordenada
por cores.
Portanto, qualquer coisa entre a estrela de barra é o início de
um comentário de várias linhas, qualquer coisa antes da estrela à frente é
a descrição ou o final do comentário de várias linhas.
E geralmente colocarei no topo do arquivo algo
como autor e colocarei meu nome e então colocarei talvez um propósito.
Isso geralmente é uma boa prática e vou colocar algo parecido
com este programa, imprime meu nome na tela.
E geralmente fornecerei uma data de quando foi criado, seja qual for a data.
E esse é um exemplo de comentário de várias linhas no topo E então irei fornecer comentários em
todo o código. Normalmente comentários de uma
linha ou comentários de várias linhas, depende apenas de quantos comentários existem.
Então, talvez não estejamos familiarizados com este código. E eu poderia dizer que você sabe
que 2 barras é um comentário de uma única linha. Posso dizer que este código
está exibindo meu nome.
E, novamente, quando eu forneço essas barras ou comentários de
várias linhas, o compilador os ignora. Basicamente, você pode colocar o que quiser lá dentro e não importa.
Não há sintaxe que você precise seguir, não há nada.
É ignorar tudo o que está colorido em cinza aqui, que é
considerado um comentário.
Portanto, os comentários são uma coisa fundamental básica de todo programa.
Queria descrevê-los no início porque irei utilizá-los e você deve
adicioná-los à medida que escreve seu código.
Além disso, com comentários dentro do IDE,
há momentos em que você está compilando seu código e está tudo falhando.
E então há momentos em que você pode querer comentar tudo ou
comentar blocos de código para tentar depurar seu problema, tente isolar seu erro.
Você pode destacar várias linhas de código e, em
seguida, ir até a edição no menu e pode dizer
comentar ou descomentar.
Se você disser comentário, ele comentará todo o código
que você destacou.
E então você pode recompilar e talvez você não tenha mais um erro de compilador.
É uma forma de isolar erros em tempo de execução ou em tempo de compilação.
Portanto, o IDE tem algumas
ferramentas interessantes que permitem comentar várias linhas automaticamente, destacando
e alternando.