Codigo C - Questao de estética e praticidade
Enviado: 02 Ago 2009 18:30Prezados
Normalmente eu uso a declaração da função depois do cabeçalho comentado. Entretanto, com as IDE's com os recuros de collapse/expand, para efeito prático, os comentários ficariam melhor depois da declaração da função e antes de abrir a chave de função. Voce esconde todo o codigo e fica só a declaração da função, melhorando o andar da carruagem para as funções resolvidas....
...só fica meio estranho a estética do código com
tipo
funcao(tipo par)
/****.......
...
****/
{
//codigo
....
}
mas para collapse fica legal
tipo
funcao(tipo par)
(+)... <-- indica o bagulho em collapse
E ae ... sei que cada um tem um gosto, mas eh sempre bom ter a opiniao dos amigos....
[/code]
- Código: Selecionar todos
/*******************************************************************************
* Function
se95_read_device
* Input Parameters
addr - register address
*msg - device struct pointer
* Return
ever true
* Description
description
* Revision
1.0
* Date
30/07/2009
* Author
Jean P. Fernandes
* History
Initial version
*******************************************************************************/
u08
se95_read_device(u08 addr, t_se95 *msg)
{
data u08 task = 1;
data u08 check = TRUE;
data u08 value = 0;
data u16 temp = 0;
msg->error = TRUE;
msg->neg = FALSE;
msg->value = 0x0000;
check = TRUE;
while ((check == TRUE) && (task < 9))
{
switch (task)
{
case 1: // start condition
check = se95_start();
task++;
break;
case 2: // send device write addr
check = se95_write_byte(SE95_ADDR_WR);
task++;
break;
case 3: // send temp reg addr
check = se95_write_byte(addr);
task++;
break;
case 4: // start condition
se95_start();
task++;
break;
case 5: // send device read addr
check = se95_write_byte(SE95_ADDR_RD);
task++;
break;
case 6: // read the msb byte
value = se95_read_byte(SE95_ACK);
temp = (u16)value << 8;
task++;
break;
case 7: // read the lsb byte
value = se95_read_byte(SE95_NAK);
temp &= 0xFF00;
temp += value;
task++;
break;
case 8: // stop condition
msg->value = temp;
check = se95_stop();
task++;
break;
}
}
msg->error = (1 - check);
msg->neg = task;
SE95_SCL_ON;
SE95_SDA_ON;
return TRUE;
}
Normalmente eu uso a declaração da função depois do cabeçalho comentado. Entretanto, com as IDE's com os recuros de collapse/expand, para efeito prático, os comentários ficariam melhor depois da declaração da função e antes de abrir a chave de função. Voce esconde todo o codigo e fica só a declaração da função, melhorando o andar da carruagem para as funções resolvidas....
...só fica meio estranho a estética do código com
tipo
funcao(tipo par)
/****.......
...
****/
{
//codigo
....
}
mas para collapse fica legal
tipo
funcao(tipo par)
(+)... <-- indica o bagulho em collapse
E ae ... sei que cada um tem um gosto, mas eh sempre bom ter a opiniao dos amigos....
[/code]
