Как правильно оформлять модули?

@Artishok · Регистрация: 27.12.2009

Студворк — интернет-сервис помощи студентам

как правильно нужно оформлять модули?

допустим самый простейший.сохранил как modul.h

C++
1
2
3
4
5
6
7
8
9
#include <iostream>
 
extern void write();
 
void write()
{
    cout<<"Hello world!"<<endl;
    return;
}

основная прога

C++
1
2
3
4
5
6
7
#include <iostream>
#include "modul.h"
 
void main()
{
    write();
}

так вот правильно или надо по-другому?

@sandye51 · 10.02.2011, 23:52

правильно
но только этот пример работать не будет, т.к. не подключено std;

@CyBOSSeR · 10.02.2011, 23:57

sandye51, неа.
Либо:

C++
1
2
// module.h
void write();

C++
1
2
3
4
5
6
7
// module.cpp
#include "module.h" // Не уверен, что необходимо
#include <iostream>
 
void write() {
  std::cout << "Hello world!" << std::endl;
}

C++
1
2
3
4
5
6
// main.cpp
#include "module.h"
 
void main() {
  write();
}

Либо:

C++
1
2
3
4
5
6
// module.cpp
#include <iostream>
 
void write() {
  std::cout << "Hello world!" << std::endl;
}

C++
1
2
3
4
5
6
// main.cpp
extern void write();
 
void main() {
  write();
}

Первый вариант предпочтительнее.

@Artishok · 11.02.2011, 00:09 **[ТС]**

то есть предпочтительнее разбить на интерфейс и реализацию если файл .h или модуль в .cpp сохранять?

@CyBOSSeR · 11.02.2011, 00:11

Сообщение от Artishok

то есть предпочтительнее разбить на интерфейс и реализацию?

Если я Вас правильно понял, то да.

@Artishok · 11.02.2011, 00:17 **[ТС]**

а чем плох мой вариант?

@CyBOSSeR · 11.02.2011, 00:26

Сообщение от Artishok

а чем плох мой вариант?

Заголовочные файлы предназначены для объявлений, а не реализации.

@Artishok · 11.02.2011, 00:40 **[ТС]**

че-то у меня в первом варианте компилятор выдает
udefined reference to write(void)

silent_1991 · 11.02.2011, 00:43

Не по теме:

Сообщение от CyBOSSeR

Заголовочные файлы предназначены для объявлений, а не реализации.

А как же шаблонные классы? ;)

@CyBOSSeR · 11.02.2011, 00:46

Сообщение от Artishok

че-то у меня в первом варианте компилятор выдает

Какой компилятор? Проверил на MSVS - полет нормальный.

Не по теме:

Сообщение от silent_1991

А как же шаблонные классы?

Ну дак есть же *.hpp :p

silent_1991 · 11.02.2011, 00:47

Сообщение от CyBOSSeR

А как же файлы *.hpp?

Никогда ими не пользовался))) А есть разница?

@CyBOSSeR · 11.02.2011, 00:49

Конечно, они как раз и предназначены и для совмещения объявлений с реализациями.

@Artishok · 11.02.2011, 01:07 **[ТС]**

то есть можно сохранять модули в .hpp?

@CyBOSSeR · 11.02.2011, 01:22

Сообщение от Artishok

то есть можно сохранять модули в .hpp?

Можно. Но крайне желательно лишь в случае шаблонов.

@Nameless One · 11.02.2011, 10:39

Заголовочные файлы - *.h (или *.H, *.hpp) - предназначены для определения интерфейса модуля. Он содержит объявления функций, констант, типов данных, которые будет предоставлять модуль.
Без них, в общем-то, можно было бы и обойтись. Допустим, у нас есть некоторый файл foo.c, который предоставляет фукцию magnitude для определения длины вектора:

C
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#include <math.h>
 
struct vector
{
    double x, y;
};
 
double sumOfSquares(double x, double y)
{
    return x * x + y * y;
}
 
double magnitude(struct vector vector)
{
    return sqrt(sumOfSquares(vector.x, vector.y));
}

Мы не сможем просто так использовать эту функцию в файле main.c, который будет содержать главную функцию, т.к. при компиляции этого файла компилятор ничего не знает о функции magnitude и о структуре vector. Поэтому нам нужно явно поместить объявление функции magnitude и структуры vector в файл main.c:

C
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
#include <stdio.h>
#include <stdlib.h>
 
struct vector
{
    double x, y;
};
 
double magnitude(struct vector);
 
int main()
{
    struct vector v = {15.5, -8.9};
    printf("Vector v = {%.2f, %.2f}, |v| = %.2f\n", v.x, v.y, magnitude(v));
        
    exit(0);
}

Такая программа скомпилируется и заработает. Но этот способ неудобен и подвержен ошибкам.
Поэтому мы создадим файл foo.h и поместим в него объявления magnitude и vector. Окончательная версия программы выглядит так:
foo.h:

C
1
2
3
4
5
6
7
8
9
10
11
#ifndef FOO_H
#define FOO_H
 
struct vector
{
    double x, y;
};
 
double magnitude(struct vector);
 
#endif

foo.c:

C
1
2
3
4
5
6
7
8
9
10
11
12
13
#include <math.h>
 
#include "foo.h"
 
static double sumOfSquares(double x, double y)
{
    return x * x + y * y;
}
 
double magnitude(struct vector vector)
{
    return sqrt(sumOfSquares(vector.x, vector.y));
}

main.c:

C
1
2
3
4
5
6
7
8
9
10
11
12
#include <stdio.h>
#include <stdlib.h>
 
#include "foo.h"
 
int main()
{
    struct vector v = {15.5, -8.9};
    printf("Vector v = {%.2f, %.2f}, |v| = %.2f\n", v.x, v.y, magnitude(v));
        
    exit(0);
}

Если вспомнить, как работает директива #include, то станет понятно, что после работы препроцессора содержимое файла foo.h будет находиться в начале файлов main.c и foo.c, что практически соответствует первоначальному варианту. Связка директив препроцессора #ifndef-#define-#endif в foo.h нужна для предотвращения ошибок компиляции, которые могут возникнуть при повторном включении заголовочного файла (вместо нее можно было бы использовать директиву #pragma once, но она поддерживается не всеми компиляторами). Так же стоит отметить, что мы не собираемся "экспортировать" функцию sumOfSquares, т.к. она является вспомогательной для функции magnitude. Поэтому мы не поместили ее объявление в заголовочный файл и определили ее с спецификатором static (которая говорит о том, что функция видна только в текущей единице трансляции).

@Artishok · 07.03.2011, 20:59 **[ТС]**

а если в функции и модуля используется указатель на структуру то так и писать

C
1
2
3
4
5
6
void destroy(struct bilet *bilet,int cnt)
{
   if (bilet) free(bilet);
   bilet = NULL;
   cnt=0;
}

и объявлять так

C
1
void destroy(struct bilet,int);

?

Новые блоги и статьи Все статьи Все блоги /
Загрузка PNG-файла с альфа-каналом с помощью библиотеки SDL3_image на Android 8Observer8 27.01.2026 Содержание блога SDL3_image - это библиотека для загрузки и работы с изображениями. Эта пошаговая инструкция покажет, как загрузить и вывести на экран смартфона картинку с альфа-каналом, то есть с. . .	влияние грибов на сукцессию anaschu 26.01.2026 Бифуркационные изменения массы гриба происходят тогда, когда мы уменьшаем массу компоста в 10 раз, а скорость прироста биомассы уменьшаем в три раза. Скорость прироста биомассы может уменьшаться за. . .	Воспроизведение звукового файла с помощью SDL3_mixer при касании экрана Android 8Observer8 26.01.2026 Содержание блога SDL3_mixer - это библиотека я для воспроизведения аудио. В отличие от инструкции по добавлению текста код по проигрыванию звука уже содержится в шаблоне примера. Нужно только. . .	Установка Android SDK, NDK, JDK, CMake и т.д. 8Observer8 25.01.2026 Содержание блога Перейдите по ссылке: https:/ / developer. android. com/ studio и в самом низу страницы кликните по архиву "commandlinetools-win-xxxxxx_latest. zip" Извлеките архив и вы увидите. . .
Вывод текста со шрифтом TTF на Android с помощью библиотеки SDL3_ttf 8Observer8 25.01.2026 Содержание блога Если у вас не установлены Android SDK, NDK, JDK, и т. д. то сделайте это по следующей инструкции: Установка Android SDK, NDK, JDK, CMake и т. д. Сборка примера Скачайте. . .	Использование SDL3-callbacks вместо функции main() на Android, Desktop и WebAssembly 8Observer8 24.01.2026 Содержание блога Если вы откроете примеры для начинающих на официальном репозитории SDL3 в папке: examples, то вы увидите, что все примеры используют следующие четыре обязательные функции, а. . .	моя боль iceja 24.01.2026 Выложила интерполяцию кубическими сплайнами www. iceja. net REST сервисы временно не работают, только через Web. Написала за 56 рабочих часов этот сайт с нуля. При помощи perplexity. ai PRO , при. . .	Модель сукцессии микоризы anaschu 24.01.2026 Решили писать научную статью с неким РОманом

@sandye51 программист С++ 860 / 600 / 147 Регистрация: 19.12.2010 Сообщений: 2,014
	10.02.2011, 23:52
	правильно но только этот пример работать не будет, т.к. не подключено std; 1

@Artishok ЧакЭ одобряЭ 285 / 284 / 86 Регистрация: 27.12.2009 Сообщений: 1,767
	11.02.2011, 00:09 [ТС]
	то есть предпочтительнее разбить на интерфейс и реализацию если файл .h или модуль в .cpp сохранять? 0

@Artishok ЧакЭ одобряЭ 285 / 284 / 86 Регистрация: 27.12.2009 Сообщений: 1,767
	11.02.2011, 00:17 [ТС]
	а чем плох мой вариант? 0

@Artishok ЧакЭ одобряЭ 285 / 284 / 86 Регистрация: 27.12.2009 Сообщений: 1,767
	11.02.2011, 00:40 [ТС]
	че-то у меня в первом варианте компилятор выдает udefined reference to write(void) 0

@CyBOSSeR 2348 / 1721 / 149 Регистрация: 06.03.2009 Сообщений: 3,675
	11.02.2011, 00:49
	Конечно, они как раз и предназначены и для совмещения объявлений с реализациями. 2

@Artishok ЧакЭ одобряЭ 285 / 284 / 86 Регистрация: 27.12.2009 Сообщений: 1,767
	11.02.2011, 01:07 [ТС]
	то есть можно сохранять модули в .hpp? 0