RU/Debugging - Revision history

StrixG at 16:43, 15 April 2017

2017-04-15T16:43:50Z

← Older revision		Revision as of 16:43, 15 April 2017
Line 301:		Line 301:

	[[en:Debugging]]		[[en:Debugging]]
			[[hu:Debugging]]
	[[it:Guida al Debug]]		[[it:Guida al Debug]]
			[[zh-cn:脚本调试教程]]

Ccw: Reverted edits by Bonzo (talk) to last revision by Fabervox

2016-04-01T03:06:31Z

Reverted edits by Bonzo (talk) to last revision by Fabervox

Show changes

Bonzo: Blanked the page

2016-03-31T16:03:26Z

Blanked the page

Show changes

Fabervox at 12:38, 29 September 2014

2014-09-29T12:38:25Z

← Older revision		Revision as of 12:38, 29 September 2014
Line 298:		Line 298:
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:~~Scripting Concepts~~]]		[[Category:Понятия скриптинга]]

	[[en:Debugging]]		[[en:Debugging]]
	[[it:Guida al Debug]]		[[it:Guida al Debug]]

Vincent: /* Добавляйте отладочные сообщения для проверки значения переменной */

2012-07-04T14:23:15Z

Добавляйте отладочные сообщения для проверки значения переменной

← Older revision		Revision as of 14:23, 4 July 2012
Line 82:		Line 82:
	Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.		Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox("posX ~~is:~~ "..x.." posY ~~is:~~ "..y.." posZ ~~is:~~ "..z)		outputChatBox("posX - "..x.." posY - "..y.." posZ - "..z)
	createMarker(x,y,z)		createMarker(x,y,z)
	</syntaxhighlight>		</syntaxhighlight>

Vincent at 14:22, 4 July 2012

2012-07-04T14:22:26Z

← Older revision		Revision as of 14:22, 4 July 2012
Line 16:		Line 16:
	</syntaxhighlight>		</syntaxhighlight>
	Когда скрипт, в котором присутствует данный отрывок кода попробует загрузиться, debugscript выведет что-то типа этого:		Когда скрипт, в котором присутствует данный отрывок кода попробует загрузиться, debugscript выведет что-то типа этого:
	{{Debug info\|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}		:{{Debug info\|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
	Это значит, что скрипт не может быть обработан в силу синтаксической ошибки. Показывается путь ко скрипту, чтобы можно было также увидеть, частью какого ресурса он является ('myResource' в данном случае), и, конечно, имя самого скрипта. После имени файла показан номер строки и что в ней, собственно, не так. Теперь все с легкостью можно исправить, мы просто забыли оператор 'then':		Это значит, что скрипт не может быть обработан в силу синтаксической ошибки. Показывается путь ко скрипту, чтобы можно было также увидеть, частью какого ресурса он является ('myResource' в данном случае), и, конечно, имя самого скрипта. После имени файла показан номер строки и что в ней, собственно, не так. Теперь все с легкостью можно исправить, мы просто забыли оператор 'then':
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 24:		Line 24:
	</syntaxhighlight>		</syntaxhighlight>
	Сейчас скрипт нормально загрузится и не выведет никаких ошибок, но только пока не выполнится для игрока с ником 'Fedor'. В этом случае, debugscript выведет:		Сейчас скрипт нормально загрузится и не выведет никаких ошибок, но только пока не выполнится для игрока с ником 'Fedor'. В этом случае, debugscript выведет:
	{{Debug error\|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}		:{{Debug error\|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
	То есть, что вызванной функции не существует, что и не удивительно, так как ее правильное название - ''outputChatBox'' (с заглавной ''B''):		То есть, что вызванной функции не существует, что и не удивительно, так как ее правильное название - ''outputChatBox'' (с заглавной ''B''):
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 82:		Line 82:
	Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.		Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox(~~tostring(~~x).." "..~~tostring(~~y).." "..~~tostring(~~z))		outputChatBox("posX is: "..x.." posY is: "..y.." posZ is: "..z)
	createMarker(x,y,z)		createMarker(x,y,z)
	</syntaxhighlight>		</syntaxhighlight>
Line 104:		Line 104:
	</syntaxhighlight>		</syntaxhighlight>
	При попадании игрока в колшейп, в консоль отладки выводится следующее сообщение:		При попадании игрока в колшейп, в консоль отладки выводится следующее сообщение:
	{{Debug error\|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}		:{{Debug error\|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
	Что значит, что вы пытались проиндексировать несуществующую таблицу. В образце выше это сделано, так как id таймера сохраняется в таблице. Нам нужно добавить проверку на то, существует ли таблица, а если нет - создать ее.		Что значит, что вы пытались проиндексировать несуществующую таблицу. В образце выше это сделано, так как id таймера сохраняется в таблице. Нам нужно добавить проверку на то, существует ли таблица, а если нет - создать ее.

Line 127:		Line 127:
	Но мы все же получаем предупреждение, когда игрок попадает в колшейп, ждет сообщения и снова его покидает:		Но мы все же получаем предупреждение, когда игрок попадает в колшейп, ждет сообщения и снова его покидает:

	{{Debug warning\|[..]: Bad argument @ 'killTimer' Line: ..}}		:{{Debug warning\|[..]: Bad argument @ 'killTimer' Line: ..}}

	За исключением этого сообщения (о нем поговорим позже) все, похоже, работает правильно. Игрок попадает в колшейп, таймер стартует, если он остается, появляется сообщение, если он уходит, таймер убирается.		За исключением этого сообщения (о нем поговорим позже) все, похоже, работает правильно. Игрок попадает в колшейп, таймер стартует, если он остается, появляется сообщение, если он уходит, таймер убирается.

Vincent at 08:17, 10 June 2012

2012-06-10T08:17:23Z

Show changes

WilliJ: /* Вывод отладочных сообщений для проверки значения переменной */

2011-05-17T15:36:42Z

Вывод отладочных сообщений для проверки значения переменной

← Older revision		Revision as of 15:36, 17 May 2011
Line 66:		Line 66:

	===Вывод отладочных сообщений для проверки ''значения'' переменной===		===Вывод отладочных сообщений для проверки ''значения'' переменной===
	Допустим, вы хотите создать маркер, но он не появляется в ожидаемом месте. Первое, что вы возможно захотите сделать - проверить, выполняется ли функция [[createMarker]].Но одновременно с этим можно также проверить передаваемые а функцию [[createMarker]] параметры.		Допустим, вы хотите создать маркер, но он не появляется в ожидаемом месте. Первое, что вы возможно захотите сделать - проверить, выполняется ли функция [[createMarker]].Но одновременно с этим можно также проверить передаваемые в функцию [[createMarker]] параметры.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))		outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))
Line 74:		Line 74:

	{{translate}}		{{translate}}

	==Пример==		==Пример==
	Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.		Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.

KGB: Translating

2010-07-02T17:12:29Z

Translating

← Older revision		Revision as of 17:12, 2 July 2010
Line 52:		Line 52:
	* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] для преобразования значений переменных в строки, к примеру когда они содержат булевы значения		* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] для преобразования значений переменных в строки, к примеру когда они содержат булевы значения
	* [[getElementType]] для определения типа элемента MTA		* [[getElementType]] для определения типа элемента MTA
	~~{{translate}}~~
	===~~Add debugmessages to check~~ ''if'', ''~~when~~'' or ''~~how often~~'' ~~a section of code is executed~~===		===Вывод отладочных сообщений для проверки ''как'', ''когда'' или ''как часто'' выполняется та или иная часть кода===
	~~A typical example would be verify whether an~~ ''if''~~-section is executed or not~~. ~~To do that~~, ~~just add any message you will recognize later within the~~ ''if''~~-section~~.		Простейшим примером является проверка, выполняется ли условие в операторе ''if''. Чтобы выполнить такую проверку, просто добавьте любое сообщение (которое вы сможете узнать впоследствии) внутрь секции, выполняемой при истинном условии в операторе ''if''.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	if (variable1 == variable2) then		if (variable1 == variable2) then
Line 62:		Line 62:
	</syntaxhighlight>		</syntaxhighlight>

	Another application would be to check when variable values are modified. First search for all occurences of the variable being edited and add a message just beside ~~it.~~		{{translate}}
			Another application would be to check when variable values are modified. First search for all occurences of the variable being edited and add a message just beside i

	===~~Add debugmessages to check the~~ ''~~value~~'' ~~of a variable~~===		===Вывод отладочных сообщений для проверки ''значения'' переменной===
	~~Let's say you want to create a marker~~, ~~but it doesn't appear at the position you expect it to be~~. ~~The first thing you might want to do is check if the~~ [[createMarker]] ~~function is executed~~. ~~But while doing this, you can also check the values being used in the~~ [[createMarker]] ~~function in one run~~.		Допустим, вы хотите создать маркер, но он не появляется в ожидаемом месте. Первое, что вы возможно захотите сделать - проверить, выполняется ли функция [[createMarker]].Но одновременно с этим можно также проверить передаваемые а функцию [[createMarker]] параметры.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))		outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))
	createMarker(x,y,z)		createMarker(x,y,z)
	</syntaxhighlight>		</syntaxhighlight>
	~~This would output all three variables that are used as coordinates for the marker~~. ~~Assuming you read those from a map file~~, ~~you can now compare the debug output to the desired values~~. ~~The~~ [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] ~~will ensure that the variables' value can be put together as a string~~, ~~even if it's a boolean value for example~~.		Этот код выведет 3 переменные - координаты маркера. Можно легко сравнить предполагаемые значения со значениями, выведенными при отладке. [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] преобразует переменные в строки, даже если они имеют, например, логический тип.

	==~~Example~~==		{{translate}}
			==Пример==
	Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.		Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

D0lph1n at 09:25, 1 December 2009

2009-12-01T09:25:44Z

← Older revision		Revision as of 09:25, 1 December 2009
Line 34:		Line 34:
	Конечно, это просто пример, есть множество других сообщений и сценариев.		Конечно, это просто пример, есть множество других сообщений и сценариев.

	==~~Debug logging~~==		==Ведение лога==
	Можно также включить режим дебаггера, отредактировав ''coreconfig.xml'' в папке GTA\MTA. Найдите в нем следующий тэг:		Можно также включить режим дебаггера, отредактировав ''coreconfig.xml'' в папке GTA\MTA. Найдите в нем следующий тэг:
	<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>		<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>
Line 44:		Line 44:
	<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>		<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>

	==~~Debug strategies~~==		==Стратегии отладки==
			Есть несколько методов, помогающих в поиске ошибок, кроме проверки всего кода. Большинство из них включает вывод различной информации, зависящей от конкретной ситуации.

			===Полезные функции===
			Сперва несколько функций, которые можно использовать для отладки.
			* [[outputDebugString]] или [[outputChatBox]] для вывода информации
			* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] для преобразования значений переменных в строки, к примеру когда они содержат булевы значения
			* [[getElementType]] для определения типа элемента MTA
	{{translate}}		{{translate}}
	There are several strategies that support finding errors, apart from going through the code of course. Most of them include outputting debug messages, with differing information depending on the situtation.

	~~===Useful functions===~~
	~~First of all some functions that may come in handy for debugging.~~
	* [[outputDebugString]] or [[outputChatBox]] for outputting any information
	* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] on a variable to turn it into a string, for example when it contains a boolean value
	* [[getElementType]] to check an MTA Element for its type

	===Add debugmessages to check ''if'', ''when'' or ''how often'' a section of code is executed===		===Add debugmessages to check ''if'', ''when'' or ''how often'' a section of code is executed===
	A typical example would be verify whether an ''if''-section is executed or not. To do that, just add any message you will recognize later within the ''if''-section.		A typical example would be verify whether an ''if''-section is executed or not. To do that, just add any message you will recognize later within the ''if''-section.