Instruções para os Trabalhos Computacionais
Os trabahos computacionais serão avaliados segundo os seguintes critérios:
Utilização única da linguagem C (não use C++).
Cumprimento da especificação solicitada, simplicidade e eficiência da solução algorítmica;
Facilidade de uso, utilizando mensagens claras e objetivas para solicitar dados do usuário e apresentar resultados para ele;
Organização e apresentação do código fonte visando facilitar sua leitura, como uso de espaçamento entre operadores ou parâmetros e identação (alinhamento) das linhas de código de modo a refletir a estrutura do programa.
Qualidade da modularização e capacidade de reuso do código. Atenção a coesão (tarefa bem determinada) e acoplamento (baixa dependência entre funções).
Utilização mínima e parciomoniosa (ou ausência) de comandos de desvio incondicional, como goto, break, return, exit, continue.
Documentação por comentários no código. Os comentários devem estar em pontos estratégicos, presentes em todas as partes onde a execução do programa não seja descrita de forma trivial ou onde o papel de alguma variável não seja de compreensão imediata. Não comente o óbvio. Não esqueça de documentar cada função e seus parâmetros, e também as variáveis principais. Comente cada Códigos não comentados ou mal comentados poderão não ser analisados para avaliação ou poderão não ser corrigidos em sua totalidade.
Utilização de nomes relevantes para identificadores de varíáveis, tipos de dados, funções e procedimentos;
Utilização de constantes para parametrizar o programa.
Utilização mínima e parciomoniosa (ou ausência) de variáveis globais.
Elaboração de breve relatório, como preâmbulo nas linhas iniciais do programa, contendo:
Programa: breve descrição do programa (1 frase curta)
Autor: [nome de quem fez o programa]
Disciplina: Técnicas de Programação
Concluído em: [data de conclusão do código ]
Breve descrição: [descrição geral e sucinta sobre o que faz o programa (2-4 linhas), implementação]
Operação do programa: [quais as entradas necessárias para o programa e como devem ser feitas, e quais são as saídas do programa]
Condições de contorno: [qual é o conjunto de dados de entrada válido para o correto funcionamento do programa? em que situação o seu programa não funcionaria?]
Testes realizados: [Descrição dos erros ocorridos e da(s) estratégia(s) utilizada(s) para o teste do programa. A fase de teste é outra etapa importante no processo de desenvolvimento de software. O processo de concepção de um software deve levar em conta a questão sobre como testar o que foi construído. Obviamente não é possível verificar todas as possibilidades de uso de um software. É necessário, contudo, executar uma série adequada de testes que dê um grau mínimo de confiança de que o artefato de software construído está funcionando de forma aceitável. O ideal seria que pessoas distintas das que tivessem elaborado um programa elaborassem as seqüências de teste baseadas apenas na descrição do que o programa faz e não como o programa resolve o problema em questão.]
Observações: [Quais foram as dificuldades encontradas. O que não foi feito. O que foi feito a mais. Sugestões sobre possíveis extensões e melhorias do programa. Outras observações relevantes.]
Declaração de Autoria: Declaro que este código foi elaborado por mim de forma individual e não contém nenhum trecho de código de outro colega ou de outro autor, tais como provindos de livros e apostilas, e páginas ou documentos eletrônicos da Internet. Qualquer trecho de código de outra autoria que não a minha está destacado com uma citação para o autor e a fonte do código, e estou ciente que estes trechos não serão considerados para fins de avaliação.
A entrega desta primeira parte deve ser feita até a data combinada, enviando mensagem para angelocl [arroba] gmail.com, colocando no assunto: [EXA045]. Devem ser entregues os arquivos do código fonte (.C), contendo como preâmbulo o relatório do trabalho. Não submeta o arquivo executável (.EXE)!
Exemplo do formato de um programa a ser entregue
/********************************************************************************
Programa: Contagem de números
Autor: Fulano de Tal
Disciplina: Técnicas de Programação
Concluido em: 14/08/2006
Breve Descrição:
Este programa faz a leitura de n números
e conta quantos são positivos, negativos e nulos.
Operação do Programa:
O usuário deve fornecer os valores conforme solicitados pelo programa.
Os valores são solicitados, um por vez, por uma mensagem que indica a
posição do valor esperado na seqüência de dados de entrada. Após a
digitação o usuário deverá pressionar a tecla ENTER para disparar o
processo de leitura. Para processar seqüências de tamanho diferente de 10,
o valor da constante N deve ser alterado no código e o código recompilado.
Ao final deste processo, são apresentados os resultados da quantidade de
positivos, negativos e nulos.
Condições de Contorno :
O programa aceita quaisquer valores inteiros no intervalo de inteiros representáveis
pelo tipo integer. Dados, que não atendam a sintaxe de inteiros em C, provocarão
um "erro fatal" e, conseqüentemente, a interrupção da execução do programa.
Testes realizados:
O programa foi testado com algumas seqüências de valores apenas positivos,
apenas negativos, de zeros apenas e com valores mistos. O programa se
comportou da maneira esperada.
Observações:
Dificuldades Encontradas
As mensagens de solicitação de dados ao usuário apresentaram problemas de
alinhamento sempre que o número de dígitos da variável i crescia. Para
resolver o problema, passou-se a imprimir o valor de i de maneira "formatada"
em um campo de 3 posições fixas. O código do programa funciona, portanto,
para valores de n até 999. Para valores maiores, a dimensão do campo formatado
precisa ser revisto.
O que não foi feito
O programa implementou todos os requisitos fornecidos na especificação.
O que foi feito a mais
Nenhum recurso não especificado foi implementado
Sugestões
O programa, ao invés de ter nele embutido o tamanho da seqüência,
poderia solicitar este valor ao usuário.
O programa poderia ser estendido para processar mais de uma seqüência
de dados conforme solicitação do usuário.
Declaro que este código foi elaborado por mim de forma individual e não contém nenhum
trecho de código de outro colega ou de outro autor, tais como provindos de livros e
apostilas, e páginas ou documentos eletrônicos da Internet. Qualquer trecho de código
de outra autoria que não a minha está destacado com uma citação para o autor e a fonte
do código, e estou ciente que estes trechos não serão considerados para fins de avaliação.
********************************************************************************/
#include <stdio.h>
#define N 10
int main ()
{
int i, numero;
int positivos, negativos, nulos; /** contadores **/
/** inicialização dos contadores **/
positivos = 0;
negativos = 0;
nulos = 0;
/** solicitação e análise dos dados para determinar o número de
valores em cada categoria **/
printf("Entre com %d numeros inteiros.\n",N);
for(i = 1; i<=N;i++)
{
printf("%d)",i);
scanf("%d",&numero);
/** análise do numero digitado para determinar categoria **/
if (numero > 0)
{
printf("O numero %d e' maior que zero\n",numero);
positivos++;
}
else
if (numero < 0)
{
printf("O numero %d e' menor que zero\n",numero);
negativos++;
}
else /** neste caso numero = 0 **/
{
printf("O numero %d e' nulo\n",numero);
nulos++;
}
}
/** impressão dos resultados **/
printf("Na sequencia de %d numeros temos:\n",N);
printf(" - Numeros positivos: %d\n",positivos);
printf(" - Numeros negativos: %d\n",negativos);
printf(" - Numeros nulos: %d\n",nulos);
}