Note on Code Presentation (OD PG)

Inside Macintosh: OpenDoc Programmer's Guide /: Preface - About This Book

Note on Code Presentation
In an attempt to be as language-neutral as possible, this book presents very little code. Prototypes for the methods of ODPart, where presented, are in the System Object Model (SOM) Interface Definition Language (IDL). As an example of what IDL prototypes look like, here is the prototype for the AddProperty method of ODStorageUnit:
ODStorageUnit AddProperty(in ODPropertyName propertyName);
Note the directional attribute ("in") that precedes the type designation of the single parameter.
The few short listings of implementation code are in C++. In implementation listings, note that every call to a method of a SOM-based class (as all OpenDoc classes are) includes an extra parameter, the environment parameter, that does not appear in the method's IDL prototype. Here is an example (in C++) of a call to the AddProperty method:
su->AddProperty(ev, kODPropContents);