8.1.1 API современных библиотек GNU Objective-C

Библиотеки GNU Objective-C предоставляют API, похожий на API, предоставляемый Apple/NeXT Objective-C runtime «Objective-C 2.0». API документирован в общедоступных заголовочных файлах библиотек GNU Objective-C:

• objc/objc.h: это базовый заголовочный файл Objective-C, определяющий базовые типы Objective-C, такие как id, Class и BOOL. Для работы практически с любыми объектами Objective-C необходимо включить этот заголовочный файл.
• objc/runtime.h: этот заголовочный файл объявляет большинство функций публичного API, позволяющих инспектировать и манипулировать структурами данных Objective-C runtime. Эти функции достаточно стандартизированы для различных Objective-C runtime и почти идентичны функциям Apple/NeXT Objective-C runtime. В нем не объявлены функции в некоторых специализированных областях (создание и передача вызовов сообщений, потоки), которые находятся в других заголовочных файлах ниже. Для использования любых функций, таких как class_getName(), объявленных в objc/runtime.h, необходимо включить objc/objc.h и objc/runtime.h.
• objc/message.h: этот заголовочный файл объявляет публичные функции, используемые для создания, разрушения и передачи вызовов сообщений. Поскольку отправка сообщений реализована по-разному в разных runtime, функции в этом заголовочном файле специфичны для реализации GNU Objective-C runtime.
• objc/objc-exception.h: этот заголовочный файл объявляет некоторые публичные функции, связанные с исключениями Objective-C. Например, функции в этом заголовочном файле позволяют генерировать исключения Objective-C из обычного кода C/C++.
• objc/objc-sync.h: этот заголовочный файл объявляет некоторые публичные функции, связанные с синтаксисом Objective-C @synchronized(), позволяющие эмулировать блок Objective-C @synchronized() в обычном коде C/C++.
• objc/thr.h: этот заголовочный файл объявляет публичный уровень API потоков runtime, который предоставляется только GNU Objective-C runtime. Он объявляет функции, такие как objc_mutex_lock(), которые предоставляют независимую от платформы набор функций для работы с потоками.

Заголовочные файлы содержат подробную документацию для каждой функции в API библиотек GNU Objective-C runtime.