Intel® Fortran Compiler 17.0 Developer Guide and Reference
General Compiler Directives: Tell the compiler to perform the specified inlining on routines within statements or DO loops.
!DIR$ INLINE [RECURSIVE]
!DIR$ FORCEINLINE [RECURSIVE]
!DIR$ NOINLINE
The INLINE directive specifies that the routines can be inlined.
The FORCEINLINE directive specifies that a routine should be inlined whenever the compiler can do so. This condition can also be specified by using compiler option [Q]inline-forceinline.
The NOINLINE directive specifies that a routine should not be inlined.
These directives apply only to the immediately following statement or DO construct. All statements within the immediately following DO construct are affected.
If keyword RECURSIVE is specified, the specified inlining is performed when the routine calls itself directly or indirectly.
The inlining can be ignored by the compiler if inline heuristics determine it may have a negative impact on performance or will cause too much of an increase in code size.
When you use directive FORCEINLINE, the compiler may do so much additional inlining that it runs out of memory and terminates with an "out of memory" message.
Consider the following:
!DIR$ INLINE
A = F(B) + G(C) ! inline the call to function F and inline the call to function G
!DIR$ INLINE
DO I = 1, N
CALL F1 ( G1(A), G2(A)) ! inline the call to F1 and the function executions of G1 and G2
!DIR$ NOINLINE
DO J = 1, M
M(J) = F (M(J)) ! do not inline this call to F {M is a data array}
END DO
M(I) = F2 (X) ! F2 gets inlined from the directive before DO I
!DIR$ FORCEINLINE RECURSIVE
CALL F3 () ! F3 must be inlined and it calls itself recursively so inline those calls too
END DO