Định nghĩa cấu trúc nên đi trong tệp .h hoặc .c?

Tôi đã xem cả định nghĩa đầy đủ của structs trong tiêu đề và chỉ khai báo — phương thức này có lợi thế nào hơn phương thức kia không?

Nếu nó tạo ra sự khác biệt, tôi thường gõ một cấu trúc như vậy trong .h

typedef struct s s_t;

Biên tập

Nói rõ hơn, các tùy chọn là khai báo trong tệp tiêu đề và định nghĩa trong lớp, hoặc cả khai báo và định nghĩa trong tệp tiêu đề. Cả hai sẽ dẫn đến khả năng sử dụng giống nhau, ngay cả khi một là do liên kết, phải không?

Tôi thấy nhiều bản sao gần như trùng lặp, ví dụ ở đây nhưng không có kết quả phù hợp chính xác. Vui lòng sửa cho tôi nếu tôi sai trong vấn đề này.

Các cấu trúc riêng cho tệp đó phải đi trong tệp .c, với khai báo trong tệp .h nếu chúng được sử dụng bởi bất kỳ hàm nào trong .h.

Các cấu trúc công khai sẽ nằm trong tệp .h.

Cả hai sẽ dẫn đến khả năng sử dụng giống nhau, ngay cả khi một là do liên kết, phải không?

Không, không phải khi bạn xem xét các tệp .c khác bao gồm cùng một tiêu đề. Nếu định nghĩa của cấu trúc không hiển thị cho trình biên dịch, thì không thể sử dụng chi tiết của định nghĩa đó. Một khai báo không có định nghĩa (ví dụ: chỉ struct s;) khiến trình biên dịch không thành công nếu có bất kỳ thứ gì cố gắng tìm kiếm bên trong struct s, trong khi vẫn cho phép nó biên dịch, ví dụ struct s *foo;như foosau này không được tham chiếu đến).

So sánh các phiên bản này của api.hvà 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;          |
                                      | }                               |
                                      +---------------------------------+

Ứng dụng khách này của API hoạt động với một trong hai phiên bản:

#include "api.h"

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

Cái này xoay quanh chi tiết triển khai:

#include "api.h"

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

sẽ hoạt động với phiên bản "định nghĩa trong tiêu đề", nhưng không hoạt động với phiên bản "định nghĩa trong triển khai", như trong trường hợp sau, trình biên dịch không hiển thị được bố cục của cấu trúc:

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

Vì vậy, phiên bản "định nghĩa trong triển khai" bảo vệ chống lại việc sử dụng sai một cách vô tình hoặc cố ý các chi tiết triển khai riêng tư.

Nếu cấu trúc được sử dụng bởi các đơn vị biên dịch khác (tệp .c), hãy đặt nó vào tệp tiêu đề để bạn có thể đưa tệp tiêu đề đó vào bất cứ nơi nào cần.

Nếu cấu trúc chỉ được sử dụng trong một đơn vị biên dịch (tệp .c), bạn đặt nó vào tệp .c đó.

Vấn đề là, việc đặt nó trong tệp tiêu đề cho phép bạn sử dụng cấu trúc (hoặc bất kỳ định nghĩa nào khác) từ nhiều tệp nguồn, chỉ bằng cách bao gồm tệp tiêu đề đó.

Nhưng nếu bạn chắc chắn rằng nó sẽ chỉ được sử dụng từ một tệp nguồn, thì nó thực sự không tạo ra bất kỳ sự khác biệt nào.

Tôi đặt chúng vào tệp C để làm cho nó trở nên Hướng đối tượng hơn, hãy xem bài viết này .

Nói chung, tôi không nghĩ rằng nó tạo ra sự khác biệt lớn cho dù bạn đặt chúng trong tiêu đề hay tệp nguồn. Tuy nhiên, nếu bạn cần truy cập các thành viên của một cấu trúc từ nhiều tệp nguồn, thì việc đặt cấu trúc vào tệp tiêu đề và bao gồm nó từ bất kỳ tệp nào khác mà cấu trúc cần thiết sẽ dễ dàng hơn.