Руководство по стилю Apple Carbon / CoreFoundation?

Question

Какао хорошо документировано, и есть много информации о написании кода Какао в хорошем виде. Я работаю над кодом, который работает в тесной связи с аппаратным обеспечением, и мне приходится часто использовать API-интерфейсы CoreFoundation и Carbon. Есть ли какое-нибудь руководство по стилю для понимания таких библиотек, как Carbon и CoreFoundation от Apple? Пример кода Apple изобилует такими вещами, как:

• kSomeValue
• CFMightDoSomethingUseful

Я могу сделать вывод, что CF означает CoreFoundation, а k может быть для констант или перечисляемых типов, но я хотел бы проверить это и узнать больше о других синтаксических стилях.

Answer 1

Основные принципы разработки Foundation в Центре разработки Mac фактически прояснили мой вопрос.

Answer 2

Я могу сделать вывод, что CF означает CoreFoundation…

В частности, это префикс для функций, типов и констант в платформе Core Foundation.

… и k может быть для констант или перечислимых типов…

Да. Это восходит ко всем дням Toolbox, еще до появления Core Foundation. Я считаю, что это был обычай Паскаля.

Кроме этих правил, я не знаю ни одного общего руководства по стилю CF / Carbon.

Вы можете попытаться набрать даже больше общего и взять несколько книг по стилю C. Сравните и сопоставьте их; часто нет объективно правильного ответа.

Мне нравится «Хватит веревки, чтобы выстрелить себе в ногу» Аллена Холуба. Это остроумно и делает несколько хороших дел. У Голуба есть краткая версия на его сайте (только сами правила, без подробных объяснений); насколько я могу судить, полная книга вышла из печати. ​​