Приложение J: Рекомендации по наименованию
LREAL |
|
|
64 |
lr |
|
|
|
|
|
|
|
|
|
|
|
|
|
STRING |
|
|
|
s |
|
|
|
|
|
|
|
TIME |
|
|
|
tim |
|
|
|
|
|
|
|
TIME_OF_DAY |
|
|
|
tod |
|
|
|
|
|
|
|
DATETIME |
|
|
|
dt |
|
|
|
|
|
|
|
DATE |
|
|
|
date |
|
|
|
|
|
|
|
ENUM |
|
|
16 |
e |
|
|
|
|
|
|
|
POINTER |
|
|
|
p |
|
|
|
|
|
|
|
ARRAY |
|
|
|
a |
|
|
|
|
|
|
|
* префикс x используется для переменной типа BOOL, если нужно подчеркнуть что она представляет собой именно один бит, что происходит при использовании прямого адреса бита (например %IX0.0). Если логическая переменная объявлена без указания адреса, то как правило, под нее выделяется целый байт (для оптимизации по быстродействию).
Примеры: bySubIndex: BYTE;
sFileName: STRING;
udiCounter: UDINT;
Вслучае составных объявлений, применяются составные префиксы:
Пример:
pabyTelegramData: POINTER TO ARRAY [0..7] OF BYTE;
Для экземпляров функциональных блоков и переменных пользовательских типов в качестве префикса используется сокращенное наименование функционального блока или типа (например: sdo).
Пример:
cansdoReceivedTelegram: CAN_SDOTelegram;
TYPE CAN_SDOTelegram : (* префикс: sdo *)
STRUCT
wIndex:WORD;
bySubIndex:BYTE;
byLen:BYTE;
aby: ARRAY [0..3] OF BYTE; END_STRUCT
END_TYPE
Константы начинаются с префикса c. За ним следует подчеркивание, префикс типа и основное имя.
Пример:
VAR CONSTANT
c_uiSyncID: UINT := 16#80;
END_VAR
Префиксы глобальных переменных (g) и глобальных констант (gc) отделяются подчеркивани-
ем. Дополнительный префикс вводится для библиотек:
CoDeSys V2.3 |
10-102 |
Приложение J: Рекомендации по наименованию
Примеры:
VAR_GLOBAL CAN_g_iTest: INT;
END_VAR
VAR_GLOBAL CONSTANT
CAN_gc_dwExample: DWORD;
END_VAR
Идентификаторы пользовательских типов (DUT)
Наименование структур образуется из префикса библиотеки (например: CAN), подчеркивания и возможно более короткой основы имени (например: SDOTelegram). В комментарии приводится префикс, принятый для образования имен переменных данного типа.
Примеры:
TYPE CAN_SDOTelegram : (*префикс: sdo *)
STRUCT
wIndex:WORD;
bySubIndex:BYTE;
byLen:BYTE;
abyData: ARRAY [0..3] OF BYTE;
END_STRUCT
END_TYPE
Перечисления начинаются с имени библиотеки (например: CAL) и следующего за подчеркиванием наименования с заглавной буквы.
Пример:
TYPE CAL_Day :( CAL_MONDAY, CAL_TUESDAY, CAL_WEDNESDAY, CAL_THIRSDAY, CAL_FRIDAY, CAL_SATURDAY, CAL_SUNDAY);
Объявление:
eToday: CAL_Day;
Идентификаторы функций, функциональных блоков и программ
(POU)
Имена для функций, функциональных блоков и программ образуются из префикса имени библиотеки (например: CAN), подчеркивания и краткой выразительной основы (например: SendTelegram). Как и для переменных, первая буква каждого слова должна быть заглавной. Рекомендуется составлять имена POU из глагола и существительного.
CoDeSys V2.3 |
10-103 |
