nl::Inet::InterfaceAddressIterator

#include <src/inet/InetInterface.h>

システム ネットワーク インターフェース IP アドレスのリストのイテレータ。

概要

このクラスのオブジェクトを使用して、システムのネットワーク インターフェース IP アドレスのリストを反復処理します。

このクラスの個々のインスタンスのメソッドはスレッドセーフではありません。ただし、別々のインスタンスを複数のスレッドで同時に使用することはできます。

マルチスレッド LwIP システムでは、インスタンスは、グローバル LwIP 状態にアクセスする他のスレッドに対してスレッドセーフである。 1）他のスレッドが、netif のリストを変更している間、LwIP コアロックを保持している。2）netif オブジェクト自体は破棄されない

ソケットベースのシステムでは、基盤となるシステムのインターフェースやアドレスが変更されても、反復処理は常に安定しています。

LwIP システムでは、現在のアドレスに関連付けられたインターフェースが削除される場合を除き、反復は安定しています。その場合、反復が早期に終了する可能性があります。

コンストラクタとデストラクタ
InterfaceAddressIterator(void)
InterfaceAddressIterator オブジェクトを構築します。
~InterfaceAddressIterator(void)
InterfaceAddressIterator オブジェクトを破棄します。

パブリック関数
GetAddress(void)
現在のインターフェース アドレスを取得します。
GetAddressWithPrefix(IPPrefix & addrWithPrefix)
void
現在のアドレスのアドレスとプレフィックス長を含む IPPrefix を返します。
GetIPv6PrefixLength(void)
uint8_t
GetPrefixLength(void) の非推奨のエイリアス
GetInterface(void)
InterfaceId
GetInterfaceId(void) の非推奨のエイリアス
GetInterfaceId(void)
InterfaceId
現在のインターフェース アドレスに関連付けられたネットワーク インターフェース ID を返します。
GetInterfaceName(char *nameBuf, size_t nameBufSize)
現在のインターフェース アドレスに関連付けられているネットワーク インターフェースの名前を取得します。
GetPrefixLength(void)
uint8_t
現在のインターフェース アドレスに関連付けられているネットワーク接頭辞を取得します。
HasBroadcastAddress(void)
bool
現在のインターフェース アドレスに関連付けられているネットワーク インターフェースが IPv4 ブロードキャスト アドレスを持っているかどうかを返します。
HasCurrent(void)
bool
IsUp(void)
bool
現在のインターフェース アドレスに関連付けられたネットワーク インターフェースが稼働しているかどうかを返します。
Next(void)
bool
イテレータを次のインターフェース アドレスに進めます。
SupportsMulticast(void)
bool
現在のインターフェース アドレスに関連付けられているネットワーク インターフェースがマルチキャストをサポートしているかどうかを返します。

パブリック関数

GetAddress

IPAddress GetAddress(
  void
)

現在のインターフェース アドレスを取得します。

詳細
戻り値
現在のインターフェース アドレス。イテレータがアドレスリストの末尾を超える場合は IPAddress::Any。

GetAddressWithPrefix

void GetAddressWithPrefix(
  IPPrefix & addrWithPrefix
)

現在のアドレスのアドレスとプレフィックス長を含む IPPrefix を返します。

GetIPv6PrefixLength

uint8_t GetIPv6PrefixLength(
  void
)

GetPrefixLength(void) の非推奨のエイリアス

GetInterface

InterfaceId GetInterface(
  void
)

GetInterfaceId(void) の非推奨のエイリアス

GetInterfaceId

InterfaceId GetInterfaceId(
  void
)

現在のインターフェース アドレスに関連付けられたネットワーク インターフェース ID を返します。

詳細
戻り値
インターフェース ID。イテレータがアドレスリストの末尾にある場合は INET_NULL_INTERFACEID。

GetInterfaceName

INET_ERROR GetInterfaceName(
  char *nameBuf,
  size_t nameBufSize
)

現在のインターフェース アドレスに関連付けられているネットワーク インターフェースの名前を取得します。

Writes the name of the network interface as \c NUL terminated text string
at \c nameBuf.

詳細
パラメータ
[in] nameBuf
インターフェース名を書き込みます。
[in] nameBufSize
nameBuf で示されるリージョンのサイズ
戻り値
INET_NO_ERROR
成功の結果、インターフェース名の書き込み
INET_ERROR_NO_MEMORY
名前が大きすぎてバッファに書き込めません
INET_ERROR_INCORRECT_STATE
イテレータが現在インターフェース アドレスに配置されていない
other
別のシステムエラーまたはプラットフォーム エラー

GetPrefixLength

uint8_t GetPrefixLength(
  void
)

現在のインターフェース アドレスに関連付けられているネットワーク接頭辞を取得します。

On LwIP, this method simply returns the hard-coded constant 64.

Note Well: the standard subnet prefix on all links other than PPP
links is 64 bits. On PPP links and some non-broadcast multipoint access
links, the convention is either 127 bits or 128 bits, but it might be
something else. On most platforms, the system's interface address
structure can represent arbitrary prefix lengths between 0 and 128.

詳細
戻り値
ネットワーク プレフィックス（ビット単位）。イテレータがアドレスリストの末尾にある場合は 0。

HasBroadcastAddress

bool HasBroadcastAddress(
  void
)

現在のインターフェース アドレスに関連付けられているネットワーク インターフェースが IPv4 ブロードキャスト アドレスを持っているかどうかを返します。

詳細
戻り値
true インターフェースにブロードキャスト アドレスがある場合、または false ない場合、またはイテレータがインターフェース アドレスに配置されていない場合。

HasCurrent

bool HasCurrent(
  void
)

InterfaceAddressIterator

 InterfaceAddressIterator(
  void
)

InterfaceAddressIterator オブジェクトを構築します。

最初のネットワーク アドレスからイテレータを開始します。プラットフォームによっては、このコンストラクタがデストラクタによってリサイクルされたリソースを割り当てることがあります。

IsUp

bool IsUp(
  void
)

現在のインターフェース アドレスに関連付けられたネットワーク インターフェースが稼働しているかどうかを返します。

詳細
戻り値
現在のネットワーク インターフェースが稼働している場合は true、稼働していない場合、またはイテレータがインターフェース アドレスに配置されていない場合は false。

次へ

bool Next(
  void
)

イテレータを次のインターフェース アドレスに進めます。

Advances the iterator to the next interface address or to a position
beyond the end of the address list.

On LwIP, this method is thread-safe provided that: 1) other threads hold
the LwIP core lock while mutating the netif list; and 2) netif objects
themselves are never destroyed.  Additionally, iteration on LwIP systems
will terminate early if the current interface is removed from the list.

詳細
戻り値
最後まで進んだ場合は false、それ以外の場合は true。

SupportsMulticast

bool SupportsMulticast(
  void
)

現在のインターフェース アドレスに関連付けられているネットワーク インターフェースがマルチキャストをサポートしているかどうかを返します。

詳細
戻り値
マルチキャストがサポートされている場合は true、サポートされていない場合、またはイテレータがインターフェース アドレスに配置されていない場合は false。

~InterfaceAddressIterator

 ~InterfaceAddressIterator(
  void
)

InterfaceAddressIterator オブジェクトを破棄します。

コンストラクタによって割り当てられたすべてのリソースをリサイクルします。