__sptr、__uptr

Microsoft 特定的

__sptr在 32 位指標宣告上使用 或 __uptr 修飾詞，以指定編譯器如何將 32 位指標轉換成 64 位指標。 例如，將 32 位元指標指派給 64 位元指標變數，或在 64 位元平台取值時，就會轉換 32 位元指標。

有關 64 位元平台支援的 Microsoft 文件有時會將 32 位元指標的最高有效位元稱為正負號位元。 根據預設，編譯器會使用正負號擴充項目將 32 位元指標轉換為 64 位元指標。 也就是說，64 位元指標的最低有效 32 位元設為 32 位元指標的值，而最高有效 32 位元則設為 32 位元指標的正負號位元的值。 如果正負號位元是 0，此類轉換會產生正確的結果，如果正負號位元是 1，則不會產生正確結果。 例如，32 位元位址 0x7FFFFFFF 會產生相等的 64 位元位址 0x000000007FFFFFFF，但會將 32 位元位址 0x80000000 錯誤地變更為 0xFFFFFFFF80000000。

__sptr或帶正負號指標修飾詞會指定指標轉換會將 64 位指標的最大有效位設定為 32 位指標的符號位。 、 __uptr 或不帶正負號的指標修飾詞會指定轉換會將最重要的位設定為零。 下列宣告顯示 __sptr__uptr 與 修飾詞搭配兩個不合格的指標、兩個具有__ptr32 型別限定的指標 ，以及函式參數。

int * __sptr psp;
int * __uptr pup;
int * __ptr32 __sptr psp32;
int * __ptr32 __uptr pup32;
void MyFunction(char * __uptr __ptr32 myValue);

搭配 __sptr 指標宣告使用 和 __uptr 修飾詞。 使用指標類型限定 符位置的 修飾詞，這表示修飾詞必須遵循星號。 您無法使用修飾詞搭配 成員 的指標。 修飾詞不影響非指標宣告。

為了與舊版相容， 除非指定編譯器選項 /Za（停用語言延伸模組）， 否則_sptr 和 _uptr 是 和 __uptr 的 __sptr 同義字。

範例

下列範例會宣告使用 和 __uptr 修飾詞的 __sptr 32 位指標、將每個 32 位指標指派給 64 位指標變數，然後顯示每個 64 位指標的十六進位值。 此範例是以原生 64 位元編譯器編譯，並且在 64 位元平台上執行。

// sptr_uptr.cpp
// processor: x64
#include "stdio.h"

int main()
{
    void *        __ptr64 p64;
    void *        __ptr32 p32d; //default signed pointer
    void * __sptr __ptr32 p32s; //explicit signed pointer
    void * __uptr __ptr32 p32u; //explicit unsigned pointer

// Set the 32-bit pointers to a value whose sign bit is 1.
    p32d = reinterpret_cast<void *>(0x87654321);
    p32s = p32d;
    p32u = p32d;

// The printf() function automatically displays leading zeroes with each 32-bit pointer. These are unrelated
// to the __sptr and __uptr modifiers.
    printf("Display each 32-bit pointer (as an unsigned 64-bit pointer):\n");
    printf("p32d:       %p\n", p32d);
    printf("p32s:       %p\n", p32s);
    printf("p32u:       %p\n", p32u);

    printf("\nDisplay the 64-bit pointer created from each 32-bit pointer:\n");
    p64 = p32d;
    printf("p32d: p64 = %p\n", p64);
    p64 = p32s;
    printf("p32s: p64 = %p\n", p64);
    p64 = p32u;
    printf("p32u: p64 = %p\n", p64);
    return 0;
}

Display each 32-bit pointer (as an unsigned 64-bit pointer):
p32d:       0000000087654321
p32s:       0000000087654321
p32u:       0000000087654321

Display the 64-bit pointer created from each 32-bit pointer:
p32d: p64 = FFFFFFFF87654321
p32s: p64 = FFFFFFFF87654321
p32u: p64 = 0000000087654321

END Microsoft 特定的

另請參閱

Microsoft 專有的修飾詞