# ACEXML_URL_Addr Class Reference

`#include <ACEXML/common/URL_Addr.h>`

Inheritance diagram for ACEXML_URL_Addr:

[legend]
Collaboration diagram for ACEXML_URL_Addr:

[legend]
List of all members.

## Public Member Functions

| ACEXML_URL_Addr (void)
| Initialization and termination methods.
| ACEXML_URL_Addr (const ACEXML_Char *host_name, const ACEXML_Char *path_name, unsigned short port=ACE_DEFAULT_HTTP_PORT)
| Constructor.
| ACEXML_URL_Addr (const ACEXML_URL_Addr &addr)
| Copy constructor.
int | set (const ACEXML_URL_Addr &addr)
| Essentially the copy constructor.
virtual int | string_to_addr (const ACEXML_Char *address)
virtual int | addr_to_string (ACEXML_Char *s, size_t size, int ipaddr_format=1) const
virtual const ACEXML_Char * | addr_to_string (int ipaddr_format=1)
void | operator= (const ACEXML_URL_Addr &addr)
| Assignment operator.
| ~ACEXML_URL_Addr (void)
| Destructor.
bool | operator== (const ACEXML_URL_Addr &SAP) const
bool | operator!= (const ACEXML_URL_Addr &SAP) const
| Compare two addresses for inequality.
virtual u_long | hash (void) const
| Computes and returns hash value.
const ACEXML_Char * | get_path_name (void) const
| Return the path name.
int | destroy (void)
| Commit suicide.

## Private Member Functions

size_t | calculate_length (int ipaddr_format) const
| Calculate the maximum length of the address string.

## Private Attributes

ACEXML_Char * | path_name_
| Our path name.
ACEXML_Char * | addr_string_
size_t | addr_string_len_
| Current length of the <addr_string_>.

## Detailed Description

Defines a URL address family address format.

## Constructor & Destructor Documentation

ACEXML_URL_Addr::ACEXML_URL_Addr | ( | void |  | ) |

| Initialization and termination methods.

ACEXML_URL_Addr::ACEXML_URL_Addr | ( | const ACEXML_Char * | host_name,
|  | const ACEXML_Char * | path_name,
|  | unsigned short | port = `ACE_DEFAULT_HTTP_PORT`
| ) |

| Constructor.

ACEXML_URL_Addr::ACEXML_URL_Addr | ( | const ACEXML_URL_Addr & | addr | ) |

| Copy constructor.

ACEXML_URL_Addr::~ACEXML_URL_Addr | ( | void |  | ) |

| Destructor.

## Member Function Documentation

const ACEXML_Char * ACEXML_URL_Addr::addr_to_string | ( | int | ipaddr_format = `1` | ) | `[virtual]`

Transform the current <ace_inet_addr> address into string format. If <ipaddr_format> is non-0 this produces "ip-number:port-number/path-name" (e.g., "128.252.166.57:80/~schmidt/"), whereas if <ipaddr_format> is 0 this produces "ip-name:port-number" (e.g., "www.cs.wustl.edu:80/~schmidt/"). Uses dynamic memory, which is allocated on demand and deallocated when the object is destroyed. Returns -1 if dynamic memory fails, else 0.

int ACEXML_URL_Addr::addr_to_string | ( | ACEXML_Char * | s,
|  | size_t | size,
|  | int | ipaddr_format = `1`
| ) | const`[virtual]`

| Transform the current <ace_inet_addr> address into string format. If <ipaddr_format> is non-0 this produces "ip-number:port-number/path-name" (e.g., "128.252.166.57:80/~schmidt/"), whereas if <ipaddr_format> is 0 this produces "ip-name:port-number" (e.g., "www.cs.wustl.edu:80/~schmidt/"). Returns -1 if the <size> of the <buffer> is too small, else 0.

ACE_INLINE size_t ACEXML_URL_Addr::calculate_length | ( | int | ipaddr_format | ) | const`[private]`

| Calculate the maximum length of the address string.

ACE_INLINE int ACEXML_URL_Addr::destroy | ( | void |  | ) |

| Commit suicide.

ACE_INLINE const ACEXML_Char * ACEXML_URL_Addr::get_path_name | ( | void |  | ) | const

| Return the path name.

ACE_INLINE u_long ACEXML_URL_Addr::hash | ( | void |  | ) | const`[virtual]`

| Computes and returns hash value. Reimplemented from ACE_INET_Addr.

ACE_INLINE bool ACEXML_URL_Addr::operator!= | ( | const ACEXML_URL_Addr & | SAP | ) | const

| Compare two addresses for inequality.

ACE_INLINE void ACEXML_URL_Addr::operator= | ( | const ACEXML_URL_Addr & | addr | ) |

| Assignment operator.

ACE_INLINE bool ACEXML_URL_Addr::operator== | ( | const ACEXML_URL_Addr & | SAP | ) | const

| Compare two addresses for equality. The addresses are considered equal if they contain the same IP address, port number, and path name.

int ACEXML_URL_Addr::set | ( | const ACEXML_URL_Addr & | addr | ) |

| Essentially the copy constructor.

int ACEXML_URL_Addr::string_to_addr | ( | const ACEXML_Char * | address | ) | `[virtual]`

| Initializes an <acexml_url_addr> from the <address>, which can be "ip-number:port-number/path-name" (e.g., "www.cs.wustl.edu:1234/~schmidt/" "ip-number:port-number/path-name" (e.g., "128.252.166.57:1234/~schmidt"). If there is no ':' in the <address> it is assumed to be an ip-number or ip-address number, with the port number <ace_default_http_port>.

## Member Data Documentation

ACEXML_Char* ACEXML_URL_Addr::addr_string_ `[private]`

| The dynamically created address string that's used for the <addr_to_string> method.

size_t ACEXML_URL_Addr::addr_string_len_ `[private]`

| Current length of the <addr_string_>.

ACEXML_Char* ACEXML_URL_Addr::path_name_ `[private]`

| Our path name.

The documentation for this class was generated from the following files:

- URL_Addr.h
- URL_Addr.cpp
- URL_Addr.inl