Node:Indications supplementaires, Previous:Presentation globale, Up:Top



Indications supplémentaires

En-têtes de documentation

Tous les fichiers source et fichier en-tête doivent débuter avec un en-tête de documentation, de la forme suivante :
/*
** <filename> for <project> in <part>
**
** Made by <author>
** Login   <login name@site>
**
** Started on  <date> <author>
** Last update <date> <author>
*/

Valeurs de retour

Les fonctions système et de la bibliothèque standard renvoient souvent des valeurs qui indiquent si l'opération a réussi ou non. Les cas d'erreur doivent être gérés, mais cette gestion ne doit pas "polluer" le code. On utilisera des fonctions personnalisées pour réaliser l'appel, comme celle-ci :
void    *xmalloc(size_t n)
{
  void  *p;

  p = malloc(n);
  if (p == 0)
  {
    fprintf(stderr, "Virtual memory exhausted.\n");
    exit(1);
  }
  return p;
}

Désactivation du code

Pour désactiver un bloc de code, il ne faut pas utiliser les commentaires. Il vaut mieux utiliser #if 0 et #endif. Attention, un projet rendu ne doit pas contenir de blocs de code désactivés (il faut les faire disparaître avant le rendu).