nl::Weave::Encoding::BigEndian

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

ملخّص

  • إجراء إعادة ترتيب البايت، بالنسبة إلى النظام المضيف، حسب قيمة قيم البايت النهائي الكبير المُرتَّبة للأنواع 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 بت المطلوب استخدامها لكتابة ترتيب البايت، إذا لزم الأمر.