View source for RU/sha256

__NOTOC__
{{RU/Server client function}}
{{RU/Tip|
* Модуль [[RU/Modules/SHA|sha]] и эта функция могут конфликтовать друг с другом. Если вы используете эту функцию, то удалите модуль!
* Эта функция возвращает [[RU/String|строку]] в верхнем регистре, поэтому убедитесь, что вы используете [https://www.lua.org/pil/20.html string.upper()] или что-нибудь еще, чтобы сравнить [[RU/String|строки]] в одном регистре.

Вычисляет [[RU/hash|хэш]] sha256 указанной строки.

==Синтаксис==
<syntaxhighlight lang="lua">
string sha256(string str)
</syntaxhighlight>

===Обязательные аргументы===
*'''str:''' Строка для хеширования.

===Возвращаемые значения===
*'''[[RU/String|Строка]]''', ''содержащая sha256-[[RU/hash|хэш]] входной строки'', если удалось это сделать.
*'''[[RU/Boolean|false]]''', если не удалось вычислить sha256-[[RU/hash|хэш]].

==Требования==
{{RU/Requirements|1.3.1-9.04836|1.3.1-9.04836|}}

==Пример использования==
<syntaxhighlight lang="lua">
'''Пример 1.''' Этот пример генерирует sha256-хэш указанной строки и выводит его в чат при помощи команды /sha [строка].
addCommandHandler("sha", -- прикрепляет функцию к обработчику команды "sha"
	function(thePlayer, command, input)
		if (input) then -- если игрок ввёл аргумент, то
			local sha256hash = sha256( input ) -- генерирует хэш
			outputChatBox( sha256hash ) -- выводит хэш в чат
		end
	end
)
</syntaxhighlight>

==Смотрите также==
{{RU/Utility functions}}

[[en:sha256]]
[[ru:sha256]]