Спецификация префиксов венгерской нотации

№	Префикс	Тип данных (базовый тип)
1	c	char
2	by	BYTE (unsigned char)
3	n	short int, int
4	i	int
5	x, у	short (в качестве координат х и у)
6	сx, су	short (в качестве длины вдоль координат х и у)
7	b	BOOL (int)
8	w	UINT (unsigned int) или WORD (unsigned short int)
9	l	LONG (long)
10	dw	DWORD (unsigned long)
11	fn	Указатель на функцию
12	s	Строка
13	sz, str	Строка, завершающаяся нулевым байтом
14	lp	32-битовый указатель
15	h	Дескриптор (используется для обращения к объектам Windows
16	msg	Сообщение

Именование переменных. При использовании венгерской нотации переменные имеют префиксы, указанные в табл. 2.1. Кроме того, если имя переменной состоит из одного или нескольких слов, то каждое из них записывается с прописной буквы. Вот несколько примеров:

char *szFileName; // Строка с завершающим нулем

int *lpiData; // 32-битовый указатель на int

BOOL bSemaphore; // Логическое значение

DWORD dwMaxCount; // 32-битовое беззнаковое целое

Хотя специальное обозначение для локальных переменных мне неизвестно, для гло­бальных обычно используется префикс g_ (или просто g):

int g_iXPos; // Глобальная позиция по координате х

int g_Timer; // Глобальный таймер

char *g_szString; // Глобальная строка с

// завершающим нулем

Именование функций. Функции именуются так же, как и переменные, но только без префиксов. Другими словами, в именах функций составляющие их слова пишутся с прописных букв, и не бо­лее того.

int PlotPixel(int ix, int iy, int ic);

void *MemScan(char *szString);

Использование подчеркиваний считается неверным. Например, следующая функция не соответствует венгерской нотации:

int Get_Pixel(int ix, int iy);

Именование типов и констант. Имена всех типов и констант состоят только из прописных букв, но при этом Вы мо­жете использовать в именах подчеркивание:

const LONG NUM_SECTORS = 100; // Константа в стиле C++

#define MAX_CELLS 64 // Константа в стиле С

#define POWERUNIT 100 // Константа в стиле С

typedef unsigned char UCHAR; // Пользовательский тип

Здесь нет ничего необычного – обыкновенные стандартные определения. Хотя большинство программистов Microsoft не используют подчеркивания, предпочтительно пользоваться ими с тем, чтобы имена были более удобочитаемы.

В C++ ключевое слово const имеет несколько значений, но в приведенном выше коде оно использовано просто для создания константной переменной. Этот способ похож на использование макроопределения #define, но при этом содержит информацию о типе. Использование const позволяет, таким образом, обеспечить проверку типов в процессе компиляции и выполнить необходимые преобразования.

Именование классов. Соглашение об именовании классов может Вас несколько удивить, но я видел множе­ство программистов, настолько привыкших к нему, что используют его в повседневной работе. Просто все классы C++ должны иметь имена с префиксом, состоящим из одной прописной буквы С.

class CVector

{

public:

CVector() { ix = iy = iz = imagnitude = 0; }

CVector(int x, int y, int z)

{ ix = x; iy = y; iz = z; }

...

private:

int ix, iy, iz; // Направление вектора int

imagnitude; // Размер вектора

}

Именование параметров. Имена параметров функций следуют тем же соглашениям, что и обычные перемен­ные, хотя это и не обязательно. Например, Вы можете увидеть объявление функции, вы­глядящее так:

UCHAR GetPixel(int x, int y);

При использовании венгерской нотации это объявление должно выглядеть следую­щим образом:

UCHAR GetPixel(int ix, int iy);

Кроме того, в объявлении функции имена параметров могут не указываться вовсе – указываются только их типы:

UCHAR GetPixel(int, int);

Конечно, такое допустимо только в объявлении функции; в определении функции должны использоваться не только типы, но и имена переменных.

Знакомство с венгерской нотацией еще не означает, что Вы в обязательном порядке должны ее использовать. Таким образом, код в этой книге будет использовать венгерскую нотацию при рассмотрении функций Win32 API, но в других местах будем пользоваться собственным стилем.

Программы, приведенные в этой книге, создавались в среде Microsoft Visual C ++ 6.0. Во время работы с книгой, разбирая приведенные примеры, или при создании собственных приложений Вы, вероятно, будете применять какой-либо другой компилятор, кото­рый сможет строить программы для Windows. Демонстрационные программы должны правильно транслироваться любым компилятором, совместимым с Visual C ++. Примеры, приведенные в книге, написаны на стандартном C/C++, так что они должны транслироваться любым компилятором C/C++.

Обычно создается проект типа Win32-Application. В состав «рабочего пространства» (Workspace) проекта (на рис. 1.4 – это проект Ex_02_01) обязательно входят файлы (Sourse Files):

• текст программы с суффиксом .cpp (на рис.1.4 – это текст программы Example-02-01.cpp);

• стандартная библиотека вызовов Windows (на рис.1.4 – это библиотека Comctl32.lib);

• стандартный заголовочный h-файл (на рис. 1.4 – это Windows.h).

Как показано на рис. 1.4, первые два файла включаются разработчиком программы в явном виде. Третий файл (Header Files), если на него есть ссылка в тексте программы с помощью макроса

#include <Windows.h>,

который подключается автоматически.

Рис. 1.4. Типовой состав проекта