Beschreibung | Name eines Import-Zeichensatzes bestimmen |
Aufruf C | short nr;
char *name; name = (kt->GetImpNameFromNr)(nr); |
Aufruf Pascal | nr : Integer;
name : Pointer; name := kt^.GetImpNameFromNr(nil, nil, 0, 0, 0, nr); |
Aufruf GFA | kt_func% = {kt_struc%+52}
name% = C:kt_func%(nr&) |
Die Funktion GetImpNameFromNr liefert den (langen) Namen eines Import-Zeichensatzes als C-String. Der zurückgelieferte String ist incl. Null-Byte am Ende maximal 38 Zeichen lang.
Falls sich die übergebene Nummer 'nr' nicht im Bereich GetExpMinNr() .. GetImpMaxNr() bewegt, wird ein Leerstring zurückgegeben.
Die Funktion GetImpNameFromNr ist in Pascal in allen KEYTAB-Versionen verfügbar und in C nur dann, wenn size>=56 ist.
Hinweis: Da Pascal cdecl nicht kennt, wurde bei den Routinen GetExpNameFromNr und GetImpNameFromNr bis einschl. Release 04 der Zeiger in a0 zurückgegeben, was eine Verwendung mit C so gut wie unmöglich gemacht hat. Die Funktionen sind in der Schnittstelle für Pascal und für C unterschiedlich benannt. Pascal verwendet die "alten Funktionen", während C die "neuen Funktionen" benutzt. Intern werden die Pascal-Funktionen auf die C-Funktionen abgebildet. Durch die unterschiedliche Namensgebung soll jede Programmier-Sprache optimal KEYTAB benutzen können.