WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

Dispatch-Tabellen für Rückruffunktionen in C

Ordne Operationskennungen Funktionszeiger zu, rufe die gewählte Funktion indirekt auf und unterscheide ungültige Indizes von unbelegten Einträgen.

Version: ISO C23; implementation support may vary

Syntax

#include <stddef.h>

struct Process;
typedef void (*ProcessOp)(struct Process *, size_t);

enum { OP_ADD, OP_SHOW, OP_RESERVED, OP_COUNT };
static void add(struct Process *, size_t);
static void show(struct Process *, size_t);

static ProcessOp const ops[OP_COUNT] = {
    [OP_ADD] = add,
    [OP_SHOW] = &show,
    [OP_RESERVED] = NULL,
};

/* Inside a function with parameters id, p, and n: */
/* if (id >= 0 && id < OP_COUNT && ops[id] != NULL)
       ops[id](p, n); */

Eine Dispatch-Tabelle für Rückruffunktionen ordnet Operationskennungen Funktionszeiger zu. typedef void (*ProcessOp)(struct Process *, size_t); benennt den Typ eines Zeigers auf eine Funktion, die struct Process * und size_t entgegennimmt und keinen Wert zurückgibt (void). Ist der Struktur-Tag Process noch nicht sichtbar, deklariere zuerst struct Process; im selben Gültigkeitsbereich wie typedef, damit der Prototyp den richtigen Strukturtyp meint.

Im Initialisierer wird der Funktionsbezeichner add implizit in einen Zeiger auf die Funktion umgewandelt; &show ermittelt die Adresse ausdrücklich. Beide Funktionen müssen zum Funktionstyp kompatibel sein, auf den ProcessOp zeigt. Das schließt Rückgabe- und Parametertypen ein. op(p, n) und (*op)(p, n) sind gleichwertige indirekte Aufrufe. Eine Typumwandlung behebt keine Inkompatibilität: Ein solcher Aufruf hat undefiniertes Verhalten. ISO C garantiert nicht, dass sich Funktionszeiger portabel in void * speichern lassen.

Prüfe den Wertebereich von id, bevor du ops[id] liest, insbesondere bei Kennungen von außerhalb des Programms. Vergleiche den gelesenen Zeiger dann mit NULL, einem in <stddef.h> bereitgestellten Makro für eine Nullzeigerkonstante. Ein Nullzeiger im Eintrag steht hier für eine nicht unterstützte Operation; eine Kennung außerhalb des Bereichs ist ungültig. Sowohl das Lesen außerhalb des Arrays als auch der Aufruf über einen Nullzeiger haben undefiniertes Verhalten.

const verhindert Zuweisungen an die Tabelleneinträge, nicht Änderungen am über p übergebenen Objekt. Der Funktionszeiger enthält keinen Kontext: Übergib ihn separat und halte das Objekt so lange am Leben, wie die Rückruffunktion es verwendet. Das Muster ist in ISO C23 gültig und benötigt keine erst in C23 eingeführte Syntax; die C23-Unterstützung hängt von der Implementierung ab.

Beispiele

#include <stddef.h>
#include <stdio.h>

struct Process {
    size_t total;
};

typedef void (*ProcessOp)(struct Process *, size_t);

enum { OP_ADD, OP_SHOW, OP_RESERVED, OP_COUNT };
enum DispatchResult { DISPATCH_OK, DISPATCH_BAD_ID, DISPATCH_UNSUPPORTED };

static void add(struct Process *p, size_t n)
{
    p->total += n;
}

static void show(struct Process *p, size_t n)
{
    (void)n;
    printf("total=%zu\n", p->total);
}

static ProcessOp const ops[OP_COUNT] = {
    [OP_ADD] = add,
    [OP_SHOW] = &show,
    [OP_RESERVED] = NULL,
};

static enum DispatchResult dispatch(int id, struct Process *p, size_t n)
{
    if (id < 0 || id >= OP_COUNT) {
        return DISPATCH_BAD_ID;
    }

    ProcessOp op = ops[id];
    if (op == NULL) {
        return DISPATCH_UNSUPPORTED;
    }

    op(p, n);
    return DISPATCH_OK;
}

int main(void)
{
    struct Process p = { .total = 2 };
    if (dispatch(OP_ADD, &p, 3) != DISPATCH_OK ||
        dispatch(OP_SHOW, &p, 0) != DISPATCH_OK) {
        return 1;
    }
    if (dispatch(OP_RESERVED, &p, 0) == DISPATCH_UNSUPPORTED) {
        puts("unsupported operation");
    }
    if (dispatch(-1, &p, 0) == DISPATCH_BAD_ID) {
        puts("invalid operation id");
    }
    return 0;
}

Ergebnis

total=5
unsupported operation
invalid operation id

`OP_ADD` ändert `total` von 2 auf 5, und `OP_SHOW` gibt das Ergebnis aus. `OP_RESERVED` liegt im gültigen Bereich, enthält aber `NULL`; `-1` wird vor dem Tabellenzugriff abgewiesen.

Zugehörige Lektionen

  • C · Lektion 85 · Fortgeschritten · Version: 3

Quellen