Ein Verzeichnis von im Forum oft gestellten und immer wieder beantworteten Fragen und den zugehörigen Antworten:

[bearbeiten] Wie kann ich Zahlen auf LCD/UART ausgeben?

Aber die Bibliothek, die Sie benutzen, stellt nur eine Funktion zur Verfügung, mit der man einen String ausgeben kann... Was tun?

In den folgenden Beispielen wird eine selbstgeschriebene Funktion zur Stringausgabe auf LCD - die Funktion lcd_string() - aus dem LCD-Teil des AVR-GCC-Tutorials verwendet:

lcd_string( "Hallo Welt" );  // ggf. auch lcd_out() o.ä. in anderen Libraries 

Um also eine Zahl (numerische Konstante oder Variableninhalt) auszugeben, muss von dieser Zahl zunächst ihre String-Repräsentierung ermittelt werden. Dazu gibt es mehrere Möglichkeiten:

[bearbeiten] itoa()

itoa() ist keine C-Standardfunktion (wohl aber ihre Umkehrung atoi() ). Auf manchen Compilern heisst diese Funktion dann folgerichtig _itoa(), wobei der führende _ eben anzeigt, dass es sich um eine Erweiterung des C-Standards handelt. Bei WinAVR ist itoa() Bestandteil der mitgelieferten Library avr-libc.

  int i = 25;
 
  char Buffer[20];
  itoa( i, Buffer, 10 );
  lcd_string( Buffer ); // ggf. auch lcd_out() o.ä. in anderen Libraries 

itoa( i, Buffer, 10 ); - Die Zahl i wird nach ASCII gewandelt und die String Repräsentierung davon wird in Buffer abgelegt. Die Basis, in der diese Wandlung erfolgt, ist das 10-er System.

Wichtig ist, darauf zu achten, dass das Array Buffer groß genug dimensioniert wird, um alle Zeichen der Textrepräsentierung der Zahl aufzunehmen.

[bearbeiten] sprintf()

  int i = 25;
 
  char Buffer[20];
  sprintf( Buffer, "%d", i );
  lcd_string( Buffer ); // ggf. auch lcd_out() o.ä. in anderen Libraries 

Diese Methode funktioniert auch bei long oder float Werten. Unbedingt beachtet werden muss allerdings, dass die Typkennzeichnungen im sog. Format-String (hier "%d") mit den tatsächlichen Typen der auszugebenden Werten übereinstimmt. Und dass der Buffer, der den Text aufnimmt, auch groß genug dimensioniert wird.

Mit sprintf() hat man dieselben Möglichkeiten zur Formatierung wie bei printf() (siehe unten). Insbesondere gibt es natürlich die Möglichkeit die Zahl gleich in einen umgebenden Text einzubetten bzw. Formatierungen anzugeben:

  int i = 25;
 
  char Buffer[20];
  sprintf( Buffer, "Anzahl: %d Stueck", i );
  lcd_out( Buffer );

Der "Haken" an der mächtigen Funktion sprintf() ist, daß sie auch bei minimalisierter Konfiguration verhältnismäßig viel Programmspeicher (Flash-ROM) belegt und relativ viel Prozesszeit benötigt. Daher sollte man sprintf() nur verwenden, wenn kein Speicher- und Prozesszeitmangel besteht. Sonst sollte itoa() oder eine eigene, auf die Bedürfnisse optimierte Implementierung auf jeden Fall vorgezogen werden.

[bearbeiten] Formatierungen mit printf

Für jedes auszugebende Argument muss es im Formatstring einen entsprechenden Formatbezeichner geben. Der Aufbau eines Formatbezeichners ist immer

 %[Modifizierer][Feldbreite][.Präzision]Typ

Typ ist dabei eine Kennung, der mit dem Datentyp des jeweiligen auszugebenden Argumentes übereinstimmen muss. Einige oft benutzte Kennungen, ohne Anspruch auf Vollständigkeit, sind:

 c    char
 d    int
 f    float, double
 ld   long
 u    unsigned int
 lu   unsigned long
 p    pointer
 s    string

Die Feldbreite gibt die Breite des Ausgabefeldes an, in die die Ausgabe durchgeführt werden soll. Reicht die angegebene Feldbreite nicht aus, so vergrößert printf diese Breite eigenmächtig. Die Feldbreite muß nicht angegeben werden. In diesem Fall bestimmt printf selbst die Feldbreite, so dass die Ausgabe darin Platz findet.

Der Modifizierer bestimmt, wie und womit nicht benutzte Felder des Ausgabefeldes gefüllt werden sollen, wie die Ausrichtung innerhalb des Feldes erfolgen soll und ob ein Vorzeichen auch dann ausgegeben werden soll wenn die auszugebende Zahl positiv ist. Wird kein Modifizierer angegeben, so werden nicht benutzte Felder mit einem Leerzeichen gefüllt, positive Vorzeichen unterdrückt und die Ausgabe im Feld rechts ausgerichtet.

 +    Vorzeichen wird immer ausgegeben
 -    Die Ausgabe wird im Ausgabefeld linksbündig ausgerichtet
 0    anstelle von Leerzeichen werden führende 0-en ausgegeben

Die Präzision kommt nur bei float oder double Zahlen zum Einsatz. Sie legt fest, wieviele Positionen der kompletten Feldbreite für die Ausgabe von Nachkommastellen reserviert werden sollen. Auch sie muss wiederrum nicht angegeben werden und printf benutzt in so einem Fall Standardvorgaben.

[bearbeiten] Beispiele

• "%d" Ausgabe eines Integer
• "%5d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite
• "%05d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite, wobei das Feld links mit führenden Nullen auf 5 Zeichen aufgefüllt wird
• "%-5d" Ausgabe eines Integer in einem Feld mit 5 Zeichen Breite. Die Zahl wird linksbündig in das Feld gestellt.

[bearbeiten] Eigene Umwandlungsfunktionen

Möchte man itoa() nicht benutzen oder hat es gar auf seinem System nicht zur Verfügung, dann ist es auch nicht schwer, sich selbst eine Funktion dafür zu schreiben:

void ItoA( int z, char* Buffer )
{
  int i = 0;
  int j;
  char tmp;
  
  unsigned u; // In u bearbeiten wir den Absolutbetrag von z.
  
    // ist die Zahl negativ?
    // gleich mal ein - hinterlassen und die Zahl positiv machen
    if( z < 0 ) {
      Buffer[0] = '-';
      Buffer++;
      // -INT_MIN ist idR. größer als INT_MAX und nicht mehr 
      // als int darstellbar! Man muss daher bei der Bildung 
      // des Absolutbetrages aufpassen.
      u=((unsigned)-(z+1))+1; 
    }
    else { 
      u=(unsigned)z;
    }
    // die einzelnen Stellen der Zahl berechnen
    do {
      Buffer[i++] = '0' + u % 10;
      u /= 10;
    } while(u>0);
     // den String in sich spiegeln
    for( j = 0; j < i / 2; ++j ) {
      tmp = Buffer[j];
      Buffer[j] = Buffer[i-j-1];
      Buffer[i-j-1] = tmp;
    }
    Buffer[i] = '\0';
}

Das Grundprinzip ist einfach:
Die Ermittlung der einzelnen Stellen erfolgt in der zentralen Schleife

    do {
      Buffer[i++] = '0' + u % 10;
      u /= 10;
    } while(u>0);

durch fortgesetzte Division durch 10. Nur leider erhält man dadurch die einzelnen Ziffern der Zahl in umgekehrter Reihenfolge im String. Dies ist aber kein Problem, die nachfolgende Schleife

  for( j = 0; j < i / 2; ++j ) {
    tmp = Buffer[j];
    Buffer[j] = Buffer[i-j-1];
    Buffer[i-j-1] = tmp;
  }

spiegelt den String in sich, sodass danach der String eine korrekte Repräsentierung der ursprünglichen Zahl darstellt. Der Funktionsteil vor der 'Zerlegeschleife' behandelt den Sonderfall daß die Zahl 0 ist bzw. negative Zahlen. Negative Zahlen werden behandelt indem im Endergebnis ein '-' vermerkt wird und danach die Zahl positiv gemacht wird.

Siehe auch:

• Forenbeitrag Integer-Zahl in String mit bestimmter Zeichenlänge
• Forenbeitrag (Resourcenschonend) Wert einer Variable am LCD ausgeben von Niels Hüsken
• Festkommaarithmetik

[bearbeiten] Aktivieren der Floating Point Version von sprintf beim WinAVR mit AVR-Studio

Beim WinAVR/AVR-Studio wird standardmässig eine Version der printf-Bibliothek verwendet, die keine Floating Point Verarbeitung unterstützt. Die meisten Programme benötigen keine Floating Point Unterstützung, sodass hier wertvoller Programmspeicherplatz gespart werden kann.

Benutzt man dann allerdings eine printf Variante für die Ausgabe von Floating Point Zahlen, so erscheint an Stelle der korrekt formatierten Zahl lediglich ein '?'. Dies ist ein Indiz, dass die Floating Point Verarbeitung im Projekt aktiviert werden muss.

Um die Floating Point Verarbeitung zu aktivieren, geht man im AVR-Studio wie folgt vor: Menüpunkt: "Project"/"Configuration Options"

Im sich öffnenden Dialog wird in der linken Navigationsleiste der Eintrag "Libraries" ausgewählt. Unter 'Available Link Objects' werden alle möglichen Bibliotheken angeboten. Für die Aktivierung der Floating Point Unterstützung sind 2 interessant:

• libprintf_flt.a
• libm.a

Beide Bibliotheken werden durch aktivieren und einen Druck auf "Add Library -->" in die rechte Spalte übernommen.

Danach wählt man in der Navigationsleiste den Eintrag "Custom Options". Unter 'Custom Compilation Options' wird '[Linker Options]' ausgewählt und in das Textfeld rechts/unten wird der Text -Wl,-u,vfprintf eingegeben. Ein Druck auf "Add" befördert die Zeile in das Listenfeld darüber, welches die Kommandos an den Linker enthält.

Damit ist die Konfiguration abgeschlossen, "OK"

[bearbeiten] Wie funktioniert String-Verarbeitung in C?

In C gibt es, anders als in anderen Programmiersprachen, keinen eigenen String-Datentyp. Als Ersatz dafür werden Character-Arrays benutzt, in denen die einzelnen Character (=Zeichen) gespeichert werden. Allerdings gibt es noch einen Zusatz: Das letzte Zeichen eines Strings ist immer ein '\0'-Zeichen, dass das Ende des Strings markiert. Schlieslich kann ja das Array wesentlich größer sein, als der in ihm gespeicherte String und irgendwie müssen ja diverse Funktionen das tatsächliche Ende eines Strings erkennen können.

Möchte mal also die Zeichenkette "Hello World" in einem String speichern, so wird dafür ein Array mit mindestens der Länge 12 benötigt. 11 für die Zeichen die "Hello World" bilden, plus eine zusätzliche Position für das abschliesende '\0'-Zeichen.

Da Strings in char-Arrays gespeichert werden, können selbstverständlich normale Array Operationen dafür benutzt werden:

  char Test[12];
 
  Test[0] = 'H';
  Test[1] = 'a';
  Test[2] = 'l';
  Test[3] = 'l';
  Test[4] = 'o';
  Test[5] = ' ';
  Test[6] = 'W';
  Test[7] = 'o';
  Test[8] = 'r';
  Test[9] = 'l';
  Test[10] = 'd';
  Test[11] = '\0';   // das abschliessende \0 nicht vergessen! Sonst ist
                     // das kein String! 

[bearbeiten] Einige Stringfunktionen

Arrays sind in C keine vollwertigen Datentypen, z.B. ist es nicht möglich einem Array in einem Rutsch ein anderes Array zuzuweisen oder 2 Arrays miteinander zu vergleichen. Genau das möchte man aber in der Stringverarbeitung häufig, sodass es dafür Standardfunktionen gibt, die allesamt im Headerfile "string.h" zusammengefasst sind und deren Namen alle mit str... beginnen. Allen diesen Funktionen gemeinsam ist, dass sie sich nicht um die korrekte Bereitstellung von Arrays kümmern, sondern davon ausgehen, dass dies vom Programmierer korrekt erledigt wird.

[bearbeiten] strcpy( char* dest, const char* src )

Kopieren eines Strings von der Speicherfläche auf die src zeigt, zur Speicherfläche, auf die dest zeigt.

  char Ziel1[20];
  char Ziel2[20];
 
  strcpy( Ziel1, "Hallo Welt" );
  strcpy( Ziel2, Ziel1 );

[bearbeiten] strcat( char* dest, const char* src )

Anhängen eines Strings an einen bestehenden String.

  char Ziel[20];
  char Temp[20];
 
  strcpy( Ziel, "Hallo " );    // Ziel enthält jetzt den String "Hallo "
  strcat( Ziel, "Welt" );      // Ziel enthält jetzt den String "Hallo Welt"
 
  strcpy( Temp, " !" );
  strcat( Ziel, Temp );        // Ziel enthält jetzt den String "Hallo Welt !" 

[bearbeiten] strcmp( const char* str1, const char* str2 )

Vergleichen 2-er Strings. Das Ergebnis ist 0, wenn die beiden Strings identisch sind.

[bearbeiten] strlen( const char* str )

Die Länge eines Strings feststellen. Die Länge beinhaltet nicht das abschliessende '\0' Zeichen.

Unter 'Länge' wird hier die tatsächliche Länge des Strings (also die Anzahl der im String gespeicherten Zeichen) verstanden und nicht die 'Länge' des Arrays in dem der String gespeichert ist. Wird der Text "test" in einem char-Array der Größe 20 gespeichert, so lautet das Ergebnis von strlen() 4 und nicht etwa 20

  char string[20];
  strcpy( string, "test" );
  i = strlen( string );      // i bekommt hier den Wert 4 

[bearbeiten] Beispiele

#include "string.h"
 
int main()
{
  char Meldung[14];
  strcpy( Meldung, "Hello World" );
}

Mittels der Definition

  char Meldung[14];

wird ein Array bereitgestellt, welches maximal 14 Zeichen aufnehmen kann. Hello World verbraucht für die lesbaren Zeichen 11 Array-Positionen, dazu noch das obligatorische abschliessende '\0' Zeichen, macht in Summe 12 Positionen. Eine Definition von 14 Zeichen ist also mehr als minimal notwendig wäre. Das macht aber nichts, da durch das abschliessende '\0' Zeichen immer feststellbar ist, an welcher Stelle der tatsächliche String zu Ende ist. Die restlichen 2 Array-Positionen sind zur Zeit halt einfach unbenutzt. strcpy() kopiert den 2.ten angegebenen String an die Position auf die sein erstes Argument zeigt. Im obigen Beispiel zeigt das 1.te Argument auf den Beginn von Meldung, also auf das Array. Folgerichtig wird der String "Hello World" in das Array Meldung umkopiert. Nach Ausführung der strcpy() Funktion enthält also Meldung den Inhalt:

    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    | H | e | l | l | o |   | W | o | r | l | d | \0|   |   |
    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    

Möchte man an diesen Text jetzt noch etwas anfügen, z.B. ein "?", so würde das so aussehen:

#include "string.h"
 
int main()
{
  char Meldung[14];
  strcpy( Meldung, "Hello World" );
  strcat( Meldung, "?" );
}

Man beachte: auch wenn hier scheinbar nur ein einzelnes Zeichen angehängt wird, so handelt es sich doch um einen String. Strings werden in C immer mit einem " eingeleitet und abgeschlossen. Im Gegensatz zu einzelnen Zeichen, die in einfache ' eingefasst werden. "?" ist also nicht dasselbe wie '?'! Das erste ist ein String (der mit dem obligatorischen '\0' Zeichen insgesamt aus 2 Zeichen besteht), während letzteres ein einzelnes Zeichen darstellt! Die meisten str... Funktionen arbeiten nur mit Strings!

Da Meldung maximal 14 Zeichen umfassen kann, der Text "Hello World?" aber nur aus 13 Zeichen besteht, funktioniert Obiges auch ohne Probleme. Der Array-Inhalt sieht dann wie folgt aus:

    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    | H | e | l | l | o |   | W | o | r | l | d | ? | \0|   |
    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Ein schwerwiegender Fehler wäre es, wenn der komplette String nach dem strcat() aus mehr als 14 Zeichen (das '\0'-Zeichen nicht vergessen!) bestehen würde.

#include "string.h"
 
int main()
{
  char Meldung[14];
  strcpy( Meldung, "Hello World" );
  strcat( Meldung, " von mir" );
}

würde also das Array überlaufen lassen.

    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+
    | H | e | l | l | o |   | W | o | r | l | d |   | v | o | n       m   i   r   \0
    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+

Man sieht sehr schön, daß in diesem Fall die weiteren Zeichen einfach an die Folgepositionen im Speicher geschrieben werden und dadurch ungewollt Speicher verändern, der nicht zu Meldung gehört. Abhängig von den Details des Programmes können aber an dieser Stelle im Speicher z.B. ganz andere Variablen liegen, die dann verändert werden. strcpy(), strcat() oder alle anderen String-Funktionen können den Programmierer gegen diesen Fall nicht schützen! Dazu müssten sie die Größe des Speicherbereichs kennen, was sie nicht tun. Es obliegt einzig und alleine der Sorgfalt des Programmierers, das Programm gegen solche Fälle abzusichern! Seit einiger Zeit wurde das Sammelsurium der str... Funktionen durch Varianten ergänzt, die dieses Manko beheben. Diesen Funktionen muß die Größe des Zielbereiches mitgegeben werden. Dadurch werden die Funktionen in die Lage versetzt, zu überprüfen ob sie den Zielbereich überlaufen würden und entsprechend zu reagieren. Diese Funktionen heißen grundsätzlich gleich wie die str... Funktionen, nur befindet sich ein kleines 'n' im Funktionsnamen. Aus strcpy wird so strncpy, aus strcat wird strncat usw. Für Details dazu sei auf Literatur oder Web-Recherche verwiesen. Auch wenn einen diese Funktionen gegen die gefürchteten Array-Overflows schützen können, so muß man sich trotzem klarmachen, daß dieser Schutz nur die halbe Miete ist. Denn was soll strncpy denn tun, wenn der zu kopierende String nicht in das Zielarray passt? strncpy kopiert soviel wie es kann und gibt dann auf. Aber: Dadurch ist der String aber nicht zur Gänze in den Zielbereich kopiert worden. Programmteile die darauf angewiesen sind, daß der String vollständig kopiert wurde, werden dann nicht mehr oder nicht richtig funktionieren usw. Auch wenn die strn... Funktionen eine gewisse Abhilfe bringen und zumindest den Absturz eines Programmes verhindern können, stellen sie dennoch keine Allheilmittel dar. Um die korrekte Abschätzung der benötigten Arraygrößen kommt man nicht umhin.

strlen() liefert die Länge eines Strings. Die Längenangabe beinhaltet dabei nicht das abschliessende '\0' Zeichen:

#include "string.h"
 
int main()
{
  char Meldung[14];
  int  Len;
  
  strcpy( Meldung, "Hello World" );
  Len = strlen( Meldung );
  
  /* Hier enthaelt Len den Wert 11 */
 
  Len = strlen( "Hallo Welt" );
 
  /* Hier enthält Len den Wert 10 */
}

strcmp() schlussendlich vergleicht 2 Strings auf Gleichheit. Der Rückgabewert spiegelt dabei die Position des ersten Unterschiedes in den beiden Strings wieder. Folgerichtig sagt ein Wert von 0 daher aus, dass die beiden Strings identisch sind:

#include "string.h"
 
 
int main()
{
  char Meldung1[14];
  char Meldung2[14];
 
  strcpy( Meldung1, "Hello World" );
  strcpy( Meldung2, "Hallo Welt" );
 
  if( strcmp( Meldung1, Meldung2 ) == 0 ) {
    /* die Strings sind identisch */
  }
  else {
    /* die Strings sind nicht identisch */
  }
  
  if( strcmp( Meldung2, "Hallo Welt" ) == 0 ) {
    /* Meldung2 war "Hallo Welt" */
  }
}

Es gibt noch weitere String-Funktionen, dafür sei aber auf die Verwendung der zum Compiler gehörenden Dokumentation bzw. auf einführende Literatur zum Thema 'Programmieren in C' verwiesen.

[bearbeiten] Funktionszeiger

Um Menüs oder ähnliche Dinge aufzubauen ist es oft praktisch ein Array von Funktionszeigern zu definieren. Der Aufruf einer Funktion kann dann indirekt über eine Variable erfolgen, wobei die Variable die Adresse der aufzurufenden Funktion enthält.

Um mit Funktionszeigern zu arbeiten ist es in der Praxis sinnvoll sich einen typedef für den Typ des Funktionszeigers zu definieren. Ein typedef definiert einen neuen (kürzeren) Namen für einen Datentyp. Und wie wir sehen werden, ist der Datentyp eines Funktionszeigers in der Schreibweise ganz schön umfangreich.

[bearbeiten] typedef

Einen typedef zu definieren ist eigentlich ganz einfach: Man schreibt die Deklaration so, als ob man eine Variable definieren würde. Vor das ganze Konstrukt kommt das Schlüsselwort typedef. Es bewirkt, dass der Name an der Position des Variablennamens zum Namen für den neuen Datentyp wird, der dann in weiterer Folge wie jeder andere Datentyp benutzt werden kann.

Wir wollen einen Funktionszeiger auf eine Funktion definieren, die keine Argumente entgegen nimmt und auch nichts liefert. Also Funktionen nach dem Muster:

void foo( void )
{
}

Ein entsprechender typedef würde zB so aussehen:

typedef void (*VoidFnct)( void );

Das vereinbart einen neuen Datentyp VoidFnct. Dieser ist ein Funktionszeiger auf Funktionen, die keine Argumente nehmen und auch nichts zurückliefern.

typedef int (*IntFnct)( void );
typedef int (*IntFnct2)( int );

IntFnct ist ein Zeiger auf eine Funktion, die keine Argumente nimmt aber einen int zurückliefert. IntFnct2 hingegen ist ein Zeiger auf eine Funktion, die einen int als Argument nimmt und einen int zurückliefert. Andere Argumenttypen bzw. Rückgabetypen folgen dem gleichen Muster. Wichtig ist, dass sowohl Argumenttypen als auch Rückgabetypen Teil der Signatur eines Funktionszeigers ist. Es ist also nicht möglich einen Funktionszeigertyp zu vereinbaren, der auf beliebige Funktionen mit beliebigen Argumenttypen bzw. Rückgabetypen verweist. Hier muss man ev. auf einen cast ausweichen. Generell ist das aber meist keine gute Idee.

[bearbeiten] Funktionszeigertabellen

Mit einem typedef ist es nun ein leichtes ein Array von Funktionszeigern zu vereinbaren:

typedef void (*VoidFnct)( void );
 
VoidFnct MeineFunktionen[5];

Dies vereinbart MeineFunktionen als ein Array von Funktionszeigern, wobei jeder Funktionszeiger auf eine Funktion vom Typ void-void zeigt.

typedef void (*VoidFnct)( void );
 
void Funct1()
{
  printf( "Dies ist Funktion 1\n" );
}
 
void Funct2()
{
  printf( "Dies ist Funktion 2\n" );
}
 
VoidFnct MeineFunktionen[] = { Funct1, Funct2 };
 
int main()
{
  //
  // ruft die Funktion auf, deren Adresse in MeineFunktionen[0]
  // steht. In diesem Fall wäre das Funct1()
  //
  MeineFunktionen[0]();
 
  //
  // und jetzt die MeineFunktionen[1]
  //
  MeineFunktionen[1]();
 
  //
  // jetzt wird MeineFunktionen[0] umgeleitet auf Funct2()
  // Achtung: Auf der rechten Seite wird kein () angegeben.
  // Ansonsten würde ja die Funktione Funct2 aufgerufen. Wir
  // wollen aber nur ihre Speicheradresse haben! Daher unterbleibt
  // das ()
  //
  MeineFunktionen[0] = Funct2;
 
  //
  // welche Funktion wird jetzt aufgerufen?
  //
  MeineFunktionen[0]();
  // Richtig: Die Funktion, deren Adresse in MeineFunktionen[0]
  //          steht. Und das ist jetzt Funct2.
}

[bearbeiten] Menüs mit Funktionszeigern

Besonders bei Menüs ist es oft hilfreich, sich eine Struktur bestehend aus dem Menütext und der aufzurufenden Funktion zu definieren

typedef void (*VoidFnct)( void );
 
struct MenuEntry {
  char     Text[20];
  VoidFnct Function;
};

Ein Menü ist dann einfach ein Array aus derartigen Strukturelementen

void HandleEdit()
{
}
 
void HandleCopy()
{
}
 
void HandlePaste()
{
}
 
struct MenuEntry MainMenu[] = {
 { "Edit", HandleEdit },
 { "Copy", HandleCopy },
 { "Paste", HandlePaste }
};
 
#define ARRAY_SIZE(X) ( sizeof(X) / sizeof(*(X)) )
 
 
void DoMenu( int NrEntries, struct MenuEntry[] Menu )
{
  int i;
  int Auswahl;
  
  do {
    //
    // Das Menue anzeigen. Für jeden Menuepunkt noch eine Zahl
    // davor stellen, damit der Benutzer auch was zum Eingeben hat
    //
    for( i = 0; i < NrEntries; ++i )
      printf( "%d) %s\n", i + 1, Menu[i].Text ); 
 
    printf( "9) Exit\n\n" );
 
    // 
    // Jetzt die Benutzereingabe abwarten ...
    //
    printf( "Ihre Eingabe: " );
    scanf( "%d", &Auswahl );
 
    //
    // ... und auswerten
    //
    if( Auswahl == 9 )
      return;
 
    Auswahl = Auswahl - 1;
    if( Auswahl < 0 || Auswahl > NrEntries )
      printf( "Ungültige Eingabe\n" );
 
    else
      // Die Eingabe war gültig. Zugehörige Funktion aufrufen
      Menu[Auswahl].Function();
  }
}
 
int main()
{
  // Das Menü arbeiten lassen.
  // Die Funktion DoMenu ruft selbsttätig die zu den jeweiligen
  // Menüpunkten gehörenden Funktionen auf. DoMenu kommt erst
  // dann wieder zurück, wenn der Benutzer den Menüpunkt
  // 9) Exit
  // ausgewählt hat.
 
  DoMenu( ARRAY_SIZE( MainMenu ), MainMenu );
 
  while( 1 )
    ;
}

Auf einem Mikrocontroller wird man natürlich die Ein/Ausgabe nicht über printf/scanf abwickeln. Hier geht es aber um das Prinzip der Funktionszeiger und wie man mit ihnen arbeitet, daher wurde die allereinfachste Art der Benutzerinteraktion gewählt. Gegebenenfalls muss printf und scanf durch die Möglichkeiten auf dem konkreten System ersetzt werden. Auch ist die Art und Weise wie das Menü präsentiert bzw. die Benutzereingabe ausgewertet wird, nicht der Weisheit letzter Schluss. Anstatt den Benutzer Zahlen eingeben zu lassen, könnte man auch einen Auswahl-Balken vom Benutzer mit 2 Tasten über die Menüeinträge bewegen lassen. Oder einen Drehencoder nehmen, ...

[bearbeiten] Ich hab da mehrere *.c und *.h Dateien. Was mache ich damit?

Zunächst ist es wichtig, sich zu vergegenwärtigen wie denn der C Compiler/Linker überhaupt arbeitet. Ein komplettes Programmier-Projekt kann und wird im Normalfall aus mehreren Source Code Dateien bestehen die alle zusammengenommen das komplette Programm bilden.

Der Prozess des Erstellens des Programmes geschieht in mehrerern Schritten:

• zunächst werden alle Einzelteile (jede *.c Datei) für sich compiliert. Dabei ensteht für jede *.c Datei eine sog. Object-Datei in der bereits der Maschinencode für die im *.c programmierten Funktionen enthalten ist
• danach werden die einzelnen Object-Dateien zusammen mit zusätzlichen Bibliotheken zum fertigen Programm gelinkt.

Angenommen das komplette Projekt besteht aus 2 Dateien

Datei: main.c

int twice(int i);
 
int main()
{
  foo( 5 );
}

Datei: func.c

int twice( int number )
{
  return 2 * number;
}

dann werden main.c und func.c unabhängig voneinander compiliert. Als Ergebnis erhält man die Dateien main.o und func.o die den besagten Object-Code enthalten. Erst diese beiden Zwischenergebnisse werden dann zusammen mit eventuellen Bibliotheken zum fertigen Programm gebunden (gelinkt), das dann ausgeführt werden kann.

       +---------+                         +----------+
       | main.c  |                         | func.c   |
       +---------+                         +----------+
            |                                   |
            |                                   |
            v                                   v
        Compiler                            Compiler
            |                                   |
            |                                   |
            v                                   v
       +---------+                         +----------+
       | main.o  |                         | func.o   |
       +---------+                         +----------+
            |                                   |
            +-----------+   +-------------------+
                        |   |
                        v   v
                        Linker  <------ zus. Bibliotheken
                          |
                          v
                     +----------+
                     | fertiges |
                     | Programm |
                     +----------+

Bekommt man also von irgendwo bereits fertige *.c (und zugehörige *.h) Dateien, so genügt es, die *.c Dateien ganz einfach in das Projekt mit aufzunehmen. Daduch wird das entsprechende *.c File compiliert und das Ergebnis davon, das Object-file, wird dann in das fertige Programm mit eingelinkt.

Wie eine *.c Datei in das Projekt mit aufgenommen wird, hängt im wesentlichen von der benutzten Entwicklungsumgebung ab.

[bearbeiten] Makefile

Die zusätzliche *.c Datei wird in die SRC Zeile im makefile eingetragen.

[bearbeiten] AVR-Studio

Hier ist es besonders einfach eine Datei in das Projekt mit aufzunehmen. Dazu wird im Projektbaum einfach der Knoten "Source Files" aktiviert und mit der rechten Maustaste das Kontextmenü geöffnet. Im Menü wird der Punkt "Add existing Source File(s)" ausgewählt und anschliessend zeigt man AVR-Studio das zusätzliche *.c File. AVR-Studio berücksicht dann dieses File bei der Projekterzeugung, compiliert es und sorgt dafür, daß es zum fertigen Programm dazugelinkt wird.

[bearbeiten] Globale Variablen über mehrere Dateien

Ein häufige Problemkreis in der C Programmierung sind auch globale Variablen, die von mehreren *.c Dateien aus benutzt werden sollen. Was hat es damit auf sich?

Zunächst mal muß man bei der Vereinbarung von Variablen zwischen Definition und Deklaration unterscheiden. Worin besteht der Unterschied?

• Definition: Mit einer Definition wird der Compiler angewiesen eine Variable tatsächlich zu erzeugen. Damit er das kann, muß ihm selbstverständlich der exakte Datentyp und auch der Name der Variablen zur Verfügung stehen. Eine Definition sorgt also dafür, daß im späteren Programm Speicherplatz für diese Variable reserviert wird
• Deklaration: Mit einer Deklaration teilt man dem Compiler lediglich mit, dass eine Variable existiert. An dieser Stelle soll der Compiler also keinen Speicherplatz reservieren (das muß an anderer Stelle geschehen sein), sondern der Compiler soll einfach nur zur Kenntniss nehmen, daß es eine Variable mit einem bestimmten Namen gibt und von welchem Datentyp sie ist.

Aus obigem folgt sofort, dass eine Definition auch immer eine Deklaration ist. Denn dadurch daß der Compiler angewiesen wird eine Variable auch tatsächlich zu erzeugen folgt, dass er dazu auch dieselben Informationen benötigt, die auch in einer Deklaration angegeben werden müssen. Der einzige Unterschied: Bei einer Deklaration trägt der Compiler nur in seinen internen Tabellen ein, dass es diese Variable tatsächlich gibt, während er bei einer Definition zusätzlich auch noch dafür sorgt, dass im fertigen Programm auch noch Speicher für diese Variable bereitgestellt wird.

Warum ist diese Unterscheidung jetzt wichtig?

Weil es in C die sog. One Definition Rule oder kurz ODR gibt. Sie besagt, dass in einem vollständigem Programm, also über alle *.c Dateien gesehen, es für eine Variable nur eine Definition geben darf. Es darf allerdings beliebig viele Deklarationen geben, solange diese Deklarationen alle im Datentyp übereinstimmen. Kurz gesagt: Man darf den Compiler nur einmal auffordern eine Variable zu erzeugen (Definition), kann sich aber beliebig oft auf diese eine Variable beziehen (Deklarationen).

Woran erkennt man eine Definition bzw. Deklaration?

Eine Definition einer gloablen Variable steht immer ausserhalb eines Funktionsblocks. Zb.

int  MyData;         // Globale Variable namens MyData. Sie ist vom Typ int
char Name[30];       // Globales Array
long NrElements = 5; // Globale Variable, die auch noch initialisiert wird 

Eine Deklaration unterscheidet sich von einer Definition in 2 Punkten

• Es wird das Schlüsselwort extern vorangestellt.
• Es kann keine Initialisierung geben. Sobald eine Initialisierung vorhanden ist, wird das Schlüsselwort extern ignoriert und aus der Deklaration wird eine Definition.

Beispiele für Deklarationen

extern int  MyData;
extern char Name[30];
extern long NrElements;
extern long NrElements = 5;  // Achtung: Dies ist keine Deklaration! 

Besitzt man also 2 *.c Dateien, main.c und helpers.c, und sollen sich diese beiden Dateien eine globale Variable teilen, so muss in eine Datei eine Definition hinein, während in die andere Datei eine Deklaration derselben Variablen erfolgen muß. Traditionell werden die Definitionen in der Datei gemacht, die auch die main() Funktion enthält. Das muss nicht so sein, ist aber eine Konvention, die oft Sinn macht.

main.c

int  AnzahlElemente;
 
int main()
{
  AnzahlElemente = 8;
  ...
}

helpers.c

extern int AnzahlElemente;   // Dies ist die Deklaration die auf die globale
                             // Variable AnzahlElemente in main.c verweist.
                             // Wichtig: Der Datentyp muss mit dem in main.c
                             // angegebenen übereinstimmen
 
void foo()
{
   ...
  j = AnzahlElemente;
  AnzahlElemente = 9;
}

[bearbeiten] Praktische Durchführung

Besteht ein vollständiges Programm aus mehreren *.c Dateien, dann kan man sich vorstellen, daß es mühsam ist, alle Deklarationen immer auf gleich zu halten. Hier bietet sich der Einsatz eines Header Files an, in der die Deklarationen stehen und welches in die jeweiligen *.c Dateien inkludiert wird

Bsp:

Global.h

extern int Anzahl;

main.c

#include "Global.h"
 
int Anzahl;      // auch wenn Global.h inkludiert wurde, so muss es eine
                 // Definition der Variablen geben. In Global.h sind ja nur
                 // Deklarationen.
 
int main()
{
  ...
  Anzahl = 5;
}

foo.c

#include "Global.h"
 
void foo()
{
  ...
  Anzahl = 8;
  ...
}

bar.c

#include "Global.h"
 
void bar()
{
  ...
  j = Anzahl;
}

Auf diese Art kann man erreichen, dass zumindest alle Deklarationen ein und derselben Variablen in einem Programm übereinstimmen. Die Datei Global.h wird auch in main.c inkludiert, obwohl man das eigentlich nicht müsste, denn dort wird die Variable ja definiert. Durch die Inclusion ermöglicht man aber dem Compiler die Überprüfung ob die Deklaration auch tatsächlich mit der Definition übereinstimmt.