Declaration

template <
    int Family,
    int Protocol
> class basic_sockaddress;

class sockaddress_error;

Overview

sockaddress は，struct sockaddr のラッパクラスです．ホスト名 and/or ポート番号（または，サービス名）を指定すると，それらの情報を基に新たな struct sockaddr を生成します．sockaddress_error は，指定されたホスト名， またはサービス名に対応するポート番号が見つからない場合に送出される例外です．

Template Parameters

Family

プロトコルファミリーを指定します．

Protocol

プロトコルを指定します．

Related Types

typedef struct sockaddr_in inet_type;
typedef char char_type;
typedef std::basic_string<char> string_type;
typedef unsigned int size_type;

Construction and Member Functions

basic_sockaddress();
explicit basic_sockaddress(const inet_type& addr);
explicit basic_sockaddress(int port);
explicit basic_sockaddress(const char_type* host, int port);
explicit basic_sockaddress(const string_type& host, int port);
virtual ~basic_sockaddress() throw();

引数にホスト名 and/or ポート番号が指定された場合は，指定された引数で assign() メソッドを実行します．assign() メソッドについては後述します．

basic_sockaddress& assign(const inet_type& addr);
basic_sockaddress& assign(int port);
basic_sockaddress& assign(const char_type* host, int port, int n = 0);
basic_sockaddress& assign(const string_type& host, int port, int n = 0);

ホスト名，およびポート番号が引数に指定された場合は，指定された引数を基にして， 新たなクライアント用のソケット・アドレスを生成します．ホスト名の名前解決には， resolver を使用します．指定されたホスト名に対して複数の IP アドレスが設定されている場合には，n 番目の IP アドレスを用いて生成します．

ポート番号のみが引数に指定された場合は，サーバ用のソケット・アドレスを生成します．

string_type ipaddr() const;
int port() const;

IP アドレス，およびポート番号の情報へアクセスするためのメソッドです． ipaddr() は，ドット区切りの文字列 (e.g., 192.168.0.1) が返されます．

const inet_type* data() const;
size_type size() const; // inet_typeのサイズ

これらのメソッドは，OS のシステムコールを使う際に，struct sockaddr へアクセスを行う必要がある場合に使用します．