nl::Weave::Encoding::LittleEndian

توفر مساحة الاسم هذه دوال لما يلي:

ملخّص

  • إجراء إعادة ترتيب البايت بالنسبة إلى النظام المضيف من خلال قيمة قيم بايت النهاية الصغيرة المرتّبة للأنواع 16 و32 و64 بت.
  • إجراء عمليات وصول بسيطة وفعّالة على مستوى الذاكرة، من المحتمل أن تكون إلى مواقع ذاكرة غير متوافقة، مع إعادة ترتيب البايت أو بدونها، إلى كميات صغيرة من 8 و16 و32 و64 بت مرتّبة بايت صغيرة، سواء مع إدارة المؤشر أو بدونها.

في أنظمة المضيف الصغيرة، لا تحدث إعادة ترتيب وحدات بايت فعلية. في الأنظمة الأخرى، يتم إجراء إعادة ترتيب البايت على النحو المناسب.

الدوال
Get16(const uint8_t *p)
uint16_t
نفِّذ قراءة ذاكرة من المحتمل أن تكون غير متوافقة مع قيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدَف.
Get32(const uint8_t *p)
uint32_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان البايت النهائي الصغير من عنوان المؤشر المحدّد، ثم نفِّذ إعادة ترتيب البايت حسب الضرورة للنظام الهدف لوضع القيمة في ترتيب بايت النظام الهدف.
Get64(const uint8_t *p)
uint64_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدّد، ونفِّذ إعادة ترتيب البايت حسب الضرورة للنظام الهدف لوضع القيمة في ترتيب بايت النظام الهدف.
HostSwap16(uint16_t v)
uint16_t
يؤدي هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 16 بت المحددة، بافتراض أن يكون ترتيب البايت الصغير في النظام المستهدف (أي
HostSwap32(uint32_t v)
uint32_t
وينفذ هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 32 بت المحددة، بافتراض أنه يتم ترتيب البايت الصغير في النظام المستهدف (أي
HostSwap64(uint64_t v)
uint64_t
يؤدي هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 64 بت المحددة، بافتراض أن يكون ترتيب البايت الصغير في النظام المستهدف (أي
Put16(uint8_t *p, uint16_t v)
void
نفِّذ عملية كتابة للذاكرة، يُحتمل أن تكون غير متوافقة، من نظام بايت النظام المستهدف الذي تم طلبه بقيمة 16 بت إلى عنوان المؤشر المحدد، ونفّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت النهائي الصغير.
Put32(uint8_t *p, uint32_t v)
void
نفِّذ كتابة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت الخاصة بالنظام الهدف في عنوان المؤشر المحدَّد، ثم إعادة ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.
Put64(uint8_t *p, uint64_t v)
void
نفِّذ كتابة ذاكرة، من المحتمل أن تكون غير متوافقة، لقيمة 64 بت في النظام الهدف لعنوان المؤشر المحدَّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.
Read16(uint8_t *& p)
uint16_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدد، ثم أعد ترتيب البايت، حسب الضرورة، لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، وزيادة المؤشر بمقدار 16 بت (2 بايت).
Read16(const uint8_t *& p)
uint16_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدد، ثم أعد ترتيب البايت، حسب الضرورة، لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، وزيادة المؤشر بمقدار 16 بت (2 بايت).
Read32(uint8_t *& p)
uint32_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان المؤشر المحدد، وحسب الضرورة، حتى يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ثم يزيد المؤشر بمقدار 32 بت (4 بايت).
Read32(const uint8_t *& p)
uint32_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان المؤشر المحدد، وحسب الضرورة، حتى يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ثم يزيد المؤشر بمقدار 32 بت (4 بايت).
Read64(uint8_t *& p)
uint64_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدد، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت المستهدف للنظام، وزيادة المؤشر بمقدار 64 بت (8 بايت).
Read64(const uint8_t *& p)
uint64_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدد، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت المستهدف للنظام، وزيادة المؤشر بمقدار 64 بت (8 بايت).
Write16(uint8_t *& p, uint16_t v)
void
نفِّذ عملية كتابة للذاكرة، يُحتمل أن تكون غير متوافقة، من نظام بايت النظام المستهدف الذي تم طلبه بقيمة 16 بت إلى عنوان المؤشر المحدد، ونفّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت النهائي الصغير.
Write32(uint8_t *& p, uint32_t v)
void
نفِّذ كتابة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت الخاصة بالنظام الهدف في عنوان المؤشر المحدَّد، ثم إعادة ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.
Write64(uint8_t *& p, uint64_t v)
void
نفِّذ كتابة ذاكرة، من المحتمل أن تكون غير متوافقة، لقيمة 64 بت في النظام الهدف لعنوان المؤشر المحدَّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.

الدوال

Get16

uint16_t Get16(
  const uint8_t *p
)

نفِّذ قراءة ذاكرة من المحتمل أن تكون غير متوافقة مع قيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدَف.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، من المحتمل عدم محاذاة هذا العنوان، لقراءة قيمة بايت النهاية الصغيرة ذات 16 بت التي تم ترتيبها من خلالها.
المرتجعات
قيمة 16 بت في عنوان المؤشر المحدد، إذا لزم الأمر، تمت إعادة ترتيب البايت.

Get32

uint32_t Get32(
  const uint8_t *p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان البايت النهائي الصغير من عنوان المؤشر المحدّد، ثم نفِّذ إعادة ترتيب البايت حسب الضرورة للنظام الهدف لوضع القيمة في ترتيب بايت النظام الهدف.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، قد لا تتم محاذاته، لقراءة قيمة بايت النهاية الصغيرة ذات 32 بت المطلوبة منها.
المرتجعات
قيمة 32 بت في عنوان المؤشر المحدد، إذا لزم الأمر، تمت إعادة ترتيب البايت.

Get64

uint64_t Get64(
  const uint8_t *p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدّد، ونفِّذ إعادة ترتيب البايت حسب الضرورة للنظام الهدف لوضع القيمة في ترتيب بايت النظام الهدف.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، قد لا تتم محاذاته، لقراءة قيمة بايت النهاية الصغيرة 64 بت المطلوبة منها.
المرتجعات
قيمة 64 بت في عنوان المؤشر المحدد، إذا لزم الأمر، تمت إعادة ترتيب البايت.

HostSwap16

uint16_t HostSwap16(
  uint16_t v
)

يؤدي هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 16 بت المحددة، بافتراض أن يكون ترتيب البايت الصغير في النظام المستهدف (أي

المضيف) ترتيب البايت.

وبالتالي، في أنظمة الاستهداف الداخلية الصغيرة، يعتبر هذا الأمر بيئة مستقلة، وفي أنظمة الاستهداف النهائي الكبيرة، يؤدي ذلك إلى إعادة الترتيب.

التفاصيل
المَعلمات
[in] v
قيمة 16 بت المطلوب تبديلها بترتيب البايت.
المرتجعات
قيمة الإدخال، إذا لزم الأمر، تم تبديل ترتيب البايت.

HostSwap32

uint32_t HostSwap32(
  uint32_t v
)

وينفذ هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 32 بت المحددة، بافتراض أنه يتم ترتيب البايت الصغير في النظام المستهدف (أي

المضيف) ترتيب البايت.

وبالتالي، في أنظمة الاستهداف الداخلية الصغيرة، يعتبر هذا الأمر بيئة مستقلة، وفي أنظمة الاستهداف النهائي الكبيرة، يؤدي ذلك إلى إعادة الترتيب.

التفاصيل
المَعلمات
[in] v
قيمة 32 بت المطلوب تبديلها بترتيب البايت.
المرتجعات
قيمة الإدخال، إذا لزم الأمر، تم تبديل ترتيب البايت.

HostSwap64

uint64_t HostSwap64(
  uint64_t v
)

يؤدي هذا بشكل مشروط، حسب الضرورة للنظام المستهدف، تبديل ترتيب البايت بقيمة 64 بت المحددة، بافتراض أن يكون ترتيب البايت الصغير في النظام المستهدف (أي

المضيف) ترتيب البايت.

وبالتالي، في أنظمة الاستهداف الداخلية الصغيرة، يعتبر هذا الأمر بيئة مستقلة، وفي أنظمة الاستهداف النهائي الكبيرة، يؤدي ذلك إلى إعادة الترتيب.

التفاصيل
المَعلمات
[in] v
قيمة 64 بت المطلوب تبديلها بترتيب البايت.
المرتجعات
قيمة الإدخال، إذا لزم الأمر، تم تبديل ترتيب البايت.

Put16

void Put16(
  uint8_t *p,
  uint16_t v
)

نفِّذ عملية كتابة للذاكرة، يُحتمل أن تكون غير متوافقة، من نظام بايت النظام المستهدف الذي تم طلبه بقيمة 16 بت إلى عنوان المؤشر المحدد، ونفّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، من المحتمل عدم محاذاة هذا العنوان، لكتابة قيمة 16 بت للنظام المستهدف التي تم طلبها بترتيب وحدات بايت صغيرة.
[in] v
قيمة 16 بت لكتابة، إذا لزم الأمر، إعادة ترتيب البايت.

Put32

void Put32(
  uint8_t *p,
  uint32_t v
)

نفِّذ كتابة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت الخاصة بالنظام الهدف في عنوان المؤشر المحدَّد، ثم إعادة ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، من المحتمل عدم محاذاة هذا العنوان، لكتابة قيمة 32 بت الخاصة بالنظام المستهدف مرتبة في ترتيب بايت صغير.
[in] v
قيمة 32 بت لكتابة، إذا لزم الأمر، إعادة ترتيب البايت.

Put64

void Put64(
  uint8_t *p,
  uint64_t v
)

نفِّذ كتابة ذاكرة، من المحتمل أن تكون غير متوافقة، لقيمة 64 بت في النظام الهدف لعنوان المؤشر المحدَّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
عنوان مؤشر، من المحتمل عدم محاذاة هذا العنوان، لكتابة قيمة 64 بت للنظام المستهدف التي تم طلبها بترتيب وحدات بايت صغيرة.
[in] v
قيمة 64 بت لكتابة البايت عند الضرورة.

Read16

uint16_t Read16(
  uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدد، ثم أعد ترتيب البايت، حسب الضرورة، لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، وزيادة المؤشر بمقدار 16 بت (2 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر، يُحتمل عدم محاذاة هذا الجزء، لقراءة قيمة بايت النهاية الصغيرة ذات 16 بت التي تم ترتيبها، ثم الزيادة بمقدار 16 بت (2 بايت).
المرتجعات
قيمة 16 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Read16

uint16_t Read16(
  const uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 16 بت ذات ترتيب 16 بت من البايت النهائي الصغير من عنوان المؤشر المحدد، ثم أعد ترتيب البايت، حسب الضرورة، لكي يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، وزيادة المؤشر بمقدار 16 بت (2 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر ثابت، يُحتمل عدم محاذاة، لقراءة قيمة بايت النهاية الصغيرة 16 بت المطلوبة من ثم للزيادة بمقدار 16 بت (2 بايت).
المرتجعات
قيمة 16 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Read32

uint32_t Read32(
  uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان المؤشر المحدد، وحسب الضرورة، حتى يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ثم يزيد المؤشر بمقدار 32 بت (4 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر، قد لا تتم محاذاته، لقراءة قيمة بايت النهاية الصغيرة 32 بت المطلوبة من ثم للزيادة بمقدار 32 بت (4 بايت).
المرتجعات
قيمة 32 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Read32

uint32_t Read32(
  const uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت المرتبة 32 بت من عنوان المؤشر المحدد، وحسب الضرورة، حتى يضع النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ثم يزيد المؤشر بمقدار 32 بت (4 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر ثابت، ربما يكون غير منضبط، لقراءة قيمة بايت النهاية الصغيرة 32 بت المطلوبة منها والزيادة بعد ذلك بمقدار 32 بت (4 بايت).
المرتجعات
قيمة 32 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Read64

uint64_t Read64(
  uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدد، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت المستهدف للنظام، وزيادة المؤشر بمقدار 64 بت (8 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر، يُحتمل عدم محاذاة، لقراءة قيمة بايت النهاية الصغيرة 64 بت المطلوبة من ثم للزيادة بمقدار 64 بت (8 بايت).
المرتجعات
قيمة 64 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Read64

uint64_t Read64(
  const uint8_t *& p
)

نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 64 بت المرتبة 64 بت للبايت النهائي الصغير من عنوان المؤشر المحدد، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت المستهدف للنظام، وزيادة المؤشر بمقدار 64 بت (8 بايت).

التفاصيل
المَعلمات
[in,out] p
مرجع إلى عنوان مؤشر ثابت، ربما يكون غير منضبط، لقراءة قيمة بايت النهاية الصغيرة 64 بت المطلوبة منها والزيادة بعد ذلك بمقدار 64 بت (8 بايت).
المرتجعات
قيمة 64 بت في عنوان المؤشر المحدّد، إذا لزم الأمر، تم تبديل ترتيب البايت.

Write16

void Write16(
  uint8_t *& p,
  uint16_t v
)

نفِّذ عملية كتابة للذاكرة، يُحتمل أن تكون غير متوافقة، من نظام بايت النظام المستهدف الذي تم طلبه بقيمة 16 بت إلى عنوان المؤشر المحدد، ونفّذ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
يشير ذلك المصطلح إلى مرجع إلى عنوان مؤشر، من المحتمل عدم محاذاة هذا العنوان لكتابة قيمة 16 بت للنظام المستهدف التي تم ترتيبها وترتيبها حسب ترتيب البايت النهائي الصغير ثم زيادة بمقدار 16 بت (2 بايت).
[in] v
قيمة 16 بت لكتابة ترتيب البايت عند الضرورة.

Write32

void Write32(
  uint8_t *& p,
  uint32_t v
)

نفِّذ كتابة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 32 بت الخاصة بالنظام الهدف في عنوان المؤشر المحدَّد، ثم إعادة ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
مرجع إلى عنوان مؤشر، ربما لا تتم محاذاته، لكتابة قيمة 32 بت للنظام المستهدف مرتبة 32 بت إلى ترتيب بايت صغير ثم الزيادة بعد ذلك بمقدار 32 بت (4 بايت).
[in] v
قيمة 32 بت لكتابة ترتيب البايت عند الضرورة.

Write64

void Write64(
  uint8_t *& p,
  uint64_t v
)

نفِّذ كتابة ذاكرة، من المحتمل أن تكون غير متوافقة، لقيمة 64 بت في النظام الهدف لعنوان المؤشر المحدَّد، ثم أعِد ترتيب البايت حسب الضرورة لكي يضع النظام الهدف القيمة في ترتيب البايت النهائي الصغير.

التفاصيل
المَعلمات
[in] p
مرجع إلى عنوان مؤشر، يُحتمل عدم محاذاة، لكتابة قيمة 64 بت للنظام المستهدف مرتبة 64 بت إلى ترتيب بايت صغير ثم الزيادة بعد ذلك بمقدار 64 بت (8 بايت).
[in] v
قيمة 64 بت لكتابة ترتيب البايت عند الضرورة.