The following figure shows how an IDL file is processed by the SOM compiler:
Environment Variables C Bindings
旼컴컴컴컴컴컴컴컴컴커 旼컴컴컴컴컴컴컴�
넬컴컴컴컴컴컴컴컴� � � 旼컴커 旼컴커 �
납 SET SMINCLUDE= � � � �.IH � � .H � �
냅컴컴컴컴컴컴컴컴� � 旼컴컴컴커 � 읕컴켸 읕컴켸 �
넬컴컴컴컴컴컴컴컴� 냐컴컴컴�� � 旼�� 旼컴커 旼컴커 �
납 SET SMEMIT= � � � SOM � � � � .C � �.PDL� �
냅컴컴컴컴컴컴컴컴� � 旼�쿎ompiler냐컴캑 � 읕컴켸 읕컴켸 �
넬컴컴컴컴컴컴컴컴� � � � � � � 旼컴커 �
납 SET SMTMP= � � � 읕컴컴컴켸 � � �.DEF� �
냅컴컴컴컴컴컴컴컴� � � � � 읕컴켸 �
넬컴컴컴컴컴컴컴컴� � � � 읕컴컴컴컴컴컴컴�
납 SET SOMIR= � � � 쿚R
냅컴컴컴컴컴컴컴컴� � � � C++ Bindings
읕컴컴컴컴컴컴컴컴컴켸 � � 旼컴컴컴컴컴컴컴�
� � � 旼컴커 旼컴커 �
旼컴컴컴컴컴컴컴커 � � � �.XIH� �.XH � �
� .IDL 냐컴컴컴켸 읕�� 읕컴켸 읕컴켸 �
읕컴컴컴컴컴컴컴켸 � 旼컴커 旼컴커 �
� �.CPP� �.PDL� �
� 읕컴켸 읕컴켸 �
� 旼컴커 �
� �.DEF� �
� 읕컴켸 �
읕컴컴컴컴컴컴컴�
The SOM compiler processes the IDL file for a SOM class and generates a set of language binding files. The file name of a SOM C-language binding file corresponds to that of the IDL file processed by the SOM compiler, unless the filestem modifier was specified in the IDL file. Each SOM C-language file has a different extension. For example, the SOM compiler processes EXAMPLE.IDL and generates EXAMPLE.C, EXAMPLE.H, and so forth. The language binding files generated by the SOM compiler are described in the following table:
旼컴컴컴컴컴컫컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 쿎 Extension 쿎++ 쿏escription � � 쿐xtension � � 쳐컴컴컴컴컴컵컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 �.C �.CPP 쿟emplate for C-language source � � � 쿾rogram for the class � � � 쿶mplementation. � 쳐컴컴컴컴컴컵컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 �.DEF �.DEF 쿔nstructions to the Linker about how� � � 퀃o build a class library. � 쳐컴컴컴컴컴컵컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 �.H �.XH 쿛ublic Include file for all � � � 쿎-language programs that need to � � � 쿪ccess the SOM class. � 쳐컴컴컴컴컴컵컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 �.IH �.XIH 쿔mplementation header containing � � � 쿺ost of the automatically generated � � � 쿶mplementation details about the � � � 쿬lass. � 쳐컴컴컴컴컴컵컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑 �.PDL �.PDL 쿗anguage-neutral form and subset of � � � 퀃he SOM IDL file with � � � 쿾rivate-implementation detail � � � 퀁emoved. This file should be � � � �"published" (or exported, made � � � 쿪vailable) to users of the class. � 읕컴컴컴컴컴컨컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
Some of these files contain the public interface for the class; others contain the private interface. Some files are used to implement the class and its subclasses, and some are used by client programs that create and manipulate object instances of the class.
The IH and C files are the C-language source files for the class implementation. The IH file is included automatically in the C file. The IDL file is specified in the Include section of the class definition files for subclasses of the class. The H file must be included in client programs to create and manipulate object instances of the class. Separate public and private versions of the .H and .IDL files can be generated by the SOM tools.
A set of environment variables, as shown in the following table, control the SOM-compiler processing.
旼컴컴컴컴컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿣ariable 쿏escription � 쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿞MEMIT 쿞pecifies which output files are to be � � 쿲enerated. � 쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿞MINCLUDE 쿞pecifies the location of the class � � 쿭efinition files (IDL). � 쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿞MTMP 쿞pecifies the directory to be used for � � 쿶ntermediate files. � 쳐컴컴컴컴컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 쿞OMIR 쿞pecifies the names of interface repository � � 쿯iles. � 읕컴컴컴컴컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�
SMTMP is optional and defaults to the root directory of the current drive. If the files specified in the Include section of the class definition file are enclosed in double quotation marks, SMINCLUDE is optional and defaults to the root directory of the current drive. If the files specified in the Include section of the class definition file are enclosed in angled brackets ( < > ), SMINCLUDE is required for the SOM-compiler processing. SMEMIT is used to indicate which bindings files are generated.