inline_depth pragma

Megadja a beágyazott heurisztikus keresési mélységet. A hívási gráfban a megadott értéknél nagyobb mélységű függvények nem beágyazottak.

Szintaxis

#pragma inline_depth( [ n ] )

Megjegyzések

Ez a pragma szabályozza a inline és __inline, illetve a /Ob fordítóbeállítás alatt automatikusan beágyazott függvények sorba helyezését. További információ: /Ob (Beágyazott függvénybővítés).

n 0 és 255 közötti érték lehet, ahol a 255 korlátlan mélységet jelent a hívási gráfban. A 0 érték gátolja a beágyazott terjeszkedést. Ha nincs megadva n, a rendszer az alapértelmezett 254-et használja.

A inline_depthpragma szabályozza, hogy egy függvényhívások sorozata hányszor bővíthető. Tegyük fel például, hogy a beágyazott mélység 4. Ha az A hívás B, majd B, akkor a C hívása, mindhárom hívás beágyazottan lesz kibontva. Ha azonban a legközelebbi beágyazott mélységbővítés 2, csak az A és a B lesz kibontva, és a C függvényhívás marad.

A pragmahasználatához a /Ob fordítóbeállítást 1 vagy újabb értékre kell állítania. A pragma használó mélységi beállítás a pragmautáni első függvényhíváskor lép érvénybe.

A beágyazott mélység a bővítés során csökkenthető, de nem növelhető. Ha a beágyazott mélység 6, és a bővítés során az előfeldolgozó egy 8 értékű inline_depthpragma találkozik, a mélység 6 marad.

A inline_depthpragma nincs hatással a __forceinlinejelölt függvényekre.

Jegyzet

A rekurzív függvények legfeljebb 16 hívásmélységig helyettesíthetők beágyazottan.

Lásd még:

Pragma irányelvei, valamint a __pragma és _Pragma kulcsszavak
inline_recursion