alloc_text pragma

Nazwij sekcję kodu, w której są umieszczane określone definicje funkcji. Element pragma musi występować między deklaratorem funkcji a definicją funkcji dla nazwanych funkcji.

Składnia

#pragma alloc_text(function_1 "text-section" , [,function_2 ... ])

Uwagi

Funkcja alloc_textpragma nie obsługuje funkcji składowych języka C++ ani przeciążonych funkcji. Ma zastosowanie tylko do funkcji zadeklarowanych za pomocą połączenia języka C, czyli funkcji zadeklarowanych ze specyfikacją extern "C" połączenia. Jeśli spróbujesz użyć tego pragma elementu w funkcji z połączeniem języka C++, zostanie wygenerowany błąd kompilatora.

Ponieważ adresowanie funkcji przy użyciu __based metody nie jest obsługiwane, określanie lokalizacji sekcji wymaga użycia elementu alloc_textpragma. Nazwa określona przez sekcję tekstową powinna być ujęta w podwójny cudzysłów.

Element alloc_textpragma musi pojawić się po deklaracjach dowolnej z określonych funkcji i przed definicjami tych funkcji.

Funkcje, do których odwołuje się element alloc_textpragma , powinny być zdefiniowane w tym samym module co element pragma. W przeciwnym razie, jeśli funkcja niezdefiniowana zostanie później skompilowana w innej sekcji tekstowej, błąd może zostać przechwycony lub nie zostanie przechwycony. Mimo że program zwykle będzie działać poprawnie, funkcja nie zostanie przydzielona w zamierzonych sekcjach.

Inne ograniczenia dotyczące alloc_text są następujące:

• Nie można jej używać wewnątrz funkcji.

• Należy go użyć po zadeklarowaniu funkcji, ale przed zdefiniowaną funkcją.

Zobacz też

dyrektywy Pragma oraz słowa kluczowe __pragma i _Pragma