30.1 The C++ Examples Directory

When you build Tools.h++ Professional using the Rogue Wave Software Parts Manager, it creates separate directories for the C++ and the Java examples. The path to the C++ examples directory is:

<rw_root>\workspaces\<OS+ver>\<COMPILER+ver>\<buildtype>\examples

The examples directory itself is organized as follows:

examples
   \tpr<ver><osfam>
      \inet
      \net
      \orbs

In other words, the examples in the C++ examples directory are organized by library under their respective builds. Please see Section 1.5.2 for an explanation of the pathname variables; see the Build Guide for an explanation of the build variables, and for instructions on building the examples.

Table 13 through Table 15 list the names of the C++ examples by library. Each example usually consists of several files. If an example is also discussed in the User's Guide, a reference is given in the table.

Table 13 -- Examples using the inet library

Example name	Description
`ftpagnt`	Retrieves an ASCII file from a remote FTP server, using an *RWIFtpAgent*. See Chapter 20, "Simple int Examples."
`ftpclnt`	Issues basic FTP commands, including `LIST`, `CWD`, `PWD`, and `RETR`, using *RWIFtpClient*. See Chapter 20, "Simple int Examples."
`httpagnt`	Retrieves a file from an HTTP server, using *RWIHttpAgent* and *RWURL*. See Chapter 20, "Simple int Examples."
`pop3clnt`	Checks a POP3 mailbox; if the mailbox isn't empty, retrieves the first message in the mailbox. Based on *RWIPop3Client* and related classes. See Chapter 20, "Simple int Examples."
`smtpagnt`	Sends an email message, using *RWISmtpAgent* and *RWSocketPortal*. See Chapter 20, "Simple int Examples."

Table 14 -- Examples using the net library

Example name	Description
`adddocs`	Connects to the server and adds the Reptile and CircleOfLife webs to a collection. You can supply an optional parameter indicating which address to connect to. See Section 16.3, "Running the Demo."
`getdoc`	Connects to the collection server, requests the web corresponding to the string ReptileWeb, and prints the web links. An optional third parameter indicates the server's address. See Section 16.3, "Running the Demo."
`docserve`	Starts up a server for the demo in Section 16.3, "Running the Demo."
`greet`	Connects to a TCP/IP server at an address you specify. Sends the server the appropriate greeting and listens on the read side of the socket, printing whatever the other side says. See Section 18.3, "TCP Sockets "hello world": greet."
`hostinfo`	Uses an *RWInetHost* to look up information regarding a network host. See Chapter 18, "Other net Examples."
wwwget	Uses an *RWSocketPortal* to retrieve a file from an HTTP server. See Chapter 18, "Other net Examples."

Table 15 -- Examples using the orb library

Example name	Description
`dog`	Demonstrates the use of the `RWDEFINE_OPAQUE` macro to pass a simple C++ class, *Dog*, across an ORB using virtual streams.
`roster`	Demonstrates the use of the `RWDEFINE_OPAQUE_COLLECTABLE` macro to pass a more complex C+ class, *Roster*, across an ORB using virtual streams.