Feature / Возможность

UMCL

UMC

UMX

GUI / Графический интерфейс

none / нет

present / есть

present / есть

Splashscreen / Заставка

none / нет

none / нет

present / есть

Variables / Переменные

none / нет

none / нет

present / есть

Scripting / Скрипты

none / нет

none / нет

present / есть

Statistics / Статистика

limited / ограниченно

limited / ограниченно

present / есть

Special russian macros / Специальные русские макросы

none / нет

present / есть

present / есть

Other macros / Прочие макросы

limited / ограниченно

limited / ограниченно

all / все

Antispam / Антиспам

none / нет

none / нет

present / есть

Macro / Макрос

Description

Описание

%UMC

Returns  the UMC version and the full list of UMC macros

Возвращает информацию о версии плагина и полный список макросов, содержащихся в плагине

%UMCVER

Returns  the name and the version of UMC

Возвращает информацию о названии и версии плагина

%UMCSVER

Returns  the version of UMC

Возвращает версию плагина

Macro / Макрос

Description

Описание

%STAT (StatisticsID,"InPattern", "OutPattern","Delimiter")

* UMX only *

Searches the statistics data base. StatisticsID specifies  the type of statistics where  the search  is
performed
0 - by words
1 - by charsets
2 - by mailer
3 - by sender address
4 - by recipient address
10 - by sender IP
11 - by sender name
12 - by recipient name
13 - by internet connection name
14 - by sender's server
15 - by all servers which letter trespass

InPattern  sets the regexp to search for.
For ex., "a" will return  all the entries containing the letter "a", "^a"  all the
entries beginning with an "а", "a$" - all the entries ending with an "а" and so on.

OutPattern allows  to specify an expression to format the output text.
You can use common strings and special variables. For each entry found the
following  variables are defined: $$entry - entry name ($$entry matches
"Inpattern"); $$cdate - datestamp of creation of current element (time
when this element has been fixed in statistics file first time),
$$mdate - last modification date, $$size  the size of the element
(for ex., in case of searching in statistics by server name, total
letter size came from this server will be associated with the value of
$$size so you can use this OutPattern:
"You have received $$size bytes through the $$entry"),
$$val - how many times this entry has been fixed in statistics (for
ex., in case on statistics by words, $$val is the number of  times
this word has been found in all incoming mail).
$$cnt - number of this entry in search results (autoincrement)

Delimiter  is the string which will be placed between two result
strings. For ex., if you want  to have a comma-separated output, use ", "
as a delimiter. If you want to output one result per line, use "$$nl".

Global example for %STAT is:

%STAT(0,"b.t","Element no. $$cnt: $$entry, total: $$val","$$nl")

Here is a  result of this query::


------------ begin --------------
Element no. 1: abit, total: 1
Element no. 2: bat, total: 21
Element no. 3: bit, total: 1
Element no. 4: bitsetting, total: 2
Element no. 5: gigabyte, total: 1
Element no. 6: kurbatov, total: 2
Element no. 7: thebat, total: 2
Element no. 8: verbatim, total: 4
------------- end ---------------

* UMX only * Выполняет поиск в базе данных статистики.
StatisticsID задаёт тип статистики, в которой осуществлять поиск:
0 - по словам
1 - по кодировкам
2 - по почтовой программе
3 - по адресу отправителя
4 - по адресу получателя
10 - по IP
11 - по имени отправителя
12 - по имени получателя
13 - по имени соединения
14 - по серверу отправителя
15 - по всем серверам

InPattern задаёт регулярное выражение для поиска.
Так, "a" найдёт все элементы, содержащие букву "а", "^a" - начинающиеся с "а",
"a$" - заканчивающиеся на "а" и т. п.

OutPattern задаёт выражение для вывода результата.
Здесь можно использовать специальные переменные.
Для каждого найденного элемента определены следующие переменные:
$$entry - имя элемента (оно удовлетворяет шаблону InPattern);
$$cdate - время создания данного элемента (т. е. когда он впервые был зафиксирован в статистике),
$$mdate - дата последней модификации,
$$size - объём элемента
(например, в случае статистики по имени сервера, данному элементу сопоставляется суммарный объём писем, прошедших через данный сервер и попавших в статистику - вы можете сделать такой шаблон:
"Через сервер $$entry прошло писем на $$size байт"),
$$val - сколько раз данный элемент фиксировался в статистике
(например, для статистики по словам $$val соответствует тому, сколько раз данное слово встречалось во входящих письмах).
$$cnt - порядковый номер в результатах поиска.

Delimiter - это строка, которая будет вставлена при выводе между двумя соседними результатами.
Например, для перечисления результатов через запятую вы можете задать шаблон ", "
Для того, чтобы каждый результат выводился с новой строки, укажите в качестве параметра "$$nl".

В общем, можно сделать что-то такое:
%STAT(0,"b.t","Элемент номер $$cnt: $$entry, всего: $$val","$$nl")
И в результате получить:
------------ begin --------------
Элемент номер 1: abit, всего: 1
Элемент номер 2: bat, всего: 14
Элемент номер 3: gigabyte, всего: 1
Элемент номер 4: thebat, всего: 2
------------- end ---------------

%UMCATTCOUNT

Returns  the number of attachments of a source letter

возвращает количество аттачей исходного письма

%UMCIFONLINE ("IfOnline","IfOffline")

Determines whether you computer is connected to the internet or not. Syntax: %UMCIFONLINE("IfOnline","IfOffline") - returns the first parameter if connection is  established, the second one if it is not. For ex., %UMCIFONLINE("I'm online :)","I'm offline :(")

определяет, подключен ли в данный момент компьютер к интернету. Синтаксис: %UMCIFONLINE("IfOnline","IfOffline") - возвращает первый параметр, если подключение установлено и второй, если - нет. Например: %UMCIFONLINE("I'm online :)","I'm offline :(")

%UMCONLINETIME(UNIT)

Returns you the total time you were online since statistics  have been started.
UNIT can be one  of the following: "S" - seconds, "M" - minutes, "H" - hours, "В" - days, "m", "O" or "1" - months, "Y" - years, "T" - "hh:mm:ss", "L" - "DD/MM/YY hh:mm:ss", "2" or "s" - short names of time units (1 min 15 sec)

возвращает суммарное время, проведённое в интернете с момента начала ведения статистики.
Значение параметра UNIT такое же, как в %UMCDELIVTIME и подобных ему

%STATCOUNT

* UMX only * Returns you a number of letters you received since statistics has been started

* UMX only * возвращает количество писем, пришедших с момента последнего обнуления статистики

%STATTIMES

* UMX only * Returns   the number of seconds since statistics has been started

* UMX only * возвращает количество секунд, прошедших с момента последнего обнуления статистики

%STATTIME

* UMX only * Returns   the  time since statistics has been started. (Note that this macro contained  a bug, fixed since 2.0.975 version)

* UMX only * возвращает время, прошедшее с момента последнего обнуления статистики

%UMCSE (year,month,day,hou,min,sec)

Returns  the  number of seconds elapsed since the time you specified

возвращает число секунд, прошедшее с указанного момента

%STATS(p,u)

Returns  the  total size of letter parts you received. "p" specifies parts of letter (H-header, B-text, A-attaches, T-total size). "u" specifies  the unit (B-bytes, K-kilobytes, M-megabytes, G-gigabytes, A-adaptive).
For ex., if you want to get the total size of attachments you received, use %STATS(A,K)

возвращает суммарный размер пришедших указанных частей письма. Параметр p указывает часть письма (H-заголовок, B-текст, A-приложение (аттач), T-полный размер письма). Параметр u указывает единицу измерения. (B-байты, K-килобайты, M-мегабайы, G-гигабайты, A-адаптивный вывод).
Единицы измерения подставляются из лангфайла. Например, если нужно узнать суммарный объём приложений в килобайтах, присланных с момента последнего обнуления статистики, используйте макрос %STATS(A,K)

%STATMS(p,u)

Returns  the  mean size of letter's parts. Parameters are similar to %STATS

возвращает средний размер пришедших указанных частей письма. Параметр p и u аналогичны параметрам %STATS

%STATTRAFFIC(p,u,t)

Returns  the  size of traffic you received per time interval. Parameters "p" and "u" are described above. Parameter "t" can be one of the following: S-seconds, M-minutes, H-hours, D-days, W-weeks, Y-years.
For ex., if you want to know how many kilobytes you received in headers during a week, use this: %STATTRAFFIC(H,K,W)

подсчёт траффика за определённый период времени. Параметры p и u описаны выше, параметр t может принимать следующие значения: S-секунды, M-минуты, H-часы, D-дни (сутки), W-недели (7 дней), Y-годы (365.25 суток). Например, если вы хотите узнать, сколько занимают заголовки писем, приходящих вам в течении одной недели, в килобайтах, используйте такой макрос: %STATTRAFFIC(H,K,W)
Для того, чтобы обнулить статистику, воспользуйтесь диалогом настройки плагина в меню Свойства-Настройка-Модули Расширения-"Useless Macro Collection"-Настроить-вкладка "Основные настройки"-"Обнулить статистику". Статистические макросы ведут отсчёт данных с момента установки модуля либо с момента последнего обнуления статистики. Данные статистики хранятся в системном реестре.

%STATSESSIONTIME

Time, in seconds, of the current The Bat! Session

продолжительность в секундах текущего сеанса работы программы

%STATSESSIONTOTALTIME

Time, in seconds,  since The Bat! runs

суммарная продолжительность работы с момента последнего обновления статистики

%STATSTARTCOUNT

Number of times The Bat! was started

количество удачных запусков TheBat!

%STATENDCOUNT

Number of times The Bat! was ended (this value will increment only
if The Bat! was stopped correctly)

количество удачных выходов из TheBat!

%STATSESSIONMEANTIME

The mean length of The Bat! sessions

средняя продолжительность работы в TheBat!

%UMCLINCNT("TEXT")

Returns   the number of strings per text

возвращает число строк в тексте

%UMCSYMCNT("TEXT")

Returns   the number of symbols per text

возвращает число символов в тексте

%UMCINETTIME("Header")

Returns   the internet-time, in bits, 1000 bits per day

возвращает текущее интернет-время в битах
(в сутках - 1000 бит)

%UMCDELIVERYFROMIP ("Header")

Returns   the sender's IP, by default,
"Received:". In some cases, you should use %UMCDELIVERYFROMIP('Resent-Received:')

возвращает IP отправителя (из заголовков).
параметр "Header" определяет заголовок, по которому необходимо вычислять IP.
По умолчанию - "Received:". Модификация введена специально для конференций subscribe.ru, где необходимо указывать заголовок %UMCDELIVERYFROMIP('Resent-Received:')

%UMCDELIVERYFROMSERVER

Returns   the sender's server name

возвращает сервер отправителя (из заголовков)

%UMCSERVLIST

Returns   the list of servers that source letter has been trespassed
Syntax:
%UMCSERVLIST(SeparatorID)
%UMCSERVLIST(SeparatorID,ALL)
SeparatorID - separator (S - space, M - minus, L - line feed, С -
comma). By default - "S".
By specifying the parameter ALL, you can also have  in this list  the servers that did not communicate their names, only IP

возвращает список серверов, через которые прошло письмо.
Синтаксис:
%UMCSERVLIST(SeparatorID)
%UMCSERVLIST(SeparatorID,ALL)
SeparatorID - разделитель (S - пробел, M - минус, L - перевод строки, С - запятая). По умолчанию - пробел.
Если указать необязательный параметр ALL, в списке будут присутствовать также и те сервера, которые не сообщили своё имя - только IP

%UMCMOUSEWAY(LUNIT)

* UMX/UMC only * Returns  the length of the track(path) made by your mouse since The Bat! was  started.
LUNIT can be one of the following: С - centimeters, M - meters, K - kilometers, X - pixels, any other value - millimeters

* UMX/UMC only * возвращает длину пути, проделанного мышкой с того момента, как был запущен бат.
LUNIT принимает одно из следующих значений: С - сантиметры, M - миллиметры, K - километры, X - пиксели, любое другое значение - миллиметры.

%UMCMOUSESPEED (LUNIT,TUNIT)

* UMX/UMC only * Returns  the  mean mouse speed in desired units:
LUNIT - length units: С - centimeters, M - meters, K - kilometers, X - pixels, any other value - millimeters
TUNIT - time units: M - minutes, H - hours, В - days, any other value - seconds
For ex., %UMCMOUSESPEED(K,H) will return you a mouse speed in kmph

* UMX/UMC only * возвращает среднюю скорость передвижения курсора мыши.
LUNIT - единицы длины (С - сантиметры, M - миллиметры, K - километры, X - пиксели, любое другое значение - миллиметры).
TUNIT - единицы времени (M - минуты, H - часы, В - дни, любое другое значение - секунды).
Например, %UMCMOUSESPEED(K,H) вернёт скорость мыши в км/ч.

Macro / Макрос

Description

Описание

%UMCDELIVTIME (TimePoint1,TimePoint2,UNIT,U)

Returns  the time elapsed from one point of a letter lifetime to other one.
"TimePoint" can be one of the following:
1 - a letter creation
2 - time when a letter was  received by sender's server
3 - time when a letter was  received by recipient's server
4 - time when a letter was  received by The Bat!
5 - current time.
UNIT can be one of  the following:
"S" - seconds, "M" - minutes, "H" - hours, "В" - days, "m", "O" or "1"
- months, "Y" - years, "T" - "hh:mm:ss", "L" - "DD/MM/YY hh:mm:ss",
"2" or "s" - short names of time units (1 min 15 sec).
The last optional parameter "U" adds name of time unit when it is
necessary. (In order to use this parameter, just add a comma and the letter"U" as the last parameter).

считает время, прошедшее от одного этапа жизни письма до другого.
Параметр TimeMode может принимать следующие значения:
1 - создание письма
2 - приход письма на почтовый сервер отправителя
3 - приход письма на почтовый сервер получателя
4 - получения письма батом
5 - ответ на письмо (текущее время).
UNIT - это:
S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы,
T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс,
2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек),
3 или l - полностью прописью.
Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо.

%UMCCHARSET

Returns you name of source letter's charset. If is meaningful only when you're reply/forward

возвращает название кодировки исходного письма. Имеет смысл только при ответе/форварде

%UMCMAILER

Returns  the name of the source letter's mailer.  Is only meaningful  when you reply/forward

возвращает название почтовой программы отправителя. Имеет смысл только при ответе/форварде

%UMCREPLYTIME

Returns  the time between creating of a source letter and replying (current time)

возвращает время, прошедшее между написанием исходного письма и ответом на него

%UMCGETLINKS("Text")

Returns  the list of URLS from source text. If "text" is omitted, the source text is used

получает список ссылок из текста. Если параметр "Text" не указан, используется текст исходного письма без подвала

%UMCCUTHERE

Inserts Bat-style footer delimiter "-- "

вставляет батовский символ обрезки цитирования "-- "

%UMCKILLCITE("Text",level)

Removes  citations with the depth of a “level” or more. The value of « level » is 2 by deafaul.

убирает строки с глубиной цитирования level и больше. Значение level по умолчанию (если не указано или равно 0) полагается 2.

%UMCMKLINK("Text")

 Converts a string into %-based view, useful for link creation.
For ex., %UMCMKLINK("Cool link") will give you Cool%20link

представляет строку в вид, удобный для создания ссылок
необязательный параметр A позволяет перекодировать только те символы, который имеют ASCII код, больший 127.

%UMCCITE("Text","Slogan",nStrings)

Leaves only "nStrings" number of strings of source text, and places "Slogan" string in center of these. This macro is useful for reading confirmation templates

оставляет от текста всего nStrings строчек (nStrings/2 первых и столько последних, чтобы их в сумме было nStrings), и по необходимости вставляет посередине Slogan. Например, %UMCCITE(%UMCSTRINGS(1,2,3,4,5,6,7,8),"поскипано",4) даст в результате:
1
2
поскипано
7
8

%UMCWRAP ("text",maxwidth,"delimiter")

This macro allows  to break specified text into a number of lines per "MaxWidth" characters per line. "Delimiter" will be added to the end of each line except for the last one. By default delimeter symbol is “\”

Позволяет разбивать текст на строки по maxwidth символов в каждой, добавляя в конец delimiter. По умолчанию delimiter принимается равным "\".

%UMCMD5 ("Text")

* UMX/UMC only * returns  a hash of the string

* UMX/UMC only *

%UMCCRC32("Text")

* UMX/UMC only * returns  a hash of the string

* UMX/UMC only *

%UMCCRC16("Text")

* UMX/UMC only * returns  a hash of the string

* UMX/UMC only *

%UMCDECODESTR("Text")

* UMX/UMC only *

* UMX/UMC only *

%UMCIZVRAT("Text",Value)

* UMX/UMC only *

(Cyrillic-specific)
Processes Russian text, replacing in a random manner the vowels by other vowels, and the consonants by other consonants.
Parameter “Value” sets the level of changes: 0 - the text is not processed, 100 - all letters are replaced, 5 - approximately 5% of the text is processed.

* UMX/UMC only * обрабатывает русский текст, заменяя случайным образом гласные буквы - на другие гласные, а согласные - на другие согласные. Параметр Value указывает частоту изменений. 0 - текст не будет обработан, 100 - все буквы будут заменены, 5 - будет обработано примерно 5% текста.

%UMCNUMTOSTR

* UMX/UMC only *

(Cyrillic-specific)
%UMCNUMTOSTR (Number, p, g) or %UMCNUMTOSTR (Number, p) or %UMCNUMTOSTR (Number)
Transforms numbers into Russian numerals.
p sets the case: I or И - nominative, R or Р (Cyrillic) - genitive, D or Д - dative, T (Latin or Cyrillic) - instrumental, P (Latin) or П - prepositional. Accusative case is the same as genitive (for animated), or nominative (for inanimate). The case by default - nominative.
g sets the gender: M (Latin or Cyrillic) - masculine (by default), F or Ж - female.
For example, %UMCNUMTOSTR (43008040,l) returns “сорок три миллиона восемь тысяч сорок”.

* UMX/UMC only *%UMCNUMTOSTR(Number,p,g) либо %UMCNUMTOSTR(Number,p) либо %UMCNUMTOSTR(Number) - преобразует число цифрой в количественное числительное прописью. P указывает падеж. (I или И - именительный, R или Р(русское) - родительный, D или Д - дательный, T(латинская или русская) - творительный, P(латинский) или П - предложный. Винительный падеж (одуш.) совпадает по форме с родительным, или именительным (неодуш.). По умолчанию - именительный падеж). g указывает род. (M (латинская или русская) - мужской род, F или Ж - женский. По умолчанию - мужской). Например, %UMCNUMTOSTR(43008040,I) даст сорок три миллиона восемь тысяч сорок.

%UMCNUMTOSTRА(Number,p,g)

* UMX/UMC only *
(Cyrillic-specific)
Transforms numbers into Russian ordinal numerals.
p sets the case: I or И - nominative, R or Р (Cyrillic) - genitive, D or Д - dative, T (Latin or Cyrillic) - instrumental, P (Latin) or П - prepositional. Accusative case (animated) is the same as genitive (for animated), or nominative (for inanimate). The case by default is nominative.
g sets the gender: M (Latin or Cyrillic) - masculine (by default), singular; F or Ж - female, singular; С (Cyrillic) or N - a neutral, singular.
Н (Cyrillic) or P (Latin) – plurals.
For example, %UMCNUMTOSTRA (2737783, I, N) returns “два миллиона семьсот тридцать семь тысяч семьсот восемьдесят третье”.

* UMX/UMC only *преобразует число цифрой в порядковое числительное прописью. P указывает падеж. (I или И - именительный, R или Р(русское) - родительный, D или Д - дательный, T(латинская или русская) - творительный, P(латинский) или П - предложный. Винительный падеж (одуш.) совпадает по форме с родительным, или именительным (неодуш.). По умолчанию - именительный падеж). g указывает род/число. (M (латинская или русская) - мужской род, ед. ч., F или Ж - женский ед. ч., С (русская) или N - средний род, ед. ч., Н (русская) или P (латинская) - множественное число. По умолчанию используется мужской род). Например, %UMCNUMTOSTRA(2737783,I,N) даст два миллиона семьсот тридцать семь тысяч семьсот восемьдесят третье.

%UMCBYTESTOSTR

* UMX/UMC only *

* UMX/UMC only *

%UMCNUMTOSTR

* UMX/UMC only *

* UMX/UMC only *

%UMCSEPARATOR("String",Length)

Returns a string randomly made of symbols taken from the string “String” with the length of “Length”

выдает строку, состоящую из произвольно взятых символов строки String длиной Length

%UMCCUTFROMTO("Text","FromS","ToS")

Cuts out the part of the text in between “FromS” and “ToS”

вырезает из текста часть от первого вхождения "FromS" до первого вхождения "ToS"
Например, %UMCCUTFROMTO("Я был когда-то странной","был ","-то") вернёт "когда".
Если "FromS" либо "ToS" не содержатся в тексте, текст по соответствующей строке не обрезается. Например, %UMCCUTFROMTO("Я был когда-то странной","Собака","-то") даст "я был когда".

%UMCTRANSLIT("Text")

(Cyrillic-specific)
Transforms Russian text into translit, according to the rules of English transcription.
For example, %UMCTRANSLIT ("Черенок") returns “Cherenok”

Преобразует русский текст в транслит, совместимый с правилами транскрипции, принятой в английском языке. %UMCTRANSLIT("Черенок") даст Cherenok

%UMCTRANSLIT2("Text")

(Cyrillic-specific)
Transforms Russian text into translit in a “barbarous" way, Russian letters are replaced by similar Latin letters.
For example, %UMCTRANSLIT ("Черенок") returns “4epeHok”

преобразует русский текст в транслит по "варварской" транскрипции путём замены русских букв на сходные по написанию латинские. %UMCTRANSLIT2("Черенок") даст 4epeHok

%UMCRCASE ("Text")

Randomizes case of each character of given text

преобразует текст в текст со случайным регистром символов

%UMCMKPLAIN("Text")

Converts given multiline text into one line (removes line feeds)

преобразует многострочный текст в одну строку

%UMCKILLEMPTYSTR("Text")

Removes empty strings from source text

возвращает текст без пустых строк и строк, состоящих только из пробелов

%UMCREPLACENUM("Text","plist","llist")

* UMX/UMC only *
(Cyrillic-specific)
Replaces numbers by Russian numerals in the specified text.
Parameter plist sets the case: a letter sets the case for a corresponding number.
Parameter llist sets the gender, the number, and the type of the numeral.
Possible values:
M (Latin or Cyrillic) - masculine gender, singular, ordinal numeral
F or Ж - female gender, singular, ordinal numeral
C (Cyrillic) or N - neutral gender, singular, ordinal numeral
Н (Cyrillic) or P (Latin) - plural, ordinal numeral
m, м, or 1 - masculine gender, quantitative
f, ж, or 2 - feminine gender, quantitative
Default values: masculine gender, nominative case, quantitative type.
For example, %UMCREPLACENUM ("12 октября 2004 года 23:20","ИРИИ","СС1м") returns the line
“двенадцатое октября две тысячи четвёртого года двадцать три:двадцать”,
where the first number, “12”, is converted into an ordinal numeral in nominative case, neutral gender;
the second number, “2004”, is converted into an ordinal numeral in genitive case, neutral gender;
the third and the fourth numbers, “23” and “20” are converted into quantitative numerals in nominative case, masculine gender.
Parameters "plist" and "llist" can be omitted or be shorter than the number of numbers in the text. In this case the values by default are used.

* UMX/UMC only * заменяет в указанном тексте числа цифрами на числительные. Параметр plist служит для указания падежа, где N-я буква - это падеж N-й цифры, встретившейся в тексте. Параметр llist служит для указания рода, числа и типа числительного. (Возможные значения: M (латинская или русская) - мужской род, ед. ч., порядковое, F или Ж - женский ед. ч., порядковое, С (русская) или N - средний род, ед. ч., порядковое, Н (русская) или P (латинская) - множественное число, порядковое, m или м, или 1 - мужской род, количественное, f, или ж, или 2 - женский род, количественное).. По умолчанию используется мужской род). По умолчанию падеж полагается именительным, тип - количественное. Например, %UMCREPLACENUM("12 октября 2004 года 23:20","ИРИИ","СС1м") вернёт строку
двенадцатое октября две тысячи четвёртого года двадцать три:двадцать
где первое числительное - 12 - стоит в именительном падеже,среднем роде и является порядковым, второе - 2004 - в родительном, среднем роде, является порядковым, третье и четвёртое числа - 23 и 20 - стоят в именительном падеже, мужском роде, являются количественными числительным. Параметры "plist" и "llist" могут отсутствовать либо быть короче общего числа чисел в тексте. В этом случае по используются значения по умолчанию, где это необходимо.

%UMCBYTESTOSTRRUS(P,UNITS,NUMBER)

* UMX/UMC only *

Cyrillic-specific

Converts numbers into Russian numerals (the case of the word "byte" is in accordance with the case of the numerals).

P sets the case (I or И - nominative, R or Р (Cyrillic) - genitive, D or Д - dative, T (Latin or Cyrillic) - instrumental, P (Latin) or П - prepositional. Accusative case is the same as genitive (for animated), or nominative (for inanimate). The case by default is nominative.

UNIT sets the output units (B - bytes, K - kilobytes, M - megabytes, G – gigabytes, T - terabytes).

NUMBER – the number to convert.

It is possible to combine this macro with macros returning the size of files or free space on a disk, having specified in parameters, that the returned value should be in bytes.

For example,

%UMCBYTESTOSTRRUS(I,B,10001110)

%UMCBYTESTOSTRRUS(R,K,10001110)

%UMCBYTESTOSTRRUS(D,M,10001110)

return

“десять миллионов одна тысяча сто десять байт

девяти тысяч семиста шестидесяти шести килобайт

девяти мегабайтам”.

* UMX/UMC only *Преобразует число в байтах в число в байтах прописью

(падежи слова "байт" и числительного согласуются!).
P - падеж (I или И - именительный, R или Р(русское) - родительный, D или Д - дательный, T(латинская или русская) - творительный, P(латинский) или П - предложный. Винительный падеж (одуш.) совпадает по форме с родительным, или именительным (неодуш.). По умолчанию - именительный падеж).
UNIT - единицы измерения на выходе (B-байты, K-килобайты, M-мегабайты, G-гигабайты, T-терабайты).
NUMBER - Само число. Можно использовать в комплекте с макросами, возвращающими размер файлов или свободного места на диске, указав им в параметрах, что возвращаемое значение должно быть в БАЙТАХ.
%UMCBYTESTOSTRRUS(I,B,10001110), %UMCBYTESTOSTRRUS(R,K,10001110) и %UMCBYTESTOSTRRUS(D,M,10001110) дадут, соответственно,
десять миллионов одна тысяча сто десять байт
девяти тысяч семиста шестидесяти шести килобайт
девяти мегабайтам.

%UMCREPLACE ("Text","TextToFind","TextToReplace")

Replaces all the substrings TextToFind found in the Text by the substring TextToReplace.

For example,

%UMCREPLACE("I love Basil","Basil","Peter") returns "I love Peter"

заменяет все вхождения подстроки TextToFind на TextToReplace в тексте. TextToFind не должна содержаться в TextToReplace. Например, %UMCREPLACE("Я люблю Васю","Васю", "Петю") даст я люблю Петю

%UMCREPLACECHAR("Text1","Char","Text2")

Replaces all the characters Char found in the Text1 by the string Text2.

For example,

%UMCREPLACECHAR("vasya@pisem.net","@","<at>") returns vasya<at>pisem.net

ищет в тексте text1 вхождения символа char и заменяет его на строку text2.
Например, %UMCREPLACECHAR("vasya@pisem.net","@","<сабака>") даст в результате vasya<сабака>pisem.net

%UMCREPLACEREGEXP ("Text","PatternToSearch","ReplaceWith")

Allows replacements in the text using regular experessions.

For example,

%UMCREPLACEREGEXP("%Text","U[M,m]C","Useless Macro Collection")

replaces in the input text all the strings "UMC" and "UmC" by the string "Useless Macro Collection".

позволяет осуществлять замену в тексте, используя регулярные выражения.
Например, %UMCREPLACEREGEXP("%Text","U[M,m]C","Useless Macro Collection") заменит в исходном тексте письма все вхождения строк "UMC" и "UmC" на "Useless Macro Collection"

%UMCCUTON("Text","Delimiter")

обрезает текст, начиная с первого вхождения разделителя.

%UMCGREP ("Text","RegExpToFind", Separator,"Template",Separator2)

Allows to find all the occurrences of the regular expression RegExpToFind in the string Text.

Separator sets the separator of results. Can take the following values: L – a new line (each new occurrence is placed on a new line), S – a blank, C – a comma, N – no separator (by default).

Template sets the order to return subexpressions of  the regular expression.

For example,

“12A1” indicates that the output is composed of the first subexpression, then the second, the tenth, and then the first again.

Separator2 sets the separator for subexpressions, values are the same as for Separator.

позволяет находить ВСЕ вхождения регулярного выражения RegExpToFind в строке "Text".
Separator - параметр, определяющий разделитель результатов. Может принимать следующие значения: L - новая строка (каждое новое вхождение будет располагаться на новой строке), S - пробел, C - запятая, N - разделитель отсутствует. По умолчанию (если параметр опущен) - N.
"Template" определяет, в каком порядке возвращать подвыражения регулярного выражения. Например, значение "12A1" означает, что в ответ надо вставить первое, второе, десятое, затем снова первое подвыражение. Separator2 - разделитель для подвыражений, по умолчанию - такой же, как Separator.

%UMCGETSMS(length)

Prompts for the input of a short text, length sets the number of characters. Useful for sending SMS.

выводит диалог ввода текста длиной length символов. Полезно для любителей SMS

%UMCFILL ("Text","Char",Width,"LeadIn","Leadout", BegStr,EndStr,JustifyType,"Delimiter")

Fills the Text with symbols Char, Width sets the line width, LeadIn is put at the beginning of the line, LeadOut is put at its end, adds BegStr and EndStr of lines, filled with Char, in the beginning and in the end, justifies the text (JustifyType=0), aligns it to the left (1) or to the right (2), truncates the text at the Delimiter. Allows multilined texts.

For example,

%UMCFILL("%UMCCPUNAME",".",80,"[ "," ]",2,2,2)

Returns for me the following:

First three parameters “Text”, “Char” and “Width” are obligatory, others can be omitted.

заполняет текст символами "Char" до указанной ширины строки, вставляет в начале и конце каждой строки "LeadIn" и "LeadOut", добавляет в начало и конец BegStr и EndStr строк, заполненных "Char", выравнивает текст по центру (JustifyType=0), влево (1) или вправо (2), обрезает текст по "Delimiter". Поддерживает многострочный текст. Например, %UMCFILL("%UMCCPUNAME",".",80,"[ "," ]",2,2,2) у меня даёт такой результат:
................................................................................
................................................................................
.....................................................[ AMD Athlon(tm) XP 2000+ ]
................................................................................
................................................................................
................................................................................
Первые три параметра - "Text", "Char" и Width обязательны, остальные могут быть пропущены.

%UMCXOR("Text",mask)

кодирует текст с помощью обратимого XOR-шифрования

%UMCCNT("text",ID)

Counts the number of letters (ID it is set to L), blanks (S), or punctuation marks (P). By default ID it is set to L.

For example,

%UMCCNT ("%Text", P) returns the number of punctuation marks in the input letter.

подсчитывает количество букв (если ID равен L), пробелов (S), или знаков препинания (P). По умолчанию ID полагается равным L.
Например, %UMCCNT("%Text",P) возвратит количество знаков препинания в исходном письме.

%UMCREVERSE("Text")

Returns a backward line. Allows multilined texts.

For example,

%UMCREVERSE ("lived") returns devil

Parameter L allows to put lines backward without changing their order.

%UMCREVERSE ("Text", L).

возвращает строку "задом наперёд". Поддерживает многострочный текст. %UMCREVERSE("абырвалг") даст главрыба
параметр L, позволяет переворачивать строки, не изменяя их порядка. %UMCREVERSE("Text",L).

%UMCSTRCMP("Str1","Str2")

Compares two strings and returns 1 if they are equal, and 0 otherwise

сравнивает две строки и возвращает 1, если строки равны и 0 в ином случае

%UMCSTRIN("String","Str1","Str2",...)

compares "String" with set of strings: "Str1", "Str2",... and returns 1 if "String" matches any of "StrX", 0 otherwise

сравнивает строку String с набором строк Str1, Str2,... и возвращает 1, если String совпадает с любой из строк набора, иначе - 0

%UMCSELECT("String","Str1","Val1","Str2","Val2",...)

Compares the String with strings Str1, Str2, and so on. In case when String matches StrX, the macro returns ValX, otherwise it returns an empty line.

сравнивает строку String с Str1, Str2 и т. д. В случае, если String совпадает с StrX, то макрос принимает значение ValX, иначе - пустая строка

%UMCSTRINGS("String1",...)

Converts set of strings into a string list (one string per line)

преобразует последовательность строк в список. Например, %UMCSTRINGS("раз","два","и обчёлся") даст
раз
два
и обчёлся

%UMCPS("Text","Prefix","Suffix")

Adds prefix and suffix to each string of multiline text.

добавляет в начало каждой строки текста префикс, а в конец - суффикс. Например, %UMCPS(%UMCGETLINKS("глючная http://a.com/a.zip или же http://muh.ru/b.avi"),"GET ") даст
GET http://a.com/a.zip
GET http://muh.ru/b.avi
Параметр Prefix и (или) параметр Suffix могут быть пропущены.

Macro / Макрос

Description

Описание

%UMCTIME

Returns  system time with precision of 15 ms

возвращает системное время с точностью до 15 миллисекунд

%UMCTZ

Returns  current timezone

возвращает текущую временную зону (TimeZone)

%UMCTZBIAS

Returns  current timezone bias

возвращает временное смещение зоны

%UMCTICKCOUNT

Returns  time elapsed since your system was started

возвращает время, прошедшее с момента запуска системы.

%UMCDAYSLEFT (ZarplataDay,ZarplataHour,
AvansDay,AvansHour)
или 
%UMCDAYSLEFT (ZarplataDay,ZarplataHour)

* UMX/UMC only *

Returns the number of days (and hours when specified), left until the salary payment day, and (or) the advance payment day (if the day of advance payment is specified).

Parameters AvansHour and ZarplataHour can be omitted.

* UMX/UMC only * возвращает количество дней (а если указаны часы, то и часов), оставшихся до зарплаты, и (или) до аванса (если указан день аванса). Параметры ZarplataHour и AvansHour можно не указывать

%UMCDAYPROGRESS (BeginHour,EndHour,Width, 'EmptyChar','FillChar','Prefix','Suffix')

Draws a progress bar showing the running of day. "BeginHour" - is
the beginning hour, "EndHour" - ending hour, "Width" - width, in
symbols, of progress bar, "EmptyChar" - is the symbol for filling of
empty part, "FillChar" - is the symbol for filled part, "Prefix" и
"Suffix" - strings placed at start and end of progress bar.
For ex., %UMCDAYPROGRESS(0,23,80,'-','X','0 [','] 23') can return this:
0 [XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-----] 23

визуально изображает, какая часть дня уже прошла. BeginHour - начальный час, EndHour - конечный час, Width - ширина, 'EmptyChar' - cимвол для заполнения непрошедшей части, 'FillChar' - символ для заполнения прошедшей части, Prefix и Suffix - то, что добавится в начало и в конец строки.
Например, %UMCDAYPROGRESS(0,23,80,'-','X','0 [','] 23') сейчас возвращает:
0 [XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-----] 23

%UMCSECSTOSTRRUS (UNIT,Sec)
или
%UMCSECSTOSTRRUS (UNIT,Sec,U)

* UMX/UMC only *

Cyrillic-specific

Converts a date expressed in seconds into a date expressed in other units or in words.

UNIT takes one of the following values: S – Seconds, M – minutes, H – hours, B – days, m, O or 1 – months, Y – years, T – time (чч:мм:сс), L – date (ДД/ММ/ГГ чч:мм:сс), 2 or s – time units abbreviations (1 мин 15 сек), 3 or l – time units in words.

The last parameter U adds a unit of measurements of time (3 мин), it can be omitted.

* UMX/UMC only * переводит число в секундах цифрами во время прописью либо цифрами.
UNIT принимает одно из следующих значений: S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы, T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс, 2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек), 3 или l - полностью прописью. Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо.

%UMCDAYSFROM (Day,Month,Year,UNIT,U)
или
 %UMCDAYSFROM (Day,Month,Year,UNIT)

Returns  the number of days since the date you specified.
UNIT can be one  of the following:
"S" - seconds, "M" - minutes, "H" - hours, "В" - days, "m", "O" or "1"
- months, "Y" - years, "T" - "hh:mm:ss", "L" - "DD/MM/YY hh:mm:ss",
"2" or "s" - short names of time units (1 min 15 sec).
The last optional parameter "U" adds  the time units when it is
necessary. (In order to use this parameter, just add a comma and the letter
"U" as the last parameter).

возвращает количество дней, прошедших с указанной даты. Год необходимо указывать полностью
UNIT принимает одно из следующих значений: S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы, T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс, 2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек), 3 или l - полностью прописью. Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо

%UMCDATESHIFT ("DateFormat",IncDays,
IncMonth,IncYear)

Returns  the date   at the specified format, which will  come after "IncDays"
days, "IncMonth" months and "IncYear" years after today.  For ex.,
at 05.04.04 (dd.mm.yy), %UMCDATESHIFT("dd/mm/yy",5,0,0) will return
"10/04/04", and %UMCDATESHIFT("dd.mm.yyyy",5) will return "10.04.2004"

возвращает дату в указанном формате, которая будет через IncDays дней, IncMonth месяцев и IncYear лет.
Например, если сегодня 05.04.04, то %UMCDATESHIFT("dd/mm/yy",5,0,0) вернёт "10/04/04", а %UMCDATESHIFT("dd.mm.yyyy",5) вернёт "10.04.2004"

%UMCHOURSFROM (Day,Month,Year,Hour,UNIT,U)
 или
 %UMCHOURSFROM (Day,Month,Year,Hour,UNIT)

Returns  the amount of hours since the date you specified.
UNIT can be one  of the following:
"S" - seconds, "M" - minutes, "H" - hours, "В" - days, "m", "O" or "1"
- months, "Y" - years, "T" - "hh:mm:ss", "L" - "DD/MM/YY hh:mm:ss",
"2" or "s" - short names of time units (1 min 15 sec).
The last optional parameter "U" adds  time units when it is
necessary. (In order to use this parameter, just add a comma and the letter
"U" as the last parameter).

возвращает количество часов, прошедших с указанного часа
UNIT принимает одно из следующих значений: S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы, T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс, 2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек), 3 или l - полностью прописью. Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо

%UMCMINSFROM (Day,Month,Year,Hour,Min,UNIT,U)
 или
 %UMCMINSFROM (Day,Month,Year,Hour,Min,UNIT)

Returns  the amount of minutes since the date you specified
UNIT can be one of  the following:
"S" - seconds, "M" - minutes, "H" - hours, "В" - days, "m", "O" or "1"
- months, "Y" - years, "T" - "hh:mm:ss", "L" - "DD/MM/YY hh:mm:ss",
"2" or "s" - short names of time units (1 min 15 sec).
The last optional parameter "U" adds  time units when it is
necessary. (In order to use this parameter, just add a comma and the letter
"U" as the last parameter).

возвращает количество минут, прошедших с указанного времени
UNIT принимает одно из следующих значений: S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы, T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс, 2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек), 3 или l - полностью прописью. Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо

%UMCTIMELEFT (StartHour,Startmin,EndHour, EndMin,UNIT,U)
или
 %UMCTIMELEFT (StartHour,Startmin, EndHour,EndMin,UNIT)

Cyrillic-specific

Returns the time left until the end of the working day. Returns “the day off” on Saturdays and Sundays.

UNIT takes one of the following values: S – Seconds, M – minutes, H – hours, B – days, m, O or 1 – months, Y – years, T – time (чч:мм:сс), L – date (ДД/ММ/ГГ чч:мм:сс), 2 or s – time units abbreviations (1 мин 15 сек), 3 or l – time units in words.

The last parameter U adds a unit of measurements of time (3 мин), it can be omitted.

возвращает время, оставшееся до конца рабочего дня, или сегодня выходной, если сейчас суббота или воскресенье.
UNIT принимает одно из следующих значений: S - Секунды, M - минуты, H - часы, В - дни, m, O или 1 - месяцы, Y - годы, T - формат чч:мм:сс, L - формат ДД/ММ/ГГ чч:мм:сс, 2 или s - формат с краткими наименованиями единиц времени (1 мин 15 сек), 3 или l - полностью прописью. Последний необязательный параметр U добавляет к времени (напр., 3) единицу измерения (3 мин), если это необходимо

%UMCWOY

Week of year (synonym for %UMCEV('$$weekofyear'))

неделя года (аналогично $UMCEV('$$weekofyear'))

%UMCDOY

Day of year (synonym for %UMCEV('$$dayofyear'))

день года (аналогично $UMCEV('$$dayofyear'))

%UMCHOM

Hour of month (synonym for %UMCEV('$$hourofmonth'))

час месяца (аналогично $UMCEV('$$hourofmonth'))

%UMCHOW

Hour of week (synonym for %UMCEV('$$hourofweek'))

час недели (аналогично $UMCEV('$$hourofweek'))

%UMCHOY

Hour of year (synonym for %UMCEV('$$hourofyear'))

час года (аналогично $UMCEV('$$hourofyear'))

%UMCCPUNAME

CPU name

имя процессора

%UMCCPUNAMEL

CPU name and short CPU information

имя процессора и краткая информация

%UMCCPUVENDOR

Name of CPU vendor

производитель процессора

%UMCCPUSPEED

Actual CPU frequency, in Mhz

вычисляет фактическую частоту процессора в мегагерцах

%UMCCPUTICKS

Returns  the number of operations your CPU has made since your system started, in billions

вычисляет, сколько млрд операций выполнил процессор с момента запуска системы

%UMCBIOSDATE

BIOS image date

дата создания образа биоса

%UMCBIOSNAME

BIOS name (not supported on some BIOSes)

название биоса (не поддерживается на некоторых биосах)

%UMCBIOSCOPY

BIOS copyrights (not supported on some BIOSes)

копирайты биоса (не поддерживается на некоторых биосах)

%UMCBIOSINFO

BIOS information (not supported on some BIOSes)

информация о биосе (не поддерживается на некоторых биосах)

%UMCMEMLOAD

Returns  the amount of memory load, in percents

возвращает использование памяти в процентах

%UMCMEMTVIRT

Total size of virtual memory of system

возвращает общий объём виртуальной памяти системы

%UMCMEMAVIRT

Available size of virtual memory of system

возвращает доступный объём виртуальной памяти системы

%UMCMEMTPAGE

Total size of swap memory of system

возвращает общий объём файла подкачки (своп-файла)

%UMCMEMAPAGE

Available size of swap memory of system

возвращает доступный объём объём файла подкачки (своп-файла)

%UMCMEMTPHYS

Total size of physical memory of system

возвращает общий объём физической памяти системы

%UMCMEMAPHYS

Available size of physical memory of system

возвращает доступный объём физической памяти системы

%UMCIP

* UMX only * Returns  the computer IP-address

* UMX only * возвращает IP-адрес компьютера

%UMCGETIP("Name")

Returns  the  IP-address of host you're specified

возвращает IP-адрес указанного хоста

%UMCDIALUPNAME

Returns  the name of Dial-Up connection established

возвращает имя установленного соединения Dial-Up

%UMCCOMPNAME

Name of local computer

возвращает имя локального компьютера

%UMCUSERNAME

Name of user logged in

возвращает имя пользователя, под которым осуществлён вход в систему

%UMCSCREENRES

* UMX/UMC only * Current screen resolution, in pixels

* UMX/UMC only * возвращает текущее разрешение экрана

%UMCSCREENDEPTH

* UMX/UMC only * Current screen depth, in bits

* UMX/UMC only * возвращает глубину цвета

%UMCSCREENRRATE

* UMX/UMC only * Current refresh rate of screen (only for NT-based systems).

* UMX/UMC only * возвращает частоту развёртки в герцах (только для NT-based)

%UMCBATT

If you're using a notebook or a UPS, this macro returns  the state of batteries

возвращает состояние батарей

%UMCBATTSECLEFT

Returns the amount time, in seconds, your batteries can work

возвращающий число секунд, оставшееся по расчётам для работы аккумуляторов

%UMCPRN

Name of default printer

имя принтера по умолчанию

%UMCSTARTUPINFO

Boot mode (normal/safe mode)

статус загрузки (обычная/защита от сбоев).

%UMCMOUSEINFO

Number of buttons of mouse

информация о количестве кнопок и колёсика у мыши

%UMCMOUSEPOS

Screen coordinates of mouse cursor

координаты курсора мыши

%UMCKBD

Number of keyboard layout

номер раскладки клавиатуры

%UMCPROCLIST

List of running processes

список запущенных процессов

%UMCTASKLIST

List of running tasks

список запущенных задач

%UMCWINVER

The  version of Windows,  type(Server, Professional etc) (for NT-based), and the  servicepack (if installed)

полная версия виндовса, тип (Server, Professional и т. п.) (для NT-based), сервиспак (если установлен).

%MBMSENSORNAME
(SensorNo, SensorType, Kind)

Returns  the name of sensor of MBM (MotherBoard Monitor system monitoring program)

получить название указанного датчика из MBM

%MBMSENSORVAL (SensorNo,SensorType, Kind)

Returns  the value of sensor specified
SensorNo can be from 1 to 10
SensorType can be one of the following: T - temperatures, F - coolers, V - voltages, C - cooler sensors
Kind can be L - lowest value, H - highest value, if omitted - returns the current value
You can download MotherBoard Monitor for free from http://mbm.livewiredev.com/

получить значение указанного датчика.
SensorNo может принимать значения от 1 до 10.
SensorType: T - температурные датчики, F - кулеры, V - напряжения, С - датчики частоты процессора.
Kind: L - наименьшее значение, H - наибольшее, без указания - текущее значение
MotherBoard Monitor можно бесплатно скачать с http://mbm.livewiredev.com/

%UMCLOCALIP(AdapterNo) and %UMCLOCALIPLIST(DelimID)

* UMX only * Returns  the  IP addresses of network adapters installed
AdapterNo -  the number of a network adapter (starting from 0)
DelimID - delimiter (S - space, L -line feed, C - comma, by default - L).

* UMX only * возвращают IP-адреса установленных сетевых адаптеров.
AdapterNo - это порядковый номер сетевого адаптера (начиная с 0)
DelimID - разделитель (S - пробел, L -перевод строки, C - запятая, по умолчанию - L).

Macro / Макрос

Description

Описание

%UMCFVER("FilePath")

Returns  the version of executable file you specified (*.exe, *.dll)

Возвращает версию указанного исполнимого файла (*.exe, *.dll)

%UMCDRVFREE(UNIT,Drive)

Returns  the amount of free space on the disk "Drive",  units are specified by parameter "UNIT": B-bytes, K-kilobytes, M-megabytes, G-gigabytes, T-terabytes, P-percents

Возвращает свободное место на диске Drive в единицах, задаваемых UNIT: B-байты, K-килобайты, M-мегабайты, G-гигабайты, T-терабайты, P-проценты

%UMCDRVSIZE(UNIT,Drive)

Returns  the size of the disk "Drive",  units are specified by parameter "UNIT": B-bytes, K-kilobytes, M-megabytes, G-gigabytes, T-terabytes

Возвращает объём диска Drive в единицах, задаваемых UNIT:
B-байты, K-килобайты, M-мегабайты, G-гигабайты, T-терабайты

%UMCDRVLIST

Lists your local disk drives

Список локальных дисков

%UMCVOLNAME("Char","Label")

Returns  the label of disk drive specified. If the label is empty (or  the drive is missing ), macro will return the string "label". You can omit last parameter

Возвращает метку диска. Если метка пустая (или диск отсутствует), возвращает строку label. Параметр "label" необязателен

%UMCVOLSNUM("Char")

Returns  the serial number of disk specified

Возвращает серийный номер диска

%UMCVOLFS("Char")

Returns  the type of filesystem of disk "Char"

Возвращает тип файловой системы диска

%UMCFILESCOUNT ("Directory","Mask")

Returns the number  of files matching the mask you have specified. If the parameter "Mask" is omitted, "*.*" is used as default

Возвращает количество файлов, соответствующих маске, в указанной папке. По умолчанию (если не указана) маска полагается "*.*"

%UMCFILESSIZE (UNIT,"Directory","Mask")

Returns  the total size of files matching wildcard "Mask". "UNIT" specifies units: B-bytes, K-kilobytes, M-megabytes, G-gigabytes, T-terabytes

Ищет все файлы в папке по маске. UNIT задаёт единицы измерения: B-байты, K-килобайты, M-мегабайты, G-гигабайты, T-терабайты

%UMCFILESLIST

Returns the list of files matching wildcard you have specified.

Возвращает список файлов из указанной папки. Параметры абсолютно аналогичны %UMCFILESCOUNT и %UMCFILESSIZE

%UMCREGREAD ("KeyPath","KeyName",HKEY_ID)

Reads data from system registry.
"KeyPath"  is
the system registry path for specific key (for ex., "\Software\UMC"),
"KeyName"  is the name of key (for ex., "UseLogging"), HKEY_ID  is an
optional parameter setting the  root key:
'C': HKEY_CURRENT_USER
'R': HKEY_CLASSES_ROOT
'M': HKEY_LOCAL_MACHINE
'U': HKEY_USERS
'N': HKEY_CURRENT_CONFIG
'P': HKEY_PERFORMANCE_DATA
'D': HKEY_DYN_DATA
By default (if omitted), "C".

Чтение данных из реестра.
KeyPath - это путь к ключу в реестре (например, "\Software\UMC") KeyName - это имя ключа (например, "UseLogging")
HKEY_ID - необязательный параметр, задающий корневой ключ:
'C': HKEY_CURRENT_USER
'R': HKEY_CLASSES_ROOT
'M': HKEY_LOCAL_MACHINE
'U': HKEY_USERS
'N': HKEY_CURRENT_CONFIG
'P': HKEY_PERFORMANCE_DATA
'D': HKEY_DYN_DATA
По умолчанию полагается равным "C".

%UMCGP(ID)

Returns the full path for system folders. ID can be one of the following:
COMMON - Common Files Folder
CUR - Current Folder
PROGRAM - Program Files Folder
WINDOWS - Windows Folder
SYSTEM - System Path
TEMP - TEMP Path
DESKTOP - Desktop Folder
PROGRAMS - Programs Folder
PERS - Personal Folder
FAV - Favorites Folder
STARTUP - Startup Folder
RECENT - Recent Folder
SENDTO - SendTo Folder
STARTMENU - Startmenu Folder
DESKTOPDIR - Desktop Directory Folder
NETHOOD - Nethood Folder
FONTS - Fonts Folder
CSTARTMENU - Common Startmenu Folder
CPROGRAMS - Common Programs Folder
CSTARTUP - Common Startup Folder
CDESKTOP - Common Desktop Directory Folder
CAPPDATA - Common Appdata Folder
APPDATA - Appdata Folder
PRINTHOOD - Printhood Folder
CFAV - Common Favorites Folder
TEMPLATES - Templates Folder
ICACHE - InternetCache Folder
COOKIES - Cookies Folder
HISTORY - History Folder

Возвращает полный путь к системной папке. ID принимает одно из следующих значений:
COMMON - Common Files Folder - папка для общих программных файлов.
CUR - текущая папка.
PROGRAM - Program Files Folder - папка Program Files.
WINDOWS - Windows Folder - папка, куда установлена Windows.
SYSTEM - System Path - как правило, \Windows\System32.
TEMP - TEMP Path - каталог для временных файлов.
DESKTOP - Desktop Folder - каталог Рабочего Стола.
PROGRAMS - Programs Folder - папка "Программы".
PERS - Personal Folder - папка "Мои документы".
FAV - Favorites Folder - папка "Избранное".
STARTUP - Startup Folder - папка "Автозагрузка".
RECENT - Recent Folder - папка "Последние документы".
SENDTO - SendTo Folder - папка "Послать в..." :))))
STARTMENU - Startmenu Folder - Главное меню.
DESKTOPDIR - Desktop Directory Folder
NETHOOD - Nethood Folder - папка Сетевое окружение.
FONTS - Fonts Folder - папка шрифтов.
CSTARTMENU - Common Startmenu Folder - общее Главное меню.
CPROGRAMS - Common Programs Folder
CSTARTUP - Common Startup Folder - общее меню автозагрузки.
CDESKTOP - Common Desktop Directory Folder - общий рабочий стол.
CAPPDATA - Common Appdata Folder - общие данные программ.
APPDATA - Appdata Folder - данные программ текущего пользователя.
PRINTHOOD - Printhood Folder - Принтеры.
CFAV - Common Favorites Folder - Общий каталог "Избранное".
TEMPLATES - Templates Folder - Шаблоны.
ICACHE - InternetCache Folder - Временные файлы интернет.
COOKIES - Cookies Folder - кукисы :)
HISTORY - History Folder - хистори.

Macro / Макрос

Description

Описание

%UMCSETINIINT ("Filename","Section",
Parameter","Value")

%UMCSETINIINT("Filename","Section","Parameter","Value") -
sets value of integer parameter in the specified section of INI-file.
For ex., %UMCSETINIINT("c:\abc.ini","A","B","7") will set following
parameter:
------------ begin --------------
[A]
B=7
------------- end ---------------
Located in c:\abc.ini

устанавливает значение указанного целочисленного параметра в указанной секции .ini-файла

%UMCGETINIINT ("Filename","Section","Parameter")

gets the value of integer parameter in the specified section of INI-file

читает значение указанного целочисленного параметра в указанной секции .ini-файла

%UMCINCINIINT ("Filename","Section","Parameter")

increments by 1 the value of integer parameter in the specified section of INI-file

увеличивает на 1 значение указанного целочисленного параметра в указанной секции .ini-файла

%UMCSETINISTR ("Filename","Section",
"Parameter","Value")

sets the value of string parameter in the specified section of INI-file

устанавливает значение указанного строкового параметра в указанной секции .ini-файла

%UMCGETINISTR ("Filename","Section",
"Parameter")

gets the value of string parameter in the specified section of INI-file

читает значение указанного строкового параметра в указанной секции .ini-файла

%UMCPUTUUE("File")

* UMX only * puts UUE-encoded file into the body of a letter. This file is  not detected by The Bat! as  an attachment so you can use this macro for uploading files via mail2ftp services like mail2ftp@rootshell.be

* UMX only * вставка UUE-кодированного файла в сообщение. Файл помещается таким образом, чтобы мог быть воспринят mail2ftp-сервисами. То есть, он не распознаётся The Bat! в качестве вложенного файла, а в заголовки и тело письма не добавляется "левая" информация

%UMCSPLIT("Text",
"TOaddr",PartSize)

* UMX only * splits a text into  parts, each part  takes "PartSize" bytes. The first part  replaces the current text, other parts  are automatically put into the outbox folder of default
account. Sender address  is set  at the "ToAddr" field. This macro is  designed for those who like  forwarding e-mails to their mobile phones

* UMX only * разбивает текст на части размером по PartSize байт. Первая часть заменяет текст текущего письма, остальные автоматически помещаются в папку "исходящие" ящика по умолчанию. Адресат письма устанавливается полем "ToAddr". Этот макрос сделан для любителей пересылать почту на мобильники и пейджеры

%UMCRND(WIDTH,BASE)

returns a random number with length of "WIDTH" symbols. You can use non-decimal-base systems by specifying parameter "BASE". (If omitted, BASE is  "10" by default). For ex., %UMCRND(5) will return a random number in 00000..99999, %UMCRND(3,16) - in 000..FFF

возвращает случайное число длины WIDTH по основанию BASE. Параметр BASE по умолчанию полагается равным 10 (десятичная система счисления).
Например, %UMCRND(5) вернёт случайное число от 00000 до 99999, %UMCRND(3,16) вернёт случайное число от 000 до FFF

%UMCCASE ("Expression","String1","String2",...)

* UMX only * by depending of value of "Expression" (treated as number), will return "String1" (if integer part of value of "Expression" is 1), "String2" etc

* UMX only * В зависимости от значения "Expression" возвращает "String1" (если целая часть значения Expression равна 1), "String2" И т. д.

%UMCIF ("Condition","IfTrue","IfFalse")

* UMX only * calculates value of "Condition" and returns "IfTrue", if condition is nonzero, "IfFalse" otherwise.

* UMX only * вычисляет значение выряжения "Condition" и возвращает строку "IfTrue", если выражение истинно (не равно 0) и "IfFalse", если ложно

%UMCGETSTR(Str,"filename")

reads text file "filename", searches
there for the strings beginning with "Str", and returns part of string
found after first space. If string was not found, returns none.
%UMCGETSTR("bla","c:\1.txt") will return "blaah", if
c:\1.txt contains the following text:
la lalal
bla blaah
zla asd asdd

читает текстовой файл "filename", ищет в нём строки, в начале которых есть Str, и возвращает в этом случае часть строки, идущую после первого пробела. Если строка не найдена, возвращает пустое значение.
Например, %UMCGETSTR("bla","c:\1.txt") вернёт значение "blaah", если
c:\1.txt имеет следующее содержание:
la lalal
bla blaah
zla asd asdd

%UMCVAR(VARNAME)

* UMX only * Returns the value of the  specified variable

* UMX only * возвращает значение указанной переменной

%UMCSET(VARNAME,"Value")

* UMX only * Creates a variable with the specified value

* UMX only * создаёт переменную VARNAME со значением "Value"

%UMCINC(VARNAME,VAL)

* UMX only * Increments the value of VARNAME by VALUE

* UMX only * увеличивает значение переменной VARNAME на VAL (по умолчанию VAL полагается равным единице).

%UMCEVAL("Expr")

* UMX only * Obsolete, used for backward compatibility

* UMX only * Устарел, оставлен для совместимости

%UMCEV("Expr")

* UMX only * Replaces all variable names with  their values

* UMX only * заменяет в строке имена переменных на их значения

%UMCFOR (VARNAME,i1,i2,"Expr",DEL)

* UMX only * Calculates the value of  expression "Expr" in the loop where variable VARNAME takes values from i1 to i2 (integers).
You can specify the parameter DEL to determine how to delimit results. DEL can be on of these: S - space, L - line feed, C - comma. By default (if omitted) - no delimiter.

* UMX only *  вычисляет "Expr" в цикле при переменной VARNAME, меняющей значения от i1 до i2 (целые). DEL - использовать ли символ-разделитель итераций. DEL может принимать значения S - пробел, L - перевод строки, C - запятая, по умолчанию - символ отсутствует.

%NP

Returns the  name of the song currently  playing.
 Supported players: WinAMP, foobar, apollo, STP, Quintessential, 1by1, LightAlloy, Zoom Player

Возвращает наименование воспроизводимой композиции. Поддерживаются следующие плейеры: WinAMP, foobar, apollo, STP, Quintessential, 1by1, LightAlloy, Zoom Player

%NPIF ("IfPlaying","IfNotPlaying")

Returns the first parameter if any of players listed above is active, and the second one otherwise.

Возвращает первый параметр, если воспроизводится какая-либо композиция, или второй, если нет.

%NPP

Returns  the name of  currently active player.

Возвращает название активного плейера

%NPTOP (Number,Template,Delimiter)

* UMX only * Returns  the top 10 most frequently listened songs.
Number -  the length  of the list,
Template - specifies template (you can use  following variables: $$entry - name of song found, $$num - ordinal number of song in the list, $$cnt - total times this song was registered in statistics. Ex. template is "Song no. $$num: $$entry, ($$cnt times)")
Delimiter - delimiter, use "$$nl" to line feed
By default (if omitted), Number=10, Template = "$$num. $$enry", Delimiter = "$$nl"

* UMX only * Выводит первые 10 самых часто слушаемых композиций (можно задать параметром число от 1 до 50).
Number - число элементов хит-парада
Template - шаблон (можно использовать переменные $$entry, $$num, $$cnt - типа "Песня номер $$num: $$entry, $$cnt раз прослушана")
Delimiter - Разделитель, для перевода строк - "$$nl"
По умолчанию Number=10, Template = "$$num. $$enry", Delimiter = "$$nl"

%UMCATTCOUNT

* UMX only *

* UMX only *

%UMCGETSMS

* UMX only *

* UMX only *

%UMCENCRYPT

* UMX/UMC only *

* UMX/UMC only *

%UMCDECRYPT

* UMX/UMC only *

* UMX/UMC only *

Macro / Макрос

Description

Описание

%FNxxxxxx

* UMX only * These macros  refer to corresponding scripts.
For example, to call the script  MYSCRIPT, you can use %FNMYSCRIPT

* UMX only * Эти макросы ссылаются на соответствующие скрипты. Например, чтобы вызвать скрипт MYSCRIPT, можно использовать %FNMYSCRIPT

$$datetime

date and time

дата и время

$$date

date

дата

$$time

time

время

$$year

year

год

$$month

month

месяц

$$day

day

день месяца

$$hour

hour

час

$$min

minute

минута

$$sec

second

секунда

$$weekofyear

week of year

неделя в году

$$dayofweek

day of week

день недели (число)

$$dayofyear

day of year

день года

$$hourofday

hour of day

час года

$$hourofmonth

hour of month

час месяца

$$hourofweek

hour of week

час недели

$$hourofyear

hour of year

час года

$$ver

version of UMC

версия UMC

$$umcdir

directory where UMC has been installed

папка, куда установлен UMC

$$tbdir

directory where The Bat! has been installed

папка, куда установлен TheBat

$$np

'now playing' string

Название воспроизводимой в данный момент композиции

$$npp

Name of currently active player

Название плейера, активного в данный момент

Description

Описание

General

Общее

Script is  a user-defined macro. Scripting language is the way to describe these macros.
UMC Scripting language is the subset of Delphi Pascal syntax implemented with the JVCL library.

Скрипт - это описание макроса в текстовом виде.
Скриптовый язык UMC - это подмножество языка Delphi Pascal, реализованное при помощи библиотеки JVCL.

Script definition file

Файл описания скрипта

UMC scripts descriptions are  given in files with extension *.s, located in the /Scripts directory.
One script definition file can contain one or more scripts.

Файл описания скриптов UMC - это текстовый файл с расширением *.s
Файл описания скриптов содержит один или более скриптов. Файлы описаний скриптов находятся в директории /Scripts в папке, куда был установлен UMC.

Script definition: basics

Описание скриптов: основы

Script definition is beginning with the metasymbol @SCRIPT

For example, @SCRIPT TEST defines script named "TEST".
After @SCRIPT,  the script body follows. Script can be a simple math expression (like TEST1) or a Pascal-like function definition without function header (like TEST2)

@SCRIPT TEST1
//Our first script
'Hello Word! Time is '+datetimetostr(now);

@SCRIPT TEST2
//Our second script
var time:TDateTime;
begin
     time:=now;
     Result:='Hello Word! Time is '+datetimetostr(time);
end;

Описание скрипта начинается с ключевого метасимвола @SCRIPT.:

@SCRIPT TEST
Этот метасимвол описывает скрипт под названием TEST. Старайтесь не использовать дублирующихся имён скриптов, чтобы избежать
недоразумений.
После метасимвола @SCRIPT идёт сам скрипт. Скрипт является либо
простым арифметическим выражением, либо описанием функции используя синтаксис языка Pascal без строки function:

@SCRIPT TEST1
//Первый скрипт
'Hello Word! Time is '+datetimetostr(now);

@SCRIPT TEST2
//Второй скрипт
var time:TDateTime;
begin
     time:=now;
     Result:='Hello Word! Time is '+datetimetostr(time);
end;

How to call script from template

Как вызвать скрипт из шаблона

To call your macro from a template, you must use a special autogenerated macro %FNxxxxxxx.
For example, to call script TEST2 you must add %FNTEST2 to your template.

Чтобы вызвать скрипт из шаблона, необходимо использовать специальный автосгенерированный макрос %FNxxxxxxx, например, чтобы вызвать скрипт TEST2, надо использовать %FNTEST2

You can use some standard procedures, functions and types exported from Delphi units: System, SysUtils, Windows

В данный момент можно использовать некоторые стандартные процедуры, функции и типы из модулей Delphi: System, SysUtils, Windows

How to use internal UMC variables

Как использовать переменные UMC

To use internal UMC variables, you must  add the prefix umc_ before name of variable like this:
@SCRIPT TEST3
'UMC version is '+umc_ver

Чтобы использовать внутренние переменные UMC, необходимо обращаться к ним с префиксом umc_ :
@SCRIPT TEST3
'UMC version is '+umc_ver

Control statements

Управляющие конструкции

You can use these control statements: for..to, while..do, repeat..until, if...then...else, case...of...end and some similar
@SCRIPT TEST4
var i:integer;
begin
     result:='';
     for i:=32 to 255 do
         result:=result+chr(i);
end;
@SCRIPT TEST5
var i:integer;
begin
     result:='';
     i:=32;
     while i<=255 do begin
         if (i<45)or(i>53) then
         result:=result+chr(i);
         i:=i+1;
     end;
end;

Вы можете использовать управляющие конструкции:
@SCRIPT TEST4
var i:integer;
begin
     result:='';
     for i:=32 to 255 do
         result:=result+chr(i);
end;
@SCRIPT TEST5
var i:integer;
begin
     result:='';
     i:=32;
     while i<=255 do begin
         if (i<45)or(i>53) then
         result:=result+chr(i);
         i:=i+1;
     end;
end;

Passing parameters to script

Передача параметров скрипту

 To access the macro parameters , you  should use ParamCount and ParamStr functions (similar to the same Pascal functions)
@SCRIPT PARAMETERCOUNT
'Parameter count: '+inttostr(ParamCount)
@SCRIPT PARAMETERLIST
var i:integer;
begin
result:='';
for i:=1 to paramcount do result:=nl+inttostr(i)+'. '+paramstr(i);
end;

Для доступа к параметрам макроса следует использовать функции ParamCount и ParamStr, смысл которых совпадает с аналогичными функциями паскаля.
@SCRIPT PARAMETERCOUNT
'Число параметров: '+inttostr(ParamCount)
@SCRIPT PARAMETERLIST
var i:integer;
begin
result:='';
for i:=1 to paramcount do result:=nl+inttostr(i)+'. '+paramstr(i);
end;

Name

Result type

Description in English

Randomize

n/a

Initializes random number generator

Random

Ord

Chr

Abs

Length

Copy

Round

Trunc

Pos

Delete

Insert

Sqr (X:Real)

Real

These functions return values of corresponding math functions, e. g. sin(0.5) will return  a value of sine of 0.5

Sqrt (X:Real)

Real

Exp (X:Real)

Real

Ln (X:Real)

Real

Sin (X:Real)

Real

Cos (X:Real)

Real

Tan (X:Real)

Real

ArcTan (X:Real)

Real

UpperCase (S: String)

String

 Converts string to  the upper case

LowerCase (S: String)

String

Converts  string to  the lower case

CompareStr

CompareMem

CompareText

AnsiUpperCase

Trim

TrimLeft

TrimRight

QuotedStr

IntToStr

IntToHex

StrToInt

FileOpen

FileCreate

FileRead

FileWrite

FileSeek

FileClose

FileAge

FileExists

FindFirst

FindNext

FindClose

FileGetDate

FileSetDate

DeleteFile

RenameFile

ChangeFileExt

ExtractFilePath

ExtractFileDir

ExtractFileDrive

ExtractFileName

ExtractFileExt

DiskFree

DiskSize

Now

DateTimeToStr

DayOfWeek

.... and more, more, more, ....

Trouble description

Описание проблемы

Solution

Решение

When I add UMC in the plugins dialog in The Bat!, nothing happens. UMC  does not appear in the list of installed macros  or The Bat! crashes/hangs.

Когда я добавляю UMC в диалоге настройки плагинов, ничего не происходит. UMC не появляется в списке установленных макросов или The Bat! виснет или вываливается.

Please  find the file “umcstartup.log”  located in your system TEMP directory (usually, c:\windows\temp) and send it to me here. Then try to add to system registry file defaults.reg  included into UMC installation package. In most cases, it will fix your problem. Also, if you are an experienced  The Bat! user, you can add UMC  in the TBplugins.ini file manually.

Пожалуйста, найдите файл umcstartup.log в системной директории временных фалов (обычно это c:\winows\temp) а отошлите этот файл мне сюда. Задем попробуйте импортировать в реестр файл defaults.reg, содержащийся в  поставке UMC. В большинстве случаем, это решит вашу проблему. Также, вы можете попробовать добавить плагин в файл tbplugins.ini вручную.