nl::Weave::Encoding::BigEndian

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

ملخّص

  • إجراء إعادة ترتيب وحدات البايت بالنسبة إلى النظام المضيف من خلال قيمة قيم بايت النهاية الكبيرة للأنواع 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 بت (2 بايت).
Read16(const uint8_t *& p)
uint16_t
نفِّذ قراءة ذاكرة، يُحتمل أن تكون غير متوافقة، لقيمة 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 بت (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 بت ذات ترتيب 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 بت (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 بت من عنوان المؤشر المحدد، وأجرِ إعادة ترتيب البايت، حسب الضرورة، للنظام الهدف لوضع القيمة في ترتيب البايت المستهدف للنظام، وزيادة المؤشر بمقدار 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 بت (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 بت في ترتيب البايت النهائي الكبير ثم زيادة بمقدار 32 بت (4 بايت).
[in] v
قيمة 32 بت لكتابة ترتيب البايت عند الضرورة.

Write64

void Write64(
  uint8_t *& p,
  uint64_t v
)

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

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