patternsopaque-pointer

mgreenly 的头像作者 mgreenly

C语言开发的不可见指针模式

📖 中文导读:C语言开发的不可见指针模式 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: patterns/opaque-pointer description: Opaque Pointer Pattern pattern for C development

Opaque Pointer Pattern

Declare struct in header without defining fields. Implementation hidden in .c file. Callers only see pointer, never fields.

ikigai Application

Header:

typedef struct ik_scrollback ik_scrollback_t;  // Forward declaration
res_t ik_scrollback_create(void *ctx, ik_scrollback_t **out);

Implementation in .c:

struct ik_scrollback {
    // Fields hidden from callers
};

Benefits:

  • Callers can't depend on internal fields
  • Change internals without recompiling callers
  • Enforces use of accessor functions

ikigai usage: Most context types could use this. Currently structs are defined in headers. Consider for stable public APIs.