تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

nl::Weave::HostPortList

#include <src/lib/core/HostPortList.h>

لإدارة قائمة منافذ المضيف ومعالجتها، هي مجموعة مدمجة ذات تشفير ثنائي من صفوف معرّفات المنافذ والمضيف المرتبطة بدليل خدمة Weave.

ملخّص

الدلالة والهياكل
`HostPortList(void)` الدالة الإنشائية التلقائية للفئة (خالية).
`HostPortList(const uint8_t hostPortList, uint8_t hostPortCount, const uint8_t suffixList, const uint8_t suffixCount)`

الدوال العامة
`Clear(void)`	`void` يُرجى إعادة ضبط القائمة على فارغة.
`Get(uint8_t index, char *hostBuf, uint32_t hostBufSize, uint16_t & port) const`	`WEAVE_ERROR` احصل على اسم المضيف والمنفذ في الفهرس المحدد من القائمة.
`IsEmpty(void) const`	`bool`
`Pop(char *hostBuf, uint32_t hostBufSize, uint16_t & port)`	`WEAVE_ERROR` يمكنك الحصول على اسم المضيف الأول والمنفذ وإزالته من القائمة.

void Clear(
  void
)

يُرجى إعادة ضبط القائمة على فارغة.

WEAVE_ERROR Get(
  uint8_t index,
  char *hostBuf,
  uint32_t hostBufSize,
  uint16_t & port
) const

احصل على اسم المضيف والمنفذ في الفهرس المحدد من القائمة.

التفاصيل

المَعلمات

`[in] index`	الموضع في القائمة لعرض اسم المضيف والمنفذ.
`[in,out] hostBuf`	مؤشر يشير إلى مساحة التخزين المطلوب نسخ اسم المضيف إليها.
`[in] hostBufSize`	مقدار مساحة التخزين المتاحة في HostBuf.
`[out] port`	رقم المنفذ.

قيم الإرجاع

`WEAVE_ERROR_INVALID_ARGUMENT`	حجم الفهرس المطلوب يتجاوز حجم القائمة.
`WEAVE_ERROR_UNSUPPORTED_HOST_PORT_ELEMENT`	كان نوع عنصر "منفذ المضيف" المطلوب غير متوافق.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	طول اسم مضيف منفذ المضيف أطول من المخزن المؤقت المتوفر.
`WEAVE_NO_ERROR`	عند النجاح

 HostPortList(
  void
)

الدالة الإنشائية التلقائية للفئة (خالية).

 HostPortList(
  const uint8_t *hostPortList,
  uint8_t hostPortCount,
  const uint8_t *suffixList,
  const uint8_t suffixCount
)

bool IsEmpty(
  void
) const

WEAVE_ERROR Pop(
  char *hostBuf,
  uint32_t hostBufSize,
  uint16_t & port
)

يمكنك الحصول على اسم المضيف الأول والمنفذ وإزالته من القائمة.

التفاصيل

المَعلمات

`[in,out] hostBuf`	مؤشر يشير إلى مساحة التخزين المطلوب نسخ اسم المضيف إليها.
`[in] hostBufSize`	مقدار مساحة التخزين المتاحة فيhostBuf.
`[out] port`	رقم المنفذ.

قيم الإرجاع

`WEAVE_ERROR_HOST_PORT_LIST_EMPTY`	لا تتوفّر أي إدخالات في القائمة.
`WEAVE_ERROR_UNSUPPORTED_HOST_PORT_ELEMENT`	كان نوع عنصر "منفذ المضيف" الذي تمت مواجهته نوعًا غير متوافق.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	طول اسم مضيف منفذ المضيف أطول من المخزن المؤقت المتوفر.
`WEAVE_NO_ERROR`	عند النجاح