Формат исходного кода на VBScript - История изменений

SYSDBA в 15:17, 5 декабря 2014

2014-12-05T15:17:29Z

SYSDBA в 16:56, 13 марта 2012

2012-03-13T16:56:57Z

SYSDBA: /* Требования к формату исходного кода */

2010-08-13T06:52:37Z

‎Требования к формату исходного кода

SYSDBA в 17:09, 22 августа 2007

2007-08-22T17:09:37Z

Новая страница

Ниже приводятся требования к формату исходного кода, написанного на языке VBScript.
=== Требования к формату исходного кода ===
* Зарезервированные слова (begin, end, while etc.) набираются строчными буквами.
* Следующие символы и последовательности символов выделяются пробелами с двух сторон: + - * / = < > <> >= <=^ Пример:

Value = A + 5 / 6

* Следующие символы выделяются пробелом справа: : ; , Пример:

A = B + C
D = E * F
MyFunc(A, B)

* Следующие символы не выделяются пробелами: ( ) . . Пример:

MyFunc(A, B)
Obj.Function(A)

* Не рекомендуется набирать операторы if...then...else в одну строку.
* Стандартный отступ — 2 пробела.
* Отступами выделяются:
* Оператор после зарезервированных слов then, else, while, etc.

if A > B then
Result = A
else
Result = B
end if

while A < 100
A = A + 1
wend

При объявлении класса, секции следуют в следующем порядке: private, public. Если секция пустая, т.е. не содержит объявлений методов, переменных или properties, то она не указывается в объявлении класса. Начало каждой секции (кроме первой) выделяется пустой строкой. В пределах одной секции объявления переменных, методов и properties отделяются друг от друга пустыми строками. Кроме этого пустые строки используются для выделения логических групп (конструктор и деструктор отделяются от других методов; переменные, хранящие значения properties отделяются от других переменных и т.п.). Реализация методов класса происходит в обратном порядке, т.е. сначала public методы, затем protected и private, причем в пределах одной секции реализация методов происходит в порядке их объявления.

Пример:

* При переносе длинной строки вторая, третья и все последующие части набираются с отступом относительно первой, причем операторы оставляются в конце предидущей строки:

VeryLongIdentifier = FirstVariable /_
SecondVariable *_
(ThirdVariable + FourthVariable)

* Комментарии должны быть написаны грамотным английским, белорусским или русским языком.
* Всегда использовать константы вместо непосредственных значений.

← Предыдущая		Версия 16:56, 13 марта 2012
Строка 46:		Строка 46:

	[[Category:Документация]]		[[Category:Документация]]
		+	[[Category:Руководство разработчика]]

← Предыдущая		Версия 06:52, 13 августа 2010
Строка 44:		Строка 44:
	* Комментарии должны быть написаны грамотным английским, белорусским или русским языком.		* Комментарии должны быть написаны грамотным английским, белорусским или русским языком.
	* Всегда использовать константы вместо непосредственных значений.		* Всегда использовать константы вместо непосредственных значений.
		+
		+	[[Category:Документация]]

@@ Строка 1: / Строка 1: @@
 Ниже приводятся требования к формату исходного кода, написанного на языке VBScript.
 === Требования к формату исходного кода ===
-* Зарезервированные слова (begin, end, while etc.) набираются строчными буквами.
 * Следующие символы и последовательности символов выделяются пробелами с двух сторон: + - * / = < > <> >= <=^ Пример:
@@ Строка 17: / Строка 19: @@
   Obj.Function(A)
-* Не рекомендуется набирать операторы if...then...else в одну строку.
+* Не рекомендуется набирать операторы If...Then...Else в одну строку.
-* Стандартный отступ — 2 пробела.
+* Стандартный отступ — 2 пробела. Символ табуляции не используется.
 * Отступами выделяются:
-* Оператор после зарезервированных слов then, else, while, etc.
+* Оператор после зарезервированных слов Then, Else, While, etc.
-  if A > B then
+  If A > B Then
     Result = A
-  else
+  Else
     Result = B
-  end if
+  End If
-  while A < 100
+  While A < 100
     A = A + 1
-  wend
+  WEnd
-При объявлении класса, секции следуют в следующем порядке: private, public. Если секция пустая, т.е. не содержит объявлений методов, переменных или properties, то она не указывается в объявлении класса. Начало каждой секции (кроме первой) выделяется пустой строкой. В пределах одной секции объявления переменных, методов и properties отделяются друг от друга пустыми строками. Кроме этого пустые строки используются для выделения логических групп (конструктор и деструктор отделяются от других методов; переменные, хранящие значения properties отделяются от других переменных и т.п.). Реализация методов класса происходит в обратном порядке, т.е. сначала public методы, затем protected и private, причем в пределах одной секции реализация методов происходит в порядке их объявления.
+При объявлении класса, секции следуют в следующем порядке: Private, Public. Если секция пустая, т.е. не содержит объявлений методов, переменных или properties, то она не указывается в объявлении класса. Начало каждой секции (кроме первой) выделяется пустой строкой. В пределах одной секции объявления переменных, методов и properties отделяются друг от друга пустыми строками. Кроме этого пустые строки используются для выделения логических групп (конструктор и деструктор отделяются от других методов; переменные, хранящие значения properties отделяются от других переменных и т.п.). Реализация методов класса происходит в обратном порядке, т.е. сначала Public методы, затем Protected и Private, причем в пределах одной секции реализация методов происходит в порядке их объявления.
 Пример:
@@ Строка 44: / Строка 46: @@
 * Комментарии должны быть написаны грамотным английским, белорусским или русским языком.
 * Всегда использовать константы вместо непосредственных значений.
 [[Category:Документация]]
 [[Category:Руководство разработчика]]