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

nl

عمليات تجاوز nlassert.h الخاصة بـ Weave.

ملخّص

عمليات التعداد
`@357`	تعداد
`@358`	تعداد
`@359`	تعداد
`@360`	تعداد
`@361`	تعداد
SerializedFieldType{ SerializedFieldTypeBoolean = 0x00, SerializedFieldTypeUInt8, SerializedFieldTypeUInt16, SerializedFieldTypeUInt32, SerializedFieldTypeUInt64, SerializedFieldTypeInt8, SerializedFieldTypeInt16, SerializedFieldTypeInt32, SerializedFieldTypeInt64, SerializedFieldTypeFloatingPoint32, SerializedFieldTypeFloatingPoint64, SerializedFieldTypeUTF8String, SerializedFieldTypeByteString, SerializedFieldTypeStructure, SerializedFieldTypeArray }	تعداد قائمة بأنواع TLV للكتابة باستخدام حقل TLV
`SerializedFieldTypeBits`	تعداد حقل Bitfield لـ SerializedFieldType.
`SerializedFieldTypeMasks`	تعداد أقنعة للوصول إلى وحدات بت من SerializedFieldType.

تعريف الأنواع
`Base64CharToValFunct)(uint8_t c)`	تعريف الكتابة `uint8_t(*`
`Base64ValToCharFunct)(uint8_t val)`	تعريف الكتابة `char(*`
`MemoryAllocate)(size_t size)`	تعريف الكتابة `void (` مؤشرات تخصيص الذاكرة/دالة مجانية.
`MemoryFree)(void *ptr)`	تعريف الكتابة `void(*`
`MemoryReallocate)(void *ptr, size_t size)`	تعريف الكتابة `void (`

المتغيرات
`sASN1ErrorFormatter = { nl::Weave::ASN1::FormatASN1Error, NULL }`	`const ErrorFormatter`
`sElementSize = { sizeof(bool), sizeof(uint8_t), sizeof(uint16_t), sizeof(uint32_t), sizeof(uint64_t), sizeof(int8_t), sizeof(int16_t), sizeof(int32_t), sizeof(int64_t), sizeof(float), sizeof(double), sizeof(char ), sizeof(SerializedByteString), sizeof(void ), sizeof(void *) }[]`	`const uint8_t`
`sErrorFormatterList = &sWeaveErrorFormatter`	`const ErrorFormatter *` قائمة مرتبطة بدوال تنسيق الأخطاء
`sErrorStr[WEAVE_CONFIG_ERROR_STR_SIZE]`	`char` تخزين مؤقت ثابت لتخزين سلسلة الخطأ المنسَّقة
`sErrorStr[1024]`	`char` تعرض سلسلة الإجراءات هذه سلسلة C NULL منتهية الصلاحية ويمكن لشخص عادي قراءتها، وهي تصف رمز الحالة المقدَّم والمرتبط بالملف الشخصي المحدّد.
`sWeaveErrorFormatter = { nl::Weave::FormatWeaveError, &sASN1ErrorFormatter }`	`const ErrorFormatter`

الدوال
`AdjustCalendarDate(uint16_t & year, uint8_t & month, uint8_t & dayOfMonth, int32_t relativeDays)`	`void`
`Base64CharToVal(uint8_t c)`	`uint8_t`
`Base64Decode(const char in, uint16_t inLen, uint8_t out, Base64CharToValFunct charToValFunct)`	`uint16_t`
`Base64Decode(const char in, uint16_t inLen, uint8_t out)`	`uint16_t`
`Base64Decode32(const char in, uint32_t inLen, uint8_t out, Base64CharToValFunct charToValFunct)`	`uint32_t`
`Base64Decode32(const char in, uint32_t inLen, uint8_t out)`	`uint32_t`
`Base64Encode(const uint8_t in, uint16_t inLen, char out, Base64ValToCharFunct valToCharFunct)`	`uint16_t`
`Base64Encode(const uint8_t in, uint16_t inLen, char out)`	`uint16_t`
`Base64Encode32(const uint8_t in, uint32_t inLen, char out, Base64ValToCharFunct valToCharFunct)`	`uint32_t`
`Base64Encode32(const uint8_t in, uint32_t inLen, char out)`	`uint32_t`
`Base64URLCharToVal(uint8_t c)`	`uint8_t`
`Base64URLDecode(const char in, uint16_t inLen, uint8_t out)`	`uint16_t`
`Base64URLEncode(const uint8_t in, uint16_t inLen, char out)`	`uint16_t`
`Base64URLValToChar(uint8_t val)`	`char`
`Base64ValToChar(uint8_t val)`	`char`
`CalendarDateToDaysSinceEpoch(uint16_t year, uint8_t month, uint8_t dayOfMonth, uint32_t & daysSinceEpoch)`	`bool`
`CalendarDateToOrdinalDate(uint16_t year, uint8_t month, uint8_t dayOfMonth, uint16_t & dayOfYear)`	`void`
`CalendarTimeToSecondsSinceEpoch(uint16_t year, uint8_t month, uint8_t dayOfMonth, uint8_t hour, uint8_t minute, uint8_t second, uint32_t & secondsSinceEpoch)`	`bool`
`ClearFlag(FlagsT & inFlags, const FlagT inFlag)`	`void`
`DateToManufacturingWeek(uint16_t year, uint8_t month, uint8_t day, uint16_t & mfgYear, uint8_t & mfgWeek)`	`void`
`DaysInMonth(uint16_t year, uint8_t month)`	`uint8_t`
`DaysSinceEpochToCalendarDate(uint32_t daysSinceEpoch, uint16_t & year, uint8_t & month, uint8_t & dayOfMonth)`	`void`
`DaysToMarch1(uint16_t year)`	`uint8_t`
`DeallocateDeserializedStructure(void aStructureData, const SchemaFieldDescriptor aFieldDescriptors, SerializationContext *aContext)`	`WEAVE_ERROR`
`ErrorStr(int32_t err)`	`NL_DLL_EXPORT const char *` تعرض سلسلة الإجراءات هذه سلسلة C NULL منتهية ويمكن لشخص عادي قراءتها، وهي تصف الخطأ المقدم.
`ExtractManufacturingDateFromSerialNumber(const char *serialNum, uint16_t & year, uint8_t & month, uint8_t & day)`	`WEAVE_ERROR`
`FindNullifiedFieldsArray(void aStructureData, const SchemaFieldDescriptor aSchemaDescriptor, uint8_t *& aNullifiedFields)`	`WEAVE_ERROR` دالة مساعدة للعثور على موقع صفيف الحقول الفارغة في نهاية الهيكل C.
`FindStatusReportStr(uint32_t inProfileId, uint16_t inStatusCode)`	`const char *`
`FirstWeekdayOfYear(uint16_t year)`	`uint8_t`
`FormatError(char buf, uint16_t bufSize, const char subsys, int32_t err, const char *desc)`	`void` تنشئ سلسلة C NULL منتهية الصلاحية ويمكن لشخص عادي قراءتها، وهي تصف الخطأ المقدم.
`GetArrayElementSize(uint32_t & aOutSize, const FieldDescriptor *aFieldPtr, SerializedFieldType aType)`	`WEAVE_ERROR`
`GetFlag(const FlagsT & inFlags, const FlagT inFlag)`	`bool`
`IsBase34NoIOChar(char ch)`	`bool`
`IsLeapYear(uint16_t year)`	`bool`
`IsValidFieldType(SerializedFieldType aType)`	`bool`
`IsValidSerialNumber(const char *serialNum)`	`bool`
`LogEvent(TEvent *aEvent)`	`nl::Weave::Profiles::DataManagement::event_id_t`
`LogEvent(TEvent *aEvent, const nl::Weave::Profiles::DataManagement::EventOptions & aOptions)`	`nl::Weave::Profiles::DataManagement::event_id_t`
`ManufacturingWeekToDate(uint16_t mfgYear, uint8_t mfgWeek, uint16_t & year, uint8_t & month, uint8_t & day)`	`void`
`MarchBasedDayOfYearToMonth(uint16_t dayOfYear)`	`uint8_t`
`MarchBasedMonthToDayOfYear(uint8_t month)`	`uint16_t`
`NullifyAllEventFields(TEvent *aEvent)`	`void`
`OrdinalDateToCalendarDate(uint16_t year, uint16_t dayOfYear, uint8_t & month, uint8_t & dayOfMonth)`	`void`
`ReadDataForType(TLVReader & aReader, void aStructureData, const FieldDescriptor & aFieldPtr, SerializedFieldType aType, bool aInArray, SerializationContext *aContext)`	`WEAVE_ERROR` يشير ذلك المصطلح إلى دالة قارئ لقراءة إدخال معيّن من الملف النصي استنادًا إلى البيانات المنظَّمة.
`ReadNullableDataForType(TLVReader & aReader, void aStructureData, const FieldDescriptor & aFieldPtr, SerializedFieldType aType, bool & aIsNullified, SerializationContext *aContext)`	`WEAVE_ERROR` دالة قارئ للتحقق مما إذا كانت البيانات قابلة للقيم الفارغة أو ملغية قبل القراءة من TLV.
`RegisterErrorFormatter(ErrorFormatter *errFormatter)`	`NL_DLL_EXPORT void` إضافة دالة جديدة لتنسيق الأخطاء إلى القائمة العامة لأدوات تنسيق الأخطاء.
`SecondsSinceEpochToCalendarTime(uint32_t secondsSinceEpoch, uint16_t & year, uint8_t & month, uint8_t & dayOfMonth, uint8_t & hour, uint8_t & minute, uint8_t & second)`	`void`
`SerializedDataToTLVWriter(TLVWriter & aWriter, void aStructureData, const SchemaFieldDescriptor aFieldDescriptors)`	`WEAVE_ERROR` دالة كاتب لتحويل هيكل البيانات إلى هيكل TLV.
`SerializedDataToTLVWriterHelper(TLVWriter & aWriter, uint8_t aDataTag, void *aAppData)`	`WEAVE_ERROR` دالة كاتب برنامج تضمين تحيط بـ SerializedDataToTLVWriter بحاوية.
`SetFlag(FlagsT & inFlags, const FlagT inFlag)`	`void`
`SetFlag(FlagsT & inFlags, const FlagT inFlag, const bool inValue)`	`void`
`StatusReportStr(uint32_t profileId, uint16_t statusCode)`	`const char *`
`TLVReaderToDeserializedData(nl::Weave::TLV::TLVReader & aReader, void aStructureData, const SchemaFieldDescriptor aFieldDescriptors, SerializationContext *aContext)`	`WEAVE_ERROR` دالة قارئ لتحويل TLV إلى هيكل C.
`TLVReaderToDeserializedDataHelper(nl::Weave::TLV::TLVReader & aReader, uint8_t aDataTag, void aAppData, SerializationContext aContext)`	`WEAVE_ERROR` دالة مساعد تلغي تسلسل عنصر بيانات TLV واحد.
`WriteArrayData(TLVWriter & aWriter, void aStructureData, const FieldDescriptor aFieldPtr)`	`WEAVE_ERROR` دالة كاتب تكتب بنية صفيف.
`WriteDataForType(TLVWriter & aWriter, void aStructureData, const FieldDescriptor & aFieldPtr, SerializedFieldType aType, bool aInArray)`	`WEAVE_ERROR` تكتب الدالة الكاتبة إدخالاً محددًا في TLV بناءً على البيانات الهيكلية.
`WriteNullableDataForType(TLVWriter & aWriter, void aStructureData, const FieldDescriptor & aFieldPtr, SerializedFieldType aType, bool aIsNullified)`	`WEAVE_ERROR` دالة كاتبة للتحقق مما إذا كانت البيانات قابلة للقيم الفارغة أو ملغية قبل الكتابة إلى TLV.
`secondsToMilliseconds(uint32_t seconds)`	`uint32_t`

بُنى
nl::ArrayLengthAndBuffer	يشير ذلك المصطلح إلى مساعد لربط مصفوفة طولها.
nl::ErrorFormatter
nl::FieldDescriptor	يشير ذلك المصطلح إلى بنية تصف حقل TLV في هيكل مخطط وتربطه بالبيانات في هيكل c.
nl::إدارة الذاكرة	يشير ذلك المصطلح إلى هيكل c لدوال تخصيص أو تخصيص الذاكرة.
nl::SchemaFieldDescriptor	يمكنك إحاطة صفيفة من FieldDescriptor لوصف بنية المخطط أو بنيته.
nl::SerializationContext	يشير ذلك المصطلح إلى بنية c تحتوي على أي سياق أو حالة نحتاجها لإجراء تسلسل أو إلغاء التسلسل.
nl::SerializedByteString
nl::SerializedFieldTypeBoolean_array
nl::SerializedFieldTypeByteString_array
nl::SerializedFieldTypeFloatingPoint32_array
nl::SerializedFieldTypeFloatingPoint64_array
nl::SerializedFieldTypeInt16_array
nl::SerializedFieldTypeInt32_array
nl::SerializedFieldTypeInt64_array
nl::SerializedFieldTypeInt8_array
nl::SerializedFieldTypeUInt16_array
nl::SerializedFieldTypeUInt32_array
nl::SerializedFieldTypeUInt64_array
nl::SerializedFieldTypeUInt8_array
nl::SerializedFieldTypeUTF8String_array
nl::StructureSchemaPointerPair	زوج من البيانات مع هيكل c للبيانات وstructuredSchemaDescriptor لكتابة هيكل TLV بناءً على تلك البيانات.

مساحات الاسم
nl::ArgParser
nl::Ble	تتضمن مساحة الاسم هذه جميع الواجهات ضمن Weave لـ Bluetooth Low Energy (BLE)، والمعروفة أيضًا باسم Bluetooth Smart.
nl::Inet
nl::NestCerts	تتضمن مساحة الاسم هذه رموزًا عمومية لشهادات البنية التحتية للمفتاح العام (PKI) في Nest Weave.
nl::PairingCode
nl::تأثير دافئ
nl::Weave

عمليات التعداد

357@

 @357

358@

 @358

359@

 @359

@360

 @360

@361

 @361

SerializedFieldType

 SerializedFieldType

قائمة بأنواع TLV للكتابة باستخدام حقل TLV

أماكن إقامة
`SerializedFieldTypeArray`	نوع المصفوفة
`SerializedFieldTypeBoolean`	النوع المنطقي.
`SerializedFieldTypeByteString`	نوع سلسلة البايت
`SerializedFieldTypeFloatingPoint32`	نوع عائم 32 بت
`SerializedFieldTypeFloatingPoint64`	نوع عائم 64 بت
`SerializedFieldTypeInt16`	تم التوقيع من نوع 16 بت.
`SerializedFieldTypeInt32`	تم التوقيع من نوع 32 بت.
`SerializedFieldTypeInt64`	تم التوقيع من نوع 64 بت.
`SerializedFieldTypeInt8`	تم التوقيع من نوع 8 بت.
`SerializedFieldTypeStructure`	نوع البنية من تحديد المستخدم.
`SerializedFieldTypeUInt16`	نوع 16 بت غير موقَّع.
`SerializedFieldTypeUInt32`	نوع 32 بت غير موقَّع.
`SerializedFieldTypeUInt64`	نوع 64 بت غير موقَّع.
`SerializedFieldTypeUInt8`	نوع 8 بت غير موقَّع.
`SerializedFieldTypeUTF8String`	نوع سلسلة UTF-8.

SerializedFieldTypeBits

 SerializedFieldTypeBits

حقل Bitfield لـ SerializedFieldType.

SerializedFieldTypeMasks

 SerializedFieldTypeMasks

أقنعة للوصول إلى وحدات بت من SerializedFieldType.

تعريف الأنواع

Base64CharToValFunct

uint8_t(* Base64CharToValFunct)(uint8_t c)

Base64ValToCharFunct

char(* Base64ValToCharFunct)(uint8_t val)

MemoryAllocate

void *(* MemoryAllocate)(size_t size)

مؤشرات تخصيص الذاكرة/دالة مجانية.

MemoryFree

void(* MemoryFree)(void *ptr)

MemoryReallocate

void *(* MemoryReallocate)(void *ptr, size_t size)

المتغيرات

sASN1ErrorFormatter

const ErrorFormatter sASN1ErrorFormatter =
{
    nl::Weave::ASN1::FormatASN1Error,
    NULL
}

sElementSize

const uint8_t sElementSize[] =
{
    sizeof(bool),                   
    sizeof(uint8_t),                
    sizeof(uint16_t),               
    sizeof(uint32_t),               
    sizeof(uint64_t),               
    sizeof(int8_t),                 
    sizeof(int16_t),                
    sizeof(int32_t),                
    sizeof(int64_t),                
    sizeof(float),                  
    sizeof(double),                 
    sizeof(char *),                 
    sizeof(SerializedByteString),   
    sizeof(void *),                 
    sizeof(void *)                  
}

sErrorFormatterList

const ErrorFormatter * sErrorFormatterList = &sWeaveErrorFormatter

قائمة مرتبطة بدوال تنسيق الأخطاء

sErrorStr

char sErrorStr[WEAVE_CONFIG_ERROR_STR_SIZE]

تخزين مؤقت ثابت لتخزين سلسلة الخطأ المنسَّقة

sErrorStr

char sErrorStr[1024]

تعرض سلسلة الإجراءات هذه سلسلة C NULL منتهية ويمكن لشخص عادي قراءتها، وهي تصف رمز الحالة المتوفر والمرتبط بالملف الشخصي المحدد.

التفاصيل

المعلمات

`[in] profileId`	معرّف ملف Weave الشخصي المرتبط بـ .
`[in] statusCode`	رمز الحالة في profileId لتقديم سلسلة وصفية لها.

المرتجعات

مؤشر إلى سلسلة C منتهية الصلاحية فارغة تصف رمز الحالة المقدم داخل الملف الشخصي المحدد.

يُرجى الاطّلاع أيضًا على:
WEAVE_CONFIG_SHORT_ERROR_STR

sWeaveErrorFormatter

const ErrorFormatter sWeaveErrorFormatter =
{
    nl::Weave::FormatWeaveError,
    &sASN1ErrorFormatter
}

الدوال

AdjustCalendarDate

void AdjustCalendarDate(
  uint16_t & year,
  uint8_t & month,
  uint8_t & dayOfMonth,
  int32_t relativeDays
)

Base64CharToVal

uint8_t Base64CharToVal(
  uint8_t c
)

Base64Decode

uint16_t Base64Decode(
  const char *in,
  uint16_t inLen,
  uint8_t *out,
  Base64CharToValFunct charToValFunct
)

Base64Decode

uint16_t Base64Decode(
  const char *in,
  uint16_t inLen,
  uint8_t *out
)

Base64Decode32

uint32_t Base64Decode32(
  const char *in,
  uint32_t inLen,
  uint8_t *out,
  Base64CharToValFunct charToValFunct
)

Base64Decode32

uint32_t Base64Decode32(
  const char *in,
  uint32_t inLen,
  uint8_t *out
)

Base64Encode

uint16_t Base64Encode(
  const uint8_t *in,
  uint16_t inLen,
  char *out,
  Base64ValToCharFunct valToCharFunct
)

Base64Encode

uint16_t Base64Encode(
  const uint8_t *in,
  uint16_t inLen,
  char *out
)

Base64Encode32

uint32_t Base64Encode32(
  const uint8_t *in,
  uint32_t inLen,
  char *out,
  Base64ValToCharFunct valToCharFunct
)

Base64Encode32

uint32_t Base64Encode32(
  const uint8_t *in,
  uint32_t inLen,
  char *out
)

Base64URLCharToVal

uint8_t Base64URLCharToVal(
  uint8_t c
)

فك ترميز Base64URL

uint16_t Base64URLDecode(
  const char *in,
  uint16_t inLen,
  uint8_t *out
)

Base64URLEncode

uint16_t Base64URLEncode(
  const uint8_t *in,
  uint16_t inLen,
  char *out
)

Base64URLValToChar

char Base64URLValToChar(
  uint8_t val
)

Base64ValToChar

char Base64ValToChar(
  uint8_t val
)

CalendarDateToDaysSinceEpoch

bool CalendarDateToDaysSinceEpoch(
  uint16_t year,
  uint8_t month,
  uint8_t dayOfMonth,
  uint32_t & daysSinceEpoch
)

CalendarDateToOrdinalDate

void CalendarDateToOrdinalDate(
  uint16_t year,
  uint8_t month,
  uint8_t dayOfMonth,
  uint16_t & dayOfYear
)

CalendarTimeToSecondsSinceEpoch

bool CalendarTimeToSecondsSinceEpoch(
  uint16_t year,
  uint8_t month,
  uint8_t dayOfMonth,
  uint8_t hour,
  uint8_t minute,
  uint8_t second,
  uint32_t & secondsSinceEpoch
)

ClearFlag

void ClearFlag(
  FlagsT & inFlags,
  const FlagT inFlag
)

DateToManufacturingWeek

void DateToManufacturingWeek(
  uint16_t year,
  uint8_t month,
  uint8_t day,
  uint16_t & mfgYear,
  uint8_t & mfgWeek
)

DaysInMonth

uint8_t DaysInMonth(
  uint16_t year,
  uint8_t month
)

DaysSinceEpochToCalendarDate

void DaysSinceEpochToCalendarDate(
  uint32_t daysSinceEpoch,
  uint16_t & year,
  uint8_t & month,
  uint8_t & dayOfMonth
)

DaysToMarch1

uint8_t DaysToMarch1(
  uint16_t year
)

DeallocateDeserializedStructure

WEAVE_ERROR DeallocateDeserializedStructure(
  void *aStructureData,
  const SchemaFieldDescriptor *aFieldDescriptors,
  SerializationContext *aContext
)

ErrorStr

NL_DLL_EXPORT const char * ErrorStr(
  int32_t err
)

تعرض سلسلة الإجراءات هذه سلسلة C NULL منتهية ويمكن لشخص عادي قراءتها، وهي تصف الخطأ المقدم.

التفاصيل

المعلمات

[in] err

خطأ التنسيق والوصف.

المرتجعات

مؤشر إلى سلسلة C منتهية الصلاحية فارغة تصف الخطأ المقدم.

ExtractManufacturingDateFromSerialNumber

WEAVE_ERROR ExtractManufacturingDateFromSerialNumber(
  const char *serialNum,
  uint16_t & year,
  uint8_t & month,
  uint8_t & day
)

FindNullifiedFieldsArray

WEAVE_ERROR FindNullifiedFieldsArray(
  void *aStructureData,
  const SchemaFieldDescriptor *aSchemaDescriptor,
  uint8_t *& aNullifiedFields
)

دالة مساعدة للعثور على موقع صفيف الحقول الفارغة في نهاية الهيكل C.

من المتوقع أن يقع عضو nullified_fields في البنية C مباشرةً بعد آخر عضو موصوف بواسطة مصفوفة FieldDescriptors. وهي ليست في قائمة واصفات الحقول، لأنّه من المفترض أن تكون أداة مساعدة مخفية لصنّاع المحتوى ومستهلكي الأحداث القابلة للقيم الفارغة. عضو البنية هذا غير موجود للأحداث التي لا تحتوي على حقول قابلة للقيم الفارغة، ولكن من خلال إنشاء قيم الساطرات ودوال الاستدعاء، يجب ألا تحدث عمليات وصول خارج الحدود.

التفاصيل

المعلمات

`[in] aStructureData`	مؤشر للهيكل c.
`[in] aSchemaDescriptor`	SchemaFieldDescriptors لوصف البنية c.
`[out] aNullifiedFields`	مؤشر إلى عضو nullified_fields في البنية c.

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`WEAVE_ERROR_INVALID_ARGUMENT`	إذا كان مؤشر واصف الحقل فارغًا.
`WEAVE_ERROR_INCORRECT_STATE`	إذا لم يتطابق تنسيق واصفات الحقول مع التوقع.

FindStatusReportStr

const char * FindStatusReportStr(
  uint32_t inProfileId,
  uint16_t inStatusCode
)

FirstWeekdayOfYear

uint8_t FirstWeekdayOfYear(
  uint16_t year
)

FormatError

void FormatError(
  char *buf,
  uint16_t bufSize,
  const char *subsys,
  int32_t err,
  const char *desc
)

تنشئ سلسلة C تنهيها NULL ويمكن لشخص عادي قراءتها وتصف الخطأ المقدم.

التفاصيل

المعلمات

`[in] buf`	المخزن المؤقت الذي سيتم وضع سلسلة الخطأ فيه.
`[in] bufSize`	حجم المخزن المؤقت المقدم بالبايت.
`[in] subsys`	سلسلة قصيرة تصف النظام الفرعي الذي أنشأ الخطأ، أو NULL إذا كان مصدر الخطأ غير معروف/غير متاح. يجب أن تكون هذه السلسلة 10 أحرف أو أقل.
`[in] err`	الخطأ المطلوب تنسيقه.
`[in] desc`	سلسلة تصف سبب الخطأ أو معنىه، أو NULL إذا لم تتوفر هذه المعلومات.

GetArrayElementSize

WEAVE_ERROR GetArrayElementSize(
  uint32_t & aOutSize,
  const FieldDescriptor *aFieldPtr,
  SerializedFieldType aType
)

GetFlag

bool GetFlag(
  const FlagsT & inFlags,
  const FlagT inFlag
)

IsBase34NoIOChar

bool IsBase34NoIOChar(
  char ch
)

IsLeapYear

bool IsLeapYear(
  uint16_t year
)

IsValidFieldType

bool IsValidFieldType(
  SerializedFieldType aType
)

IsValidSerialNumber

bool IsValidSerialNumber(
  const char *serialNum
)

LogEvent

nl::Weave::Profiles::DataManagement::event_id_t LogEvent(
  TEvent *aEvent
)

LogEvent

nl::Weave::Profiles::DataManagement::event_id_t LogEvent(
  TEvent *aEvent,
  const nl::Weave::Profiles::DataManagement::EventOptions & aOptions
)

ManufacturingWeekToDate

void ManufacturingWeekToDate(
  uint16_t mfgYear,
  uint8_t mfgWeek,
  uint16_t & year,
  uint8_t & month,
  uint8_t & day
)

MarchBasedDayOfYearToMonth

uint8_t MarchBasedDayOfYearToMonth(
  uint16_t dayOfYear
)

MarchBasedMonthToDayOfYear

uint16_t MarchBasedMonthToDayOfYear(
  uint8_t month
)

NullifyAllEventFields

void NullifyAllEventFields(
  TEvent *aEvent
)

OrdinalDateToCalendarDate

void OrdinalDateToCalendarDate(
  uint16_t year,
  uint16_t dayOfYear,
  uint8_t & month,
  uint8_t & dayOfMonth
)

ReadDataForType

WEAVE_ERROR ReadDataForType(
  TLVReader & aReader,
  void *aStructureData,
  const FieldDescriptor *& aFieldPtr,
  SerializedFieldType aType,
  bool aInArray,
  SerializationContext *aContext
)

يشير ذلك المصطلح إلى دالة قارئ لقراءة إدخال معيّن من الملف النصي استنادًا إلى البيانات المنظَّمة.

التفاصيل

المعلمات

`[in] aReader`	القارئ الذي سيتم استخدامه للقراءة في البنية
`[in] aStructureData`	يشير هذا المصطلح إلى مؤشر يؤدي إلى بيانات البنية السينية (c) لقراءتها.
`[in,out] aFieldPtr`	FieldDescriptor لوصف الحقول وعلامة TLV. تزيد الدالة قيمة المؤشر s.t. سيشير إلى العنصر التالي في صفيفة FieldDescritor
`[in] aType`	نوع الحقل SerializedFieldType
`[in] aInArray`	صحيح إذا كنا نقرأ صفيفًا (استخدم علامة مجهولة)
`[in] aContext`	سياق التسلسل الذي يتضمن أي حالة مطلوبة للعملية

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aReader.

ReadNullableDataForType

WEAVE_ERROR ReadNullableDataForType(
  TLVReader & aReader,
  void *aStructureData,
  const FieldDescriptor *& aFieldPtr,
  SerializedFieldType aType,
  bool & aIsNullified,
  SerializationContext *aContext
)

دالة قارئ للتحقق مما إذا كانت البيانات قابلة للقيم الفارغة أو ملغية قبل القراءة من TLV.

التفاصيل

المعلمات

`[in] aReader`	القارئ الذي سيتم استخدامه للقراءة في البنية
`[in] aStructureData`	يشير هذا المصطلح إلى مؤشر يؤدي إلى بيانات البنية السينية (c) لقراءتها.
`[in,out] aFieldPtr`	FieldDescriptor لوصف الحقول وعلامة TLV. تزيد الدالة قيمة المؤشر s.t. سيشير إلى العنصر التالي في المصفوفة FieldDescriptor.
`[in] aType`	نوع الحقل SerializedFieldType
`[out] aIsNullified`	يتم ضبطها للإشارة إلى أنّه قد تم إبطال أحد الحقول.
`[in] aContext`	سياق التسلسل الذي يتضمن أي حالة مطلوبة للعملية

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	أخطاء TLV أثناء الكتابة.

RegisterErrorFormatter

NL_DLL_EXPORT void RegisterErrorFormatter(
  ErrorFormatter *errFormatter
)

إضافة دالة جديدة لتنسيق الأخطاء إلى القائمة العامة لأدوات تنسيق الأخطاء.

التفاصيل

المعلمات

[in] errFormatter

بنية ErrorFormatter التي تحتوي على مؤشر إلى دالة الخطأ الجديدة تجدر الإشارة إلى أنّ الدالة ستحتفظ بالمؤشر الذي يؤدي إلى بنية ErrorFormatter المُقدَّمة. وبالتالي، يجب أن تبقى ذاكرة البنية محجوزة.

SecondsSinceEpochToCalendarTime

void SecondsSinceEpochToCalendarTime(
  uint32_t secondsSinceEpoch,
  uint16_t & year,
  uint8_t & month,
  uint8_t & dayOfMonth,
  uint8_t & hour,
  uint8_t & minute,
  uint8_t & second
)

SerializedDataToTLVWriter

WEAVE_ERROR SerializedDataToTLVWriter(
  TLVWriter & aWriter,
  void *aStructureData,
  const SchemaFieldDescriptor *aFieldDescriptors
)

دالة كاتب لتحويل هيكل البيانات إلى هيكل TLV.

تستخدم SchemaFieldDescriptor لتفسير بنية البيانات والكتابة في ملف TLV.

التفاصيل

المعلمات

`[in] aWriter`	الكاتب الذي يجب استخدامه لكتابة الهيكل
`[in] aStructureData`	مؤشر إلى بيانات البنية c للكتابة استنادًا إلى SchemaFieldDescriptor
`[in] aFieldDescriptors`	SchemaFieldDescriptors لوصف البنية c + TLV

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aWriter.

SerializedDataToTLVWriterHelper

WEAVE_ERROR SerializedDataToTLVWriterHelper(
  TLVWriter & aWriter,
  uint8_t aDataTag,
  void *aAppData
)

دالة كاتب برنامج تضمين تحيط بـ SerializedDataToTLVWriter بحاوية.

تعمل أيضًا على تقسيم StructureSchemaPointerPair إلى بيانات بنية وأدوات وصف لتمريرها.

التفاصيل

المعلمات

`[in] aWriter`	الكاتب الذي يجب استخدامه لكتابة الهيكل
`[in] aDataTag`	وضع علامة للكتابة
`[in] aAppData`	StructureSchemaPointerPair تضمّ مؤشرًا لتنظيم البيانات وأدوات وصف الحقول. فارغ* بسبب النموذج الأوّلي

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aWriter.

SetFlag

void SetFlag(
  FlagsT & inFlags,
  const FlagT inFlag
)

SetFlag

void SetFlag(
  FlagsT & inFlags,
  const FlagT inFlag,
  const bool inValue
)

StatusReportStr

const char * StatusReportStr(
  uint32_t profileId,
  uint16_t statusCode
)

TLVReaderToDeserializedData

WEAVE_ERROR TLVReaderToDeserializedData(
  nl::Weave::TLV::TLVReader & aReader,
  void *aStructureData,
  const SchemaFieldDescriptor *aFieldDescriptors,
  SerializationContext *aContext
)

دالة قارئ لتحويل TLV إلى هيكل C.

تستخدم SchemaFieldDescriptor لتفسير بنية البيانات.

ويجب أن يكون قويًا سواء من أجل جذب حقول غير معروفة أو عدم مواجهة حقل متوقع.

التفاصيل

المعلمات

`[in] aReader`	القارئ الذي سيتم استخدامه للقراءة في البيانات
`[in] aStructureData`	يشير إلى بيانات البنية c الوجهة التي سنقرأها استنادًا إلى SchemaFieldDescriptor.
`[in] aFieldDescriptors`	SchemaFieldDescriptors لوصف البنية c + TLV
`[in] aContext`	سياق التسلسل الذي يتضمن أي حالة مطلوبة للعملية

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي قد يتم عرضها من aReader.

TLVReaderToDeserializedDataHelper

WEAVE_ERROR TLVReaderToDeserializedDataHelper(
  nl::Weave::TLV::TLVReader & aReader,
  uint8_t aDataTag,
  void *aAppData,
  SerializationContext *aContext
)

دالة مساعد تلغي تسلسل عنصر بيانات TLV واحد.

تقسّم الدالة StructureSchemaPointerPair إلى بيانات بنية وأدوات وصف لتمريرها إلى ReadDataForType.

التفاصيل

المعلمات

`[in] aReader`	القارئ الذي يحتوي على البيانات المطلوب إلغاء تسلسلها
`[in] aDataTag`	غير مُستخدَم في الوقت الحالي
`[in] aAppData`	StructureSchemaPointerPair تضمّ مؤشرًا لتنظيم البيانات وأدوات وصف الحقول. فارغ* بسبب النموذج الأوّلي
`[in] aContext`	سياق التسلسل الذي يتضمن أي حالة مطلوبة للعملية

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aReader.

WriteArrayData

WEAVE_ERROR WriteArrayData(
  TLVWriter & aWriter,
  void *aStructureData,
  const FieldDescriptor *aFieldPtr
)

دالة كاتب تكتب بنية صفيف.

التفاصيل

المعلمات

`[in] aWriter`	الكاتب الذي يجب استخدامه لكتابة الهيكل
`[in] aStructureData`	مؤشر إلى بيانات البنية c للكتابة استنادًا إلى FieldDescriptor
`[in] aFieldPtr`	FieldDescriptor لوصف بنية الصفيفة c + TLV

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aWriter.

WriteDataForType

WEAVE_ERROR WriteDataForType(
  TLVWriter & aWriter,
  void *aStructureData,
  const FieldDescriptor *& aFieldPtr,
  SerializedFieldType aType,
  bool aInArray
)

تكتب الدالة الكاتبة إدخالاً محددًا في TLV بناءً على البيانات الهيكلية.

التفاصيل

المعلمات

`[in] aWriter`	الكاتب الذي يجب استخدامه لكتابة الهيكل
`[in] aStructureData`	يشير هذا المصطلح إلى مؤشر لبيانات البنية السينية (c) لكتابة.
`[in,out] aFieldPtr`	FieldDescriptor لوصف الحقول وعلامة TLV. تزيد الدالة قيمة المؤشر s.t. سيشير إلى العنصر التالي في صفيفة FieldDescritor
`[in] aType`	نوع الحقل SerializedFieldType
`[in] aInArray`	True إذا كنا نكتب صفيفًا (استخدم علامة مجهولة)

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	الأخطاء الأخرى التي يتم إرجاعها من aWriter.

WriteNullableDataForType

WEAVE_ERROR WriteNullableDataForType(
  TLVWriter & aWriter,
  void *aStructureData,
  const FieldDescriptor *& aFieldPtr,
  SerializedFieldType aType,
  bool aIsNullified
)

دالة كاتبة للتحقق مما إذا كانت البيانات قابلة للقيم الفارغة أو ملغية قبل الكتابة إلى TLV.

التفاصيل

المعلمات

`[in] aWriter`	الكاتب الذي يجب استخدامه لكتابة الهيكل
`[in] aStructureData`	يشير هذا المصطلح إلى مؤشر يؤدي إلى بيانات البنية السينية (c) لقراءتها.
`[in,out] aFieldPtr`	FieldDescriptor لوصف الحقول وعلامة TLV. تزيد الدالة قيمة المؤشر s.t. سيشير إلى العنصر التالي في المصفوفة FieldDescriptor.
`[in] aType`	نوع الحقل SerializedFieldType
`[in] aIsNullified`	سيتم إبطال العلامة TLV إذا كان هذا صحيحًا.

قيم الإرجاع

`WEAVE_NO_ERROR`	عند النجاح.
`other`	أخطاء TLV أثناء الكتابة.

secondsToMilliseconds

uint32_t secondsToMilliseconds(
  uint32_t seconds
)

nl

ملخّص

عمليات التعداد

تعريف الأنواع

المتغيرات

الدوال

بُنى

مساحات الاسم

عمليات التعداد

357@

358@

359@

@360

@361

SerializedFieldType

SerializedFieldTypeBits

SerializedFieldTypeMasks

تعريف الأنواع

Base64CharToValFunct

Base64ValToCharFunct

MemoryAllocate

MemoryFree

MemoryReallocate

المتغيرات

sASN1ErrorFormatter

sElementSize

sErrorFormatterList

sErrorStr

sErrorStr

sWeaveErrorFormatter

الدوال

AdjustCalendarDate

Base64CharToVal

Base64Decode

Base64Decode

Base64Decode32

Base64Decode32

Base64Encode

Base64Encode

Base64Encode32

Base64Encode32

Base64URLCharToVal

فك ترميز Base64URL

Base64URLEncode

Base64URLValToChar

Base64ValToChar

CalendarDateToDaysSinceEpoch

CalendarDateToOrdinalDate

CalendarTimeToSecondsSinceEpoch

ClearFlag

DateToManufacturingWeek

DaysInMonth

DaysSinceEpochToCalendarDate

DaysToMarch1

DeallocateDeserializedStructure

ErrorStr

ExtractManufacturingDateFromSerialNumber

FindNullifiedFieldsArray

FindStatusReportStr

FirstWeekdayOfYear

FormatError

GetArrayElementSize

GetFlag

IsBase34NoIOChar

IsLeapYear

IsValidFieldType

IsValidSerialNumber

LogEvent

LogEvent

ManufacturingWeekToDate

MarchBasedDayOfYearToMonth

MarchBasedMonthToDayOfYear

NullifyAllEventFields

OrdinalDateToCalendarDate

ReadDataForType

ReadNullableDataForType

RegisterErrorFormatter

SecondsSinceEpochToCalendarTime

SerializedDataToTLVWriter

SerializedDataToTLVWriterHelper