Plugin:MirLua/ru

2015-10-29T07:42:07Z

Radjah: /* Глобальные функции */

{{PluginCard}}
Расширяет функциональность Miranda NG с помощью скриптов на языке Lua.

== Глобальные функции ==
{| class="wikitable collapsible collapsed"
!Название
!Описание
!Пример
|-
|print
|выводит данные в network-лог Miranda NG
|<code>print('Hello, World!')</code>
|-
|a
|конвертирует содержимое lua строки в ansi
|<code>m.CallService("Some/AnsiService", 0, a'строка в ansi')</code>
|-
|u
|конвертирует содержимое lua строки в unicode
|<code>m.CallService("Some/UnicodeService", 0, u'строка в unicode')</code>
|-
|totable
|позволяет обращаться к полям переменной как к полям lua таблицы
|<code>local bcd = totable(l, "CustomButtonClickData")
print(bcd.Module)</code>
|-
|}

== Модули ==
=== m_core ===
Этот модуль изначально импортирован в глобальную таблицу и доступен через переменную '''m''' в любом модуле.
Он предоставляет доступ к основной функциональности Miranda NG.
{| class="wikitable collapsible collapsed"
|+ Функции
|CreateHookableEvent
|[[Api:CreateHookableEvent|CreateHookableEvent]]
|
|-
|HookEvent
|[[Api:CreateHookableEvent|CreateHookableEvent]]
|
|-
|UnhookEvent
|[[Api:UnhookEvent|UnhookEvent]]
|
|-
|NotifyEventHooks
|[[Api:NotifyEventHooks|NotifyEventHooks]]
|
|-
|DestroyHookableEvent
|[[Api:CreateHookableEvent|CreateHookableEvent]]
|
|-
|CreateServiceFunction
|[[Api:CreateHookableEvent|CreateHookableEvent]]
|
|-
|ServiceExists
|[[Api:ServiceExists|ServiceExists]]
|
|-
|CallService
|[[Api:CallService|CallService]]
|
|-
|DestroyServiceFunction
|[[Api:DestroyServiceFunction|DestroyServiceFunction]]
|
|-
|Utf8DecodeA
|конвертирует содержимое lua строки в ansi
|
|-
|Utf8DecodeW
|конвертирует содержимое lua строки в unicode
|
|-
|Translate
|переводит строку на язык текущего языкового пакета
|
|-
|ReplaceVariables
|заменяет переменные ядра Miranda NG в строке
|
|-
|GetFullPath
|возвращает строку, содержащую полный путь к исполняемому файлу Miranda NG
|
|-
|Free
|освобождает память, выделенную ядром Miranda NG
|'''<span style="color: red;">используйте данную функцию только если вы точно знаете что делаете</span>'''
|-
|}
=== m_database ===
Предоставляет доступ к данным и контактам в профиле пользователя.
Подключение модуля: <code>local db = require('m_database')</code> в
{| class="wikitable collapsible collapsed"
|+ Функции
|AllContacts
|Итератор для списка контактов протокола или всех контактов если в качестве параметра передан nil
|<code>
for hContact in db.AllContacts(proto.Name) do
print(db.GetSetting(hContact, proto.Name, 'Nick'))
end
</code>
|-
|GetEventCount
|возвращает количество событий для контакта
|<code>db.GetEventCount(hContact)</code>
|-
|AllEvents
|Итератор для списка событий контакта
|<code>
for hEvent in db.AllEvents(hContact) do
local event = totable(hEvent, "DBEVENTINFO")
print(event.Blob)
end
</code>
|-
|WriteSetting
|Сохраняет значение настройки
|db.WriteSetting(nil, 'test', 'some', true)
|-
|GetSetting
|Возвращает значение настройки
|db.GetSetting(nil, 'test', 'some')
|-
|AllSettings
|Итератор для списка настроек из секции контакта или из глобальной секции если в качестве параметра передан nil
|<code>
for setting in db.AllSettings(nil, 'CList') do
local message = string.format("%s/%s = ", 'CList', setting, ...)
.. db.GetSetting(nil, 'CList', setting)
print(message)
end
</code>
|-
|DeleteSetting
|Удаляет настройку
|db.DeleteSetting(nil, 'test', 'some')
|-
|DeleteModule
|Удаляет секцию
|db.DeleteModule(nil, 'test')
|-
|}

== Примеры ==
{{Content:MirLua/Examples}}

== Ссылки ==
* [http://forum.miranda-ng.org/index.php?topic=4161.0 Примеры скриптов в теме на форуме]
* [http://www.lua.org Веб-сайт Lua]{{RefLang|en}}
* [https://ru.wikipedia.org/wiki/Lua Lua в Википедии]

{{PluginGroups}}

Miranda NG - User contributions [en]

Plugin:MirLua/ru