<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-A2031A61-3319-4FBA-BC71-AC1327182053" xml:lang="en"><title>Getting

started with C++ Standard Library</title><shortdesc>The Standard C++ library depends on P.I.P.S.. The user must have

the P.I.P.S. components installed before using the library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-D42A187D-603E-4D66-BAA8-86782B9C2717"><title>C++ IOstream

and Standard Template Library Documentation</title><p>C++ IOStream library

documentation can be found at <xref href="http://www.slac.stanford.edu/comp/unix/gnu-info/iostream_toc.html" scope="external">http://www.slac.stanford.edu/comp/unix/gnu-info/iostream_toc.html</xref>.</p><p>Similarly,

Standard Template Library (STL) documentation can be found at <xref href="http://www.informatik.uni-freiburg.de/~danlee/fun/STL-doc/STL.html" scope="external">http://www.informatik.uni-freiburg.de/~danlee/fun/STL-doc/STL.html</xref>.</p></section>

<section id="GUID-BF521201-7BE5-4AC5-8D35-1E15AC4887C7-GENID-1-10-1-11-1-1-9-1-5-1-3-2"><title>Changes to

the MMP file</title><p><b>Add needed libraries used by the MMP file structure: </b></p><p>If

developers want to use any of Standard C++ library, they must link to the

corresponding library in the MMP file using the <codeph>LIBRARY</codeph> keyword.</p><p>If

the application has <codeph>main()</codeph> as the entry point, the library <filepath>libcrt0.lib</filepath> must

be specified as the first library otherwise, it results in linker errors.

The user must link to the Symbian platform <filepath>euser.dll</filepath>.

This is required since the static library uses some of the services of the

Symbian platform, such as, creating cleanup stack, and having a top level

TRAP. All these details are hidden from the developer. The developer will

write the application as if it were for the UNIX environment.</p><codeblock xml:space="preserve">STATICLIBRARY  libcrt0.lib

LIBRARY        libc.lib 

LIBRARY        euser.lib  // Needed in order to use Symbian services

</codeblock><p>The <filepath>libcrt0.lib</filepath> library is required for

writing to <codeph>E32Main</codeph> within our application (EXE). This static

library has an implementation of <codeph>E32Main</codeph> within which it

calls the library initialization method followed by calling main written by

the developer. This static library also retrieves command-line arguments and

passes the same to main.</p><p>If the application has <codeph>E32Main()</codeph> as

an entry point, there is no need to link to <filepath>libcrt0.lib</filepath> like

in the example below.</p><codeblock xml:space="preserve">LIBRARY         libc.lib 

LIBRARY         euser.lib</codeblock><p><b>Add required include paths</b></p><codeblock xml:space="preserve">SYSTEMINCLUDE   \epoc32\include\stdapis

SYSTEMINCLUDE   \epoc32\include\stdapis\sys

SYSTEMINCLUDE   \epoc32\include\stdapis\stlport 

</codeblock><p><b>Linking of <codeph>libstdcpp</codeph></b></p><p>Following

snippet shows how to perform the linking to <codeph>libstdcpp</codeph> on

an emulator: </p><codeblock xml:space="preserve">#ifdef EPOC32

LIBRARY  libstdcpp.lib

#else

FIRSTLIB ../udeb/libstdcpp.lib

STATICLIBRARY    eexe.lib 

#endif</codeblock><p>Add the below option and macro in the MMP file</p><codeblock xml:space="preserve">//This is required even if the wchar type is not used.

OPTION CW -wchar_t on 

MACRO  _WCHAR_T_DECLARED</codeblock><note> Standard C++ applications may require

more stack space. The recommended stack size is 10K. To set the stack size

to 10K add: </note><codeblock xml:space="preserve">EPOCSTACKSIZE 0x10000</codeblock><p>in the MMP

file.</p></section>

<section id="GUID-BF521201-7BE5-4AC5-8D35-1E15AC4887C7-GENID-1-10-1-11-1-1-9-1-5-1-3-3"><title>Example using <codeph>main()</codeph></title> 

     <p>A simple example using <codeph>main()</codeph> as an entry point is

described below. The example writes a text to a console.</p><ul>

<li><p>Modify the MMP file as mentioned before.</p></li>

<li><p>Do usual C++ style coding.</p></li>

</ul><codeblock xml:space="preserve">//  Include Files  

#include <iostream>

#include <cstring>

// This is a GCCE toolchain workaround needed when compiling with GCCE

// and using main() entry point

#ifdef __GCCE__

// This is a GCCE toolchain workaround needed when compiling with GCCE

// and using main() entry point

#ifdef __GCCE__

#include <staticlibinit_gcce.h>

#endif

using namespace std;

class myclass {

public:

  void show(){cout<<"Hello World\n"; }

} ;

int main()

{

  myclass obj;

  obj.show();

  cout<<"Press a character to exit!";

  int c = getchar();

  return 0;

}

</codeblock></section>