共用方式為

init_seg

  • 發行項

C++ 專有的

指定會影響啟始程式碼執行順序的關鍵字或程式碼區段。

#pragma init_seg({ compiler | lib | user | "section-name" [, func-name]} )

備註

在本主題中，「區段」(Segment) 和「區段」(Section) 這兩個詞的意義可互換。

由於全域靜態物件的初始化可能牽涉到執行程式碼，因此您必須指定關鍵字以定義何時建構物件。 在需要初始化的動態連結程式庫 (DLL) 或程式庫中使用 init_seg pragma 特別重要。

init_seg pragma 的選項包括：

  • compiler
    針對 Microsoft C 執行階段程式庫初始化保留。 這個群組中的物件會最先結構。

  • lib
    可供協力廠商類別程式庫廠商進行初始化。 這個群組中的物件會在標記為 compiler 的物件之後、任何其他物件之前建構。

  • User - 使用者
    可供任何使用者使用。 這個群組中的物件會最後結構。

  • section-name
    允許明確指定初始化區段。 在使用者指定之 section-name 中的物件不會隱含建構，不過，其位址會放在以 section-name 命名的區段中。

    您提供的區段名稱將包含 Helper 函式的指標，這類函式將建構在該模組中 pragma 後面宣告的全域物件。

    如需建立區段時不應該使用的名稱清單，請參閱 /SECTION。

  • func-name
    指定程式結束時，要取代 atexit 呼叫的函式。 這個 Helper 函式也會使用全域物件的解構函式指標呼叫 atexit。 如果您使用下列形式的 pragma 指定函式識別項：

    int __cdecl myexit (void (__cdecl *pf)(void))

    那麼將會呼叫您的函式，而不是 C 執行階段程式庫的 atexit。 這樣可讓您建立在您準備好終結物件時，需要呼叫的解構函式清單。

如果您需要延遲初始化 (例如在 DLL 中)，可以選擇明確指定區段名稱。 然後您必須呼叫每個靜態物件的建構函式。

取代 atexit 的識別項前後沒有引號。

您的物件仍將放在其他 XXX_seg pragma 所定義的區段中。

C 執行階段將不會自動初始化模組中宣告的物件。 您將需要自行進行這項作業。

根據預設，init_seg 區段是唯讀的。 如果區段名稱是 .CRT，即使屬性標記為讀取、寫入，編譯器仍會以無訊息方式將屬性變更為唯讀。

在轉譯單位中不可以重複指定 init_seg。

即使您的物件沒有使用者定義的建構函式 (未在程式碼中明確定義的建構函式)，編譯器仍可能會產生這類建構函式 (例如，用於繫結 v-table 指標)。因此，您的程式碼必須呼叫編譯器產生的建構函式。

範例

// pragma_directive_init_seg.cpp
#include <stdio.h>
#pragma warning(disable : 4075)

typedef void (__cdecl *PF)(void);
int cxpf = 0;   // number of destructors we need to call
PF pfx[200];    // pointers to destructors.

int myexit (PF pf) {
   pfx[cxpf++] = pf;
   return 0;
}

struct A {
   A() { puts("A()"); }
   ~A() { puts("~A()"); }
};

// ctor & dtor called by CRT startup code 
// because this is before the pragma init_seg
A aaaa; 

// The order here is important.
// Section names must be 8 characters or less.
// The sections with the same name before the $
// are merged into one section. The order that
// they are merged is determined by sorting
// the characters after the $.
// InitSegStart and InitSegEnd are used to set
// boundaries so we can find the real functions
// that we need to call for initialization.

#pragma section(".mine$a", read)
__declspec(allocate(".mine$a")) const PF InitSegStart = (PF)1;

#pragma section(".mine$z",read)
__declspec(allocate(".mine$z")) const PF InitSegEnd = (PF)1;

// The comparison for 0 is important.
// For now, each section is 256 bytes. When they
// are merged, they are padded with zeros. You
// can't depend on the section being 256 bytes, but
// you can depend on it being padded with zeros.

void InitializeObjects () {
   const PF *x = &InitSegStart;
   for (++x ; x < &InitSegEnd ; ++x)
      if (*x) (*x)();
}

void DestroyObjects () {
   while (cxpf>0) {
      --cxpf;
      (pfx[cxpf])();
   }
}

// by default, goes into a read only section
#pragma init_seg(".mine$m", myexit)

A bbbb; 
A cccc;

int main () {
   InitializeObjects();
   DestroyObjects();
}

請參閱

參考

Pragma 指示詞和 __Pragma 關鍵字