nl::Weave::Encoding::LittleEndian

توفّر مساحة الاسم هذه دوال من أجل:

ملخّص

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

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

الدوال
Get16(const uint8_t *p)
uint16_t
إجراء قراءة لذاكرة وحدة البايت الطرفية الصغيرة مرتَّبة بقيمة 16 بت من عنوان المؤشر المحدد، وقد تكون غير متوافقة، ثم تنفيذ إعادة ترتيب البايت عند اللزوم، لكي يضع النظام المستهدف القيمة في ترتيب بايت النظام المستهدف.
Get32(const uint8_t *p)
uint32_t
إجراء قراءة لذاكرة وحدة البايت النهائية الصغيرة المرتبة 32 بت من عنوان المؤشر المحدد، والتي يُحتمل أن تكون غير متوافقة، ثم تنفيذ إعادة ترتيب البايت عند اللزوم، لكي يضع النظام المستهدف القيمة في ترتيب بايت النظام المستهدف.
Get64(const uint8_t *p)
uint64_t
إجراء قراءة لذاكرة وحدة البايت النهائية الصغيرة المرتبة 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 بت (2 بايت).
Read16(const uint8_t *& p)
uint16_t
أجرِ قراءة لذاكرة وحدة البايت النهائية الصغيرة مُرتبة بقيمة 16 بت من عنوان المؤشر المحدد، يُحتمل أن تكون غير متوافقة، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، لكي يضبط النظام الهدف القيمة في ترتيب بايت النظام المستهدف، وزيادة المؤشر بمقدار 16 بت (2 بايت).
Read32(uint8_t *& p)
uint32_t
أجرِ قراءة لذاكرة البايت النهائية الصغيرة مُرتبة بقيمة 32 بت من عنوان المؤشر المحدد، يُحتمل أن تكون غير متوافقة، ونفِّذ إعادة ترتيب البايت عند اللزوم لكي يضبط النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ويزيد المؤشر بمقدار 32 بت (4 بايت).
Read32(const uint8_t *& p)
uint32_t
أجرِ قراءة لذاكرة البايت النهائية الصغيرة مُرتبة بقيمة 32 بت من عنوان المؤشر المحدد، يُحتمل أن تكون غير متوافقة، ونفِّذ إعادة ترتيب البايت عند اللزوم لكي يضبط النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ويزيد المؤشر بمقدار 32 بت (4 بايت).
Read64(uint8_t *& p)
uint64_t
أجرِ قراءة لذاكرة البايت النهائية الصغيرة مُرتبة بقيمة 64 بت من عنوان المؤشر المحدد، يُحتمل أن تكون غير متوافقة، ونفِّذ إعادة ترتيب البايت، حسب الضرورة، لكي يضبط النظام الهدف القيمة في ترتيب بايت النظام المستهدف، ويزيد المؤشر بمقدار 64 بت (8 بايت).
Read64(const uint8_t *& p)
uint64_t
أجرِ قراءة لذاكرة البايت النهائية الصغيرة مُرتبة بقيمة 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 بت من عنوان المؤشر المحدد، وقد تكون غير متوافقة، ثم تنفيذ إعادة ترتيب البايت عند اللزوم، لكي يضع النظام المستهدف القيمة في ترتيب بايت النظام المستهدف.

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

Get32

uint32_t Get32(
  const uint8_t *p
)

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

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

Get64

uint64_t Get64(
  const uint8_t *p
)

إجراء قراءة لذاكرة وحدة البايت النهائية الصغيرة المرتبة 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 بت (2 بايت).

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

Read16

uint16_t Read16(
  const uint8_t *& p
)

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

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

Read32

uint32_t Read32(
  uint8_t *& p
)

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

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

Read32

uint32_t Read32(
  const uint8_t *& p
)

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

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

Read64

uint64_t Read64(
  uint8_t *& p
)

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

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

Read64

uint64_t Read64(
  const uint8_t *& p
)

أجرِ قراءة لذاكرة البايت النهائية الصغيرة مُرتبة بقيمة 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 بت (4 بايت).
[in] v
قيمة 32 بت المطلوبة لكتابة ترتيب بايت، إذا لزم الأمر.

Write64

void Write64(
  uint8_t *& p,
  uint64_t v
)

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

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