Formatzeichenfolgen

Eine Formatzeichenfolge ist ein interpretiertes Token, das die NDR-Engine versteht. Formatzeichenfolgen werden häufig als MOPs bezeichnet. In dieser Dokumentation wird durchgehend der Begriff Formatzeichenfolge verwendet.

Genauer gesagt ist ein Formatzeichen ein einzelnes (atomar) 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 für die Benennung 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 von MIDL und der NDR-Engine verwendeten Formatzeichenfolgenzeichen werden in der Datei Ndrtypes.h definiert.

Formatieren von Zeichenfolgentabellen

Zwei primäre Formatzeichenfolgentabellen werden von der Engine verwendet: die Prozedurformatzeichenfolgentabelle , __MIDL_ProcFormatString, die die Prozedurdeskriptoren beibehält; und die Typformatzeichenfolgentabelle __MIDL_TypeFormatString, die die Datentypdeskriptoren beibehält. Der Compiler generiert beide in die Standard Stubdateien (*_c.c, *_s.c, *_p.c). Die Prozedurformatzeichenfolgentabelle wird hauptsächlich von verschiedenen Interpretern verwendet, aber sie wird auch für die Pufferkonvertierung verwendet, unabhängig vom Compilermodus. Die Typformatzeichenfolgentabelle wird verwendet, wenn die Kern-NDR-Engine aufgerufen wird, um bestimmte Datentypen anzugeben, die bearbeitet werden sollen.

Formatzeichenfolgennotation

Die in diesem Dokument verwendete Notation folgt allgemeinen Programmierbeschreibungsrichtlinien, wobei ein Balken ( | ) verwendet wird, um alternative Konstrukte anzugeben, und eckige Klammern ( [ ] ), die optionale Elemente angeben. Formatzeichenfolgen werden häufig zur Lesbarkeit (Verantwortlichkeit) gestapelt. In diesem Dokument bezeichnet FC 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.

Spitzen Klammern ( <> ) werden verwendet, um größen der Deskriptoren anzugeben. Die in der folgenden Tabelle gezeigten Konventionen werden verwendet.

Notation	Bedeutung
< n>	Die Größe des Deskriptors beträgt n Byte.
<>	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	Uninterpretiertes Padzeichen.