Чи мають визначення структури входити у файл .h чи .c?

Я бачив як повні визначення structs в заголовках, так і лише декларації - чи є якась перевага одного методу над іншим?

Якщо це має значення, я, як правило, набираю такі структури, як у .h

typedef struct s s_t;

Редагувати

Щоб було зрозуміло, параметри - це декларація у файлі заголовка та визначення у класі, або обидва оголошення та визначення у файлі заголовка. Обидва повинні приводити до однакової зручності використання, навіть якщо одна з них пов'язана, чи не так?

Я бачу багато дублікатів, наприклад тут, але точних збігів немає. Виправте мене, якщо я помиляюся в цьому плані

Приватні структури для цього файлу повинні містити файл .c з декларацією у файлі .h, якщо вони використовуються будь-якими функціями в .h.

Громадські структури повинні містити файл .h.

Обидва повинні приводити до однакової зручності використання, навіть якщо одна з них пов'язана, чи не так?

Ні, якщо не враховувати інші файли .c, включаючи той самий заголовок. Якщо визначення структури не видно компілятору, деталі цього визначення використовувати не можна. Декларація без визначення (наприклад, просто struct s;) призводить до відмови компілятора, якщо що-небудь намагається заглянути всередину struct s, при цьому все ж дозволяє йому, наприклад, компілювати struct s *foo;(до тих пір, fooпоки пізніше не буде відменено).

Порівняйте ці версії api.hта api.c:

Definition in header:                 Definition in implementation:
+---------------------------------+   +---------------------------------+
| struct s {                      |   | struct s;                       |
|     int internal;               |   |                                 |
|     int other_stuff;            |   | extern void                     |
| };                              |   | api_func(struct s *foo, int x); |
|                                 |   +---------------------------------+
| extern void                     |   +---------------------------------+
| api_func(struct s *foo, int x); |   | #include "api.h"                |
+---------------------------------+   |                                 |
+---------------------------------+   | struct s {                      |
| #include "api.h"                |   |     int internal;               |
|                                 |   |     int other_stuff;            |
| void                            |   | };                              |
| api_func(struct s *foo, int x)  |   |                                 |
| {                               |   | void                            |
|     foo->internal = x;          |   | api_func(struct s *foo, int x)  |
| }                               |   | {                               |
+---------------------------------+   |     foo->internal = x;          |
                                      | }                               |
                                      +---------------------------------+

Цей клієнт API працює з будь-якою версією:

#include "api.h"

void good(struct s *foo)
{
    api_func(foo, 123);
}

Це стосується деталей щодо впровадження:

#include "api.h"

void bad(struct s *foo)
{
    foo->internal = 123;
}

яка буде працювати з версією "визначення в заголовку", але не з версією "визначення в реалізації", оскільки в останньому випадку компілятор не має видимості компонування структури:

$ gcc -Wall -c bad.c
bad.c: In function 'bad':
bad.c:5: error: dereferencing pointer to incomplete type
$

Отже, версія "визначення у впровадженні" захищає від випадкових чи навмисних зловживань деталями приватного впровадження.

Якщо структура повинна використовуватися іншими підрозділами компіляції (.c файлами), розмістіть її у файлі заголовка, щоб ви могли включити цей заголовок файл, де це потрібно.

Якщо структура використовується лише в одній одиниці компіляції (.c-файл), ви розміщуєте її в цьому .c-файлі.

Справа в тому, що розміщення його у файлі заголовка дозволяє використовувати структуру (або будь-яке інше визначення) з декількох вихідних файлів, просто включивши цей файл заголовка.

Але якщо ви впевнені, що він буде використовуватися лише з одного вихідного файлу, то це насправді не має ніякого значення.

Я поміщую їх у файл C, щоб зробити його більш орієнтованим на об'єкти, дивіться цю статтю .

Взагалі, я не думаю, що це має велике значення, вкладаєте ви їх у заголовок чи вихідні файли. Однак якщо вам потрібно отримати доступ до членів структури з декількох вихідних файлів, простіше помістити структуру у файл заголовка та включити її з будь-яких інших файлів, де потрібна структура.