Formatzeichenfolgen
Eine Formatzeichenfolge ist ein interpretiertes Token, das die NDR-Engine versteht. Formatzeichenfolgen werden häufig als MOPs bezeichnet. In dieser Dokumentation wird der Begriff Formatzeichenfolge verwendet.
Genauer gesagt ist ein Formatzeichen ein einzelnes (atomares) interpretierbares Token. Jedes Formatzeichen hat eine Größe von einem Byte. Eine Formatzeichenfolge ist eine Sequenz von Formatzeichen oder Formatzeichen und numerischen Daten. Der Begriff Deskriptor wird auch zum Benennen allgemeiner Sequenzen verwendet. Beispielsweise ist eine Parameterformatzeichenfolge oder ein Parameterdeskriptor eine Formatzeichenfolge, die verwendet wird, um einen Parameter einer Routine zu beschreiben.
Formatzeichen weisen suggestive symbolische Namen wie FC _ LONG oder FC _ STRUCT auf. Alle Formatzeichenfolgenzeichen, die von MIDL und der NDR-Engine verwendet werden, werden in der Datei Ndrtypes.h definiert.
Formatieren von Zeichenfolgentabellen
Die Engine verwendet zwei primäre Formatzeichenfolgentabellen: die Formatzeichenfolgentabelle der _ _ Prozedur, MIDL _ ProcFormatString, die die Prozedurdeskriptoren beibehält, und die Typformatzeichenfolgentabelle _ _ MIDL _ TypeFormatString, die die Datentypdeskriptoren beibehält. Der Compiler generiert beides in den Hauptstubdateien ( * _ c.c, * _ s.c, * _ p.c). Die Zeichenfolgentabelle im Prozedurformat wird größtenteils von verschiedenen Interpretern verwendet, aber sie wird auch für die Pufferkonvertierung verwendet, unabhängig vom Compilermodus. Die Formatzeichenfolgentabelle des Typs wird verwendet, wenn die NDR-Kern-Engine aufgerufen wird, um bestimmte Datentypen anzugeben, an denen gearbeitet werden soll.
Formatzeichenfolgen-Notation
Die in diesem Dokument verwendete Notation folgt allgemeinen Programmierbeschreibungsrichtlinien, wobei ein Balken ( | ) verwendet wird, um alternative Konstrukte und eckige Klammern ( [ ] ) anzugeben, die zum Angeben optionaler Elemente verwendet werden. Formatzeichenfolgen werden aus Gründen der Lesbarkeit (Verantwortlichkeit) häufig gestapelt. In diesem Dokument steht FC für ein einzelnes Formatzeichen. Formatzeichen werden in allen CAPS mit ihren tatsächlichen symbolischen Namen dargestellt. Andere beliebige Felder werden durch einen Namen und eine Größe dargestellt.
Spitzenklammern ( <> ) werden verwendet, um die Größe der Deskriptoren zu kennzeichnen. Die in der folgenden Tabelle gezeigten Konventionen werden verwendet.
| Notation | Bedeutung |
|---|---|
| <N> | Die Größe des Deskriptors beträgt n Bytes. |
| <> | Die Größe des Deskriptors variiert. |
| {<>}* | Der Deskriptor wird beliebig oft wiederholt (0,1,2 ...). |
Die folgenden Formatzeichen haben eine besondere Bedeutung.
| Zeichen | Bedeutung |
|---|---|
| FC _ END | Gibt das Ende einiger Formatzeichenfolgen an. |
| FC _ PAD | Nicht interpretiertes Padzeichen. |