Guidelines for Writing Standard C++ Libraries

Ensure that you adhere to the following guidelines while writing Standard C++ Libraries on the Symbian platform:

1. Developing a DLL - Import/Export static data

   Importing or exporting writable static data from a DLL is not supported on the Symbian platform. To achieve this, you must provide an exported function in the DLL to return a reference or pointer to that data.

2. Developing a static library

   The Symbian build environment enforces the following rules:

   1. If a static library is of type STDLIB, it is allowed to be linked to by an STDEXE or STDDLL.

   2. If a static library is of type STDLIB, it is allowed to be linked to by an executable (EXE or a DLL) that has the STDCPP keyword in its .mmp file.

   3. If a static library is of target type LIB and its .mmp file contains the keyword STDCPP, it is allowed to be linked to by an STDEXE or STDDLL.

   4. If a static library is of target type LIB and its .mmp file does not contain the keyword STDCPP, it is allowed to be linked to by an executable that does not contain the keyword STDCPP.

   5. If a static library is of target type LIB and its .mmp file does not contain the keyword STDCPP, it is not allowed to be linked to by an executable that is an STDEXE or STDDLL.

      Note: An attempt to violate this rule causes a build time error.

   6. If a static library is of target type STDLIB, it is not allowed to be linked to by an executable (EXE or DLL) that does not mention the keyword STDCPP.

      Note: An attempt to violate this rule causes a build time error.