Соглашение об именовании

Содержание

Прежде чем закончить данную главу, необходимо привести небольшие пояснения по поводу именования функций и переменных. Новичкам в Windows-программировании некоторые имена переменных и параметров в программе-заготовке и ее описании покажутся, вероятно, довольно необычными. Причина кроется в том, что подобные имена являются следствием строгого соблюдения ряда соглашений о присвоении имен, которые были изобретены и учреждены компанией Microsoft для программирования под управлением Windows. Согласно этим соглашениям, название функции состоит из глагола, за которым следует существительное. Причем первая буква и глагола, и существительного пишутся с большой буквы.

Что касается имен переменных, то здесь Microsoft избрала путь применения довольно сложной системы указания типа данных в имени переменной. В соответствии с ней, впереди имени переменной добавляется префикс типа (который пишется строчными буквами). Непосредственно имя переменной пишется с заглавной буквы. Префиксы типов приведены в табл. 26.1. Целесообразность применения префиксов типа не является очевидной (для многих она кажется скорее даже спорной), поэтому такая модель именования не получила повсеместного признания и не стала универсальной. Многие Windows-программисты пользуются именно данным способом именования, но в то же время не меньшее количество не приемлют его. Вам, естественно, предоставляется свобода выбора применять любое соглашение об именовании, которое придется вам по душе.




Таблица 26.1. Символы префикса для переменных различных типов
ПрефиксТип данных
bбулев (1 байт)
cсимвол (1 байт)
dwдлинное целое без знака
f16-разрядное битовое поле (флаги)
fnфункция
hдескриптор
lдлинное целое
lpдлинный указатель
nкороткое целое
pуказатель
ptдлинное целое, содержащее координаты экрана
wкороткое целое без знака
szуказатель на строку — массив, оканчивающийся нулевым символом
lpszдлинный указатель на строку — массив, оканчивающийся нулевым символом
rgbдлинное целое, содержащее значения RGB-цветов