Coding Style für µC Programmierung in C

[Strahlex (Gast)]

Hallo Leute,

Ich bin gerade am überlegen wie ich Funktions und Variablennamen in 
meinem Code am besten gestalte. Ich habe bereits viel Erfahrung in der 
Desktop Programmierung mit Qt und mich bis jetzt auch an die Coding 
Conventions gehalten. Das Problem: C-Code kann man leider nicht 100% 
gleich bennen wie C++ Code. Deshalb habe ich ein paar Ideen gesammelt:

"Normaler" C Style:

delay_ms();
timer_init();
timer_set_clk();

Meiner Meinung nach ziemlich hässlich und unpraktisch.

CamelCase:

delayMs();
timerInitialize() oder initializeTimer()?
timerSetClock() oder setTimerClock()?

So hab ichs bisher gemacht. Man kommt aber schnell drauf das man 
Funktionen im rechten Style schwer findet und im Linken wirds 
unleserlich.

Hybrid Style:

delayMs();
Timer_initialize();
Timer_setClock();

Kommt schon sehr nahe an den Qt-Style heran (Timer::initialize()). 
Globale Funktionen mit <Bibliotheknamen>_ und privates ganz Normal.


So jetzt meine Frage, wie "Styled" ihr euren Code?

[Sauger (Gast)]

Mabend,

Strahlex schrieb:
> So jetzt meine Frage, wie "Styled" ihr euren Code?

aussagekräftig, Geschmacksache zählt nicht.

MfG

[Lukas K. (carrotindustries)]

Strahlex schrieb:
> So jetzt meine Frage, wie "Styled" ihr euren Code?

Wie in deinem ersten Beispiel. Was daran hässlich und unpraktisch sein 
soll, mag sich mir nicht erschließen.

[Stefan W. (swessels)]

So, das ich ihn lesen kann ;-)

Ich denke jeder macht das so wie er am besten damit klar kommt. Ich zum 
Beispiel so:

#ifdef MSB
void sr_byte_out(uint8_t byte)
{
  uint8_t i;
  for (i = 0; i < 8; i++)
  {
    if(byte & 0x80) SD_HI();
    SCL_HI();
    SR_DELAY();
    SCL_LO();
    SD_LO();
    byte <<= 1;
  }
}
#else
void sr_byte_out(uint8_t byte)
{
  uint8_t i;
  for (i = 0; i < 8; i++)
  {
    if(byte & 0x01) SD_HI();
    SCL_HI();
    SR_DELAY();
    SCL_LO();
    SD_LO();
    byte >>= 1;
    
  }
}
#endif //MSB

Gruß,
Stefan

[Rolf M. (rmagnus)]

Strahlex schrieb:
> "Normaler" C Style:delay_ms();
> timer_init();
> timer_set_clk();
> Meiner Meinung nach ziemlich hässlich und unpraktisch.

Warum unpraktisch? Ob er hässlich ist oder nicht, ist zu 100% 
subjektives Empfinden. Also mach es so, wie du es "schöner" findest, 
wenn dir kein objektives Kriterium für das eine oder andere einfällt.

> CamelCase:
> delayMs();
> timerInitialize() oder initializeTimer()?
> timerSetClock() oder setTimerClock()?
> So hab ichs bisher gemacht. Man kommt aber schnell drauf das man
> Funktionen im rechten Style schwer findet und im Linken wirds
> unleserlich.

Was ist daran unleserlich? Ich statte die Funktionen immer mit einem 
Präfix aus, der das Modul benennt, zu dem sie gehören. Also fangen alle 
Funktionen, die sich um den Timer kümmern, eben mit "timer_" an.

Sauger schrieb:
> Mabend,
>
> Strahlex schrieb:
>> So jetzt meine Frage, wie "Styled" ihr euren Code?
>
> aussagekräftig, Geschmacksache zählt nicht.

Das meiste davon ist aber nun mal Geschmackssache. Auch was 
aussagekräftig ist und was nicht, hängt oft vom persönlichen Geschmack 
ab.

[Karol B. (johnpatcher)]

Das geht doch sehr in die gleiche Richtung wie dieser Thread: 
Beitrag "Wie setzt ihr Klammern?"