В Swift, что такое атрибут `@inlinable` и в каких случаях его уместно применять к функциям?

Что делает @inlinable

Атрибут @inlinable раскрывает реализацию функции через границы модулей, позволяя компилятору подставить тело функции непосредственно в место вызова вместо традиционного вызова функции.

Как это работает

Обычно при вызове функции из внешнего модуля компилятор видит только её публичный интерфейс, а не реализацию. Если пометить функцию как @inlinable, её тело встраивается в публичный интерфейс модуля, что позволяет применять оптимизации вроде:

• Устранения накладных расходов от вызова функции
• Включения дальнейших оптимизаций, таких как constant folding или dead code elimination

Когда это имеет смысл

Используй @inlinable когда:

• Пишешь критичный по производительности код библиотеки, где накладные расходы на вызов измеримо влияют на производительность
• Тело функции маленькое и стабильное, что делает инлайнинг действительно полезным
• Создаёшь API в стиле стандартной библиотеки, где пользователи ожидают максимальной производительности

Ключевые компромиссы

• Размер бинарного файла может увеличиться, так как тело функции дублируется в каждом месте вызова
• Стабильность ABI нарушается — раз функция помечена как @inlinable, изменение её реализации становится breaking change для предкомпилированных клиентов, требуя их перекомпиляции
• Все символы, на которые ссылается функция с @inlinable, должны быть как минимум @usableFromInline или public

Резюме

@inlinable — это инструмент точечной оптимизации для авторов библиотек. Его не стоит применять везде — используй его только для маленьких, стабильных, часто вызываемых функций, где выигрыш в производительности явно перевешивает затраты на снижение гибкости и потенциальное влияние на перекомпиляцию.