Internet Basics

Module Description

These classes provide the basic tools needed when writing internet applications.

Classes
class	RWDirEntry
	A convenience class that encapsulates parsing and component storage of directory entries typical of those returned from the FTP LIST command. More...
class	RWNumReply
	Encapsulates a numerical protocol reply typical of many common Internet protocols. More...
class	RWNumReplyLine
	Encapsulates a single numerical protocol reply as defined by the FTP and SMTP protocols. More...
class	RWProtocolAgentError
	An exception thrown when when a protocol-specific error (FTP, POP3, SMTP) occurs while processing a command in an Agent class. More...
class	RWProtocolClientCmdSequenceError
	An exception thrown when a protocol action (FTP, POP3, HTTP, SMTP) is used out of the sequence dictated by that protocol. More...
class	RWProtocolClientError
	An exception thrown when when a protocol-specific error (FTP, POP3, SMTP) occurs while processing a command in a Client class. More...
class	RWReply
	Abstract base class for all protocol replies. More...
class	RWReplyError
	An exception thrown when an RWReply (or derived class) is used in an invalid manner. More...
class	RWReplySyntaxError
	An exception thrown when the text or error number of a reply message does not adhere to the single numerical reply defined by the protocol being used. More...
class	RWStreamCoupler
	Provides an automated mechanism for connecting an input stream to an output stream. More...
class	RWURL
	A convenience class that encapsulates parsing and component management of URL information. More...
class	RWURLError
	An exception not currently used. It remains reserved for potential future use. More...

Functions
RWCString	rwAddPeriods (const RWCString &line)
RWCString	rwFtpAddrToString (const RWInetAddr &addr)
RWInetAddr	rwFtpStringToAddr (const RWCString &addrString)
RWCString	rwNormalizeLine (const RWCString &text)
RWCString	rwRemovePeriods (const RWCString &line)

Function Documentation

RWCString rwAddPeriods

(

const RWCString &

line

)

Returns a copy of line that replaces all leading periods following any newline character with two periods. This is a convenience function that you can use to reverses the encoding used by SMTP clients to transmit objects over the SMTP protocol. The RWCString should contain 7-bit US-ASCII data.

Header File

#include <rw/internet/util.h>

RWCString rwFtpAddrToString

(

const RWInetAddr &

addr

)

Returns addr converted to RWCString format. The RWCString should contain 7-bit US-ASCII data.

Header File

#include <rw/internet/util.h>

RWInetAddr rwFtpStringToAddr

(

const RWCString &

addrString

)

Returns addrString converted to RWInetAddr format. The RWCString should contain 7-bit US-ASCII data.

Header File

#include <rw/internet/util.h>

RWCString rwNormalizeLine

(

const RWCString &

text

)

Header File

#include <rw/internet/util.h>

Returns the text argument normalized by removing <cr><lf> characters embedded in an RWCString.

RWCString rwRemovePeriods

(

const RWCString &

line

)

Returns a copy of line that replaces all leading double periods and double periods following any newline character with single periods. This is a convenience function that you can use to undo the encoding used by POP3 servers to transmit objects over the SMTP protocol. The RWCString should contain 7-bit US-ASCII data.

Header File

#include <rw/internet/util.h>