Обновлено:

06.12.2025

XLL

Библиотека (надстройка) XLL для Excel

XLL-надстройка представляет собой скомпилированный на C/C++ файл динамической библиотеки Windows, специально предназначенной для использования в Excel.

Область применения - Excel 2007 (х32, х64) и выше (для Excel x32 - версия библиотеки (х32), для Excel х64 - версия (х64)). Не поддерживается WinXP.

Начиная с версии BedvitXLL 5.0, поддерживается Windows8 и выше, т.е. не поддерживается Windows7, но периодически выходит спец. выпуск BedvitXLLwin7

Содержит библиотеку BedvitCOM (выгружается в ту же папку, что и надстройка). Опционально. Можно отключить при первом запуске или в дальнейшем.
НЕ нужно устанавливать или удалять в системе, это один файл (+файл сохранений BedvitXLL.bin, создается в той же папке, что и надстройка).
НЕ нужен .NET Framework, НE нужны какие либо другие библиотеки, НЕ нужна регистрация или активация, НЕ нужно подключение к Интернет.
Имеет свое API для возможности использования функционала надстройки в других инструментах/языках/скриптах.
Запускается под правами пользователя, права администратора не нужны.

Устанавливается так же, как и "обычная" надстройка Excel (xla, xlam) в папку надстроек или просто открывается как файл.

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

XLL ▶ Functions

Функции листа Excel

Высокопроизводительные функции рабочих листов Excel, написанные на С/С++ и экспортируемые из XLL. Во многом аналогичные стандартным функциям Excel.

Функции листа Excel, категория: XLLBignumArithmeticFloat

Арифметика для длинных чисел с плавающей точкой.

XLL ▶ Functions ▶ SumFloat

dll v5.0

SumFloat

Сумма обычных/длинных чисел.

LPXLOPER12 SumFloat(LPXLOPER12 xlop1, XCHAR * xstr1, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка) или диапазон таких чисел.
xstr1 - число обычное, длинное  (строка)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробной виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ SubtractFloat

dll v5.0

SubtractFloat

Разница обычных/длинных чисел.

LPXLOPER12 SubtractFloat(LPXLOPER12 xlop1, XCHAR * xstr1, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка)
xstr1 - число обычное, длинное  (строка)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробной виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ MultiplyFloat

dll v5.0

MultiplyFloat

Произведение обычных/длинных чисел.

LPXLOPER12 MultiplyFloat(LPXLOPER12 xlop1, XCHAR * xstr1, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка) или диапазон таких чисел.
xstr1 - число обычное, длинное  (строка)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробной виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ DivideFloat

dll v5.0

DivideFloat

Деление обычных/длинных чисел.

LPXLOPER12 DivideFloat(LPXLOPER12 xlop1, XCHAR * xstr1, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка)
xstr1 - число обычное, длинное  (строка)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробной виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ PowerFloat

dll v5.0

PowerFloat

Возведение в степень обычных/длинных чисел.

LPXLOPER12 PowerFloat(LPXLOPER12 xlop1, int exponent, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка)
exponent - экспонента (показатель степени)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробной виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ RootFloat

dll v5.0

RootFloat

Квадратный корень из обычных/длинных чисел.

LPXLOPER12 RootFloat(LPXLOPER12 xlop1, int precisionOut, XCHAR * separatorIn, XCHAR * separatorOut, int bignumBaseIn, int bignumBaseOut, int eNotationOFF)
Параметры функции:
xlop1 - число обычное, длинное (строка)
precisionOut - точность длинного числа, количество значимых символов в мантиссе числа (по умолчанию 32 тыс. знаков в E-нотации, что бы поместилось в ячейку Excel или меньше, в случае вывода в виде дробной нотации, за счет нулей)
separatorIn - разделитель целой и дробной части входящего числа (по умолчанию берется из Excel)
separatorOut - разделитель целой и дробной части возвращаемого/расчетного числа (по умолчанию берется из Excel)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).
eNotationOFF - отключение E-нотации. В таком случае выводится в дробном виде для выбранной базы счисления.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

Функции листа Excel, категория: XLLBignumArithmeticInteger 

Арифметика для длинных целых чисел.

XLL ▶ Functions ▶ SumInteger

dll v5.0

SumInteger

Сумма обычных/длинных чисел.

LPXLOPER12 SumInteger(LPXLOPER12 xlop1, XCHAR * xstr1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка) или диапазон таких чисел.
xstr1 - число обычное, длинное  (строка)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ SubtractInteger

dll v5.0

SubtractInteger

Разница обычных/длинных чисел.

LPXLOPER12 SubtractInteger(LPXLOPER12 xlop1, XCHAR * xstr1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка)
xstr1 - число обычное, длинное  (строка)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ MultiplyInteger

dll v5.0

MultiplyInteger

Произведение обычных/длинных чисел.

LPXLOPER12 MultiplyInteger(LPXLOPER12 xlop1, XCHAR * xstr1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка) или диапазон таких чисел.
xstr1 - число обычное, длинное  (строка)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ DivideInteger

dll v5.0

DivideInteger

Деление обычных/длинных чисел.

LPXLOPER12 DivideInteger(LPXLOPER12 xlop1, XCHAR * xstr1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка)
xstr1 - число обычное, длинное  (строка)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ PowerInteger

dll v5.0

PowerInteger

Возведение в степень обычных/длинных чисел.

LPXLOPER12 PowerInteger(LPXLOPER12 xlop1, int exponent, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка)
exponent - экспонента (показатель степени)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ ModInteger

dll v5.0

ModInteger

Деление обычных/длинных чисел и возврат остатка (делит два числа и возвращает только оставшуюся часть).

LPXLOPER12 ModInteger(LPXLOPER12 xlop1, XCHAR * xstr1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка)
xstr1 - число обычное, длинное  (строка)
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ FactorialInteger

dll v5.0

FactorialInteger

Факториал натурального числа n.

LPXLOPER12 FactorialInteger(int n, int bignumBaseOut)
Параметры функции:
n - натуральное число
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

XLL ▶ Functions ▶ ConvertBaseInteger

dll v5.0

ConvertBaseInteger

Конвертация обычного/длинного числа из одной базы счисления в другую.

LPXLOPER12 ConvertBaseInteger(LPXLOPER12 xlop1, int bignumBaseIn, int bignumBaseOut)
Параметры функции:
xlop1 - число обычное, длинное (строка) входящее
bignumBaseIn - база счисления входящего числа 2-62 (по умолчанию, если не указана = 10).
bignumBaseOut - база счисления возвращаемого/расчетного числа 2-62 (по умолчанию, если не указана = 10).

Возвращает строку (длинное число) если команда выполнена успешно и #NUM!(#ЧИСЛО!) если ошибка.

Функции листа Excel, категория: XLL

Функции XLL не вошедшие в другие категории.

XLL ▶ Functions ▶ FilterUnicodeChar

dll v5.0

FilterUnicodeChar

Получить/удалить любые символы Unicode из строки (отфильтровать).

LPXLOPER12 FilterUnicodeChar(XCHAR * StringIn, XCHAR * EnableChar, XCHAR * DisableChar)
Параметры функции:
1. StringIn - входящая строка
2. EnableChar - символы включаемые в итоговую строку (через "-" указывается диапазон, сам "-" выводится/удаляется если его поставить первым символом или последним в шаблоне)
3. DisableChar - символы исключаемые из итоговой строки (через "-" указывается диапазон).

Последние два параметра - не обязательные. Можно задавать любой из них, можно все два, можно никакой - тогда выводится первоначальная строка.

Возвращает строку с отфильтрованными символами Юникода.

XLL ▶ Functions ▶ QRcodePrint

dll v5.0

QRcodePrint

Печатает QR-код в ячейке листа Excel (см. https://bedvit.ru/xll/qr/).

Использованы: libqrencode + Windows GDI

LPXLOPER12 QRcodePrint(wchar_t *  QRcodeText, LPXLOPER12 sizePixel, LPXLOPER12 pixelColorR, LPXLOPER12 pixelColorG, LPXLOPER12 pixelColorB, LPXLOPER12 versionSymbol, LPXLOPER12 levelErrCorrect, LPXLOPER12 widthImage, LPXLOPER12 heightImage, LPXLOPER12 quietZone, LPXLOPER12 left, LPXLOPER12 top)
Параметры/Аргументы функции QRcodePrint :
1. QRcodeText - что печатаем, строка(обязательное).
2. SizePixel - размер пикселя (не картинки, а квадратика в QR), по умолчанию 4 (минимально рекомендуемый)
3. PixelColorR =0 цвет RGB (0-255) если хотим цветную картинку (по умолчанию черный)
4. PixelColorG = 0
5. PixelColorB =0
6. VersionSymbol - версия QR кода (1-40) (по умолчанию = 0-выбор автоматом), см. ниже
7. LevelErrCorrect - уровень коррекции ошибок (0-3, по умолчанию = 1 ~15%), см. ниже
8.WidthImage - постоянная ширина (т.к. при кодировании разного размера данных размер QR меняется). Если хотим постоянный размер - проставляем. По умолчанию "-1" (размер фактический)
9.HeightImage - постоянная высота, тоже, что и п.8
10. QuietZone - Размер в модулях зоны тишины (>=0, по умолчанию = 4). Quiet zone — это область, отделяющая границу штрих-кода от фона и других изображений. Начиная с версии xll - v2.0.1.6
11.Left - отступ от левого верхнего угла ячейки с функцией (рекомендуется оставлять значение по умолчанию = 0)
12.Top - тоже, что и п.11 (рекомендуется оставлять значение по умолчанию = 0)
п.11,12 рекомендовано использовать, только тогда, когда есть понимание, как это все работает (см. ниже). В обратном случае может быть ситуация, когда изменили размер ячейки или изменили 11 и/или 12 параметр, и теперь QR - печатается в другой ячейке, а в предыдущей он уже не удалится, останется до ручного удаления.

Важно: Ячейка в которую помещается QR-код предварительно очищается от старых версий QR.
Если QR-код больше не нужен можно удалить вручную или задать пустую строку для первого параметра функции (старый QR-код удалится, новый не создастся). Важно! QR-код при этом должен находится (его левый верхний угол) в рамках ячейки, в которой находится функция QRcodePrint(), в противном случай картинка не удалится.

Результат: при удаче, возвращается закодированная в QR-коде строка, при ошибке - "#ЧИСЛО!"

XLL ▶ Functions ▶ TextJoinXLL

dll v5.0

TextJoinXLL

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

LPXLOPER12 TextJoinXLL(LPXLOPER12 range, LPXLOPER12 delimiter, BOOL ignoreEmpty)
Параметры функции:
1.range - массив/диапазон строк
2.delimiter - строка-разделитель (опционально = "")
3.ignoreEmpty - игнорировать пустые ячейки в Range (опционально = 0 - не игнорировать)

Аналог TextJoin(ОБЪЕДИНИТЬ) от Microsoft (https://support.microsoft.com/en-gb/office/textjoin-function-357b449a-ec91-49d0-80c3-0e8fc845691c)
Если объединенная строка содержит свыше 32767 символов (ограничение для ячейки), функция вернет ошибку #ЧИСЛО!.

Возвращает строку.

XLL ▶ Functions ▶ HelpXLL

dll v5.0

HelpXLL

Возвращает строку, содержащую все основные данные работы надстройки, аналогичные данным в команде меню "XLL Help".

LPXLOPER12 HelpXLL()
Параметры функции:
1.Без параметров

Возвращает строку, содержащую все основные данные по работе надстройки, аналогичные данным в команде меню "XLL Help"

XLL ▶ Functions ▶ CoCreateGuidXLL

dll v5.1

CoCreateGuidXLL

Создает GUID — уникальное 128-битное целое число, используемое для CLSID и идентификаторов интерфейса.

LPXLOPER12 CoCreateGuidXLL(int liteMode)
Параметры функции:
1. liteMode - режимы вывода: 0 - стандартный "{E06AD101-5907-474B-8506-A7CD0149537F}", 1 - упрощенный  "c883f002273a4c63ae52f91c787ba1e9" (в нижнем регистре без дефисов и фигурных скобок)

Возвращает строку в зависимости от выбранного режима вывода.

XLL ▶ Functions ▶ LikeXLL

dll v5.1

LikeXLL

Используется для сравнения двух строк.

LPXLOPER12 LikeXLL(XCHAR * string, XCHAR * pattern)
Параметры функции:
1. string - входящая строка
2. pattern - шаблон, маска для сравнения со строкой

Аналог оператора LIKE от Microsoft (https://learn.microsoft.com/ru-ru/office/vba/language/reference/user-interface-help/like-operator)
с таким же набором правил составления маски и с таким же возвращаемым результатом

Предоставляет универсальное средство для сравнения строк. Возможности сопоставления шаблона позволяют использовать подстановочные знаки, списки знаков или диапазоны знаков в любой комбинации, чтобы сопоставить строки. В следующей таблице представлены знаки, разрешенные для использования в аргументе pattern, и объясняется, чему они соответствуют:
Знаки в pattern - Сопоставление в string
? - Любой отдельный знак.
* - Ноль или больше знаков.
# - Любая однозначная цифра (0–9).
[ charlist ] - Любой отдельный знак, представленный в charlist.
[ !charlist ] - Любой отдельный знак, не представленный в charlist.

Группа из одного или нескольких символов ( charlist ), заключенная в квадратные скобки ([ ]), может использоваться для сопоставления с любым одним символом в строке и может включать практически любой код символов, включая цифры.

Примечание:

Чтобы получить сопоставление для специальных знаков, а именно для левой квадратной скобки ([), вопросительного знака (?), знака номера (#) и звездочки (*), заключите их в квадратные скобки. Знак правой квадратной скобки (]) не может использоваться в рамках группы для сопоставления самому себе, однако может использоваться за пределами группы как отдельный знак.

С помощью дефиса (-), разделяющего нижнюю и верхнюю границы диапазона, charlist может использоваться для определения диапазона знаков. Например, приводит к совпадению, [A-Z] если соответствующая позиция символов в строке содержит прописные буквы в диапазоне от A до Z. Несколько диапазонов могут включаться в квадратные скобки без использования каких-либо разделителей.

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

Восклицательный знак (!) в начале charlist означает, что выполняется сопоставление, если любой знак, кроме знаков, указанных в charlist, будет найден в аргументе string. При использовании вне квадратных скобок восклицательный знак сопоставляется самому себе.
Дефис (-) может отображаться в начале (но после восклицательного знака, если он используется) или в конце charlist для сопоставления самому себе. На любой другой позиции дефис используется для указания диапазона знаков.
При задании диапазона знаков они должны отображаться по возрастающему порядку сортировки (от наименьшего к наибольшему). [A-Z] является допустимым шаблоном, но [Z-A] не является.
Последовательность [] символов считается строкой нулевой длины ("").

Возвращает TRUE or FALSE в зависимости от итога сравнения строки с шаблоном.

XLL ▶ Commands

Команды XLL в Excel

Команды, использующие COM-взаимодействие с Excel, позволяющие полностью использовать объектную модель Excel и сервер событий Excel.

Команды основного меню библиотеки (надстройки) XLL в Excel

XLL ▶ Commands ▶ XLLcmdHelp

dll v5.0

XLL Help

Форма с информацией о продукте.

XLL API:

LPXLOPER12 XLLcmdHelp(XCHAR* param, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdHelp("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdOpen

dll v5.0

Открыть

Открыть и заразить сохраненные настройки и данные.

XLL API:

LPXLOPER12 XLLcmdOpen(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdOpen ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdSaveAs

dll v5.0

Сохр.как

Сохранить настройки и данные в указанный файл.

XLL API:

LPXLOPER12 XLLcmdSaveAs(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdSaveAs ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdTracePrecedents

dll v5.0

Влияющ.

Показать влияющие ячейки (на выделенный массив).

XLL API:

LPXLOPER12 XLLcmdTracePrecedents(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdTracePrecedents ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdTraceDependents

dll v5.0

Зависим.

Показать зависимые ячейки (от выделенного массива).

XLL API:

LPXLOPER12 XLLcmdTraceDependents(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdTraceDependents ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdRemoveArrows

dll v5.0

Убрать

Убрать все стрелки зависимых и влияющих ячеек.

XLL API:

LPXLOPER12 XLLcmdRemoveArrows(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdRemoveArrows ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdSetNumberFormat

dll v5.0

Числовой формат

Числовой формат (NumberFormat) применить к выделенным ячейкам/сохранить в список форматов/удалить из списка форматов.

XLL API:

LPXLOPER12 XLLcmdSetNumberFormat(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdSetNumberFormat ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdIncreaseDecimal

dll v5.0

Ув.разряд

Увеличить разрядность числа.

XLL API:

LPXLOPER12 XLLcmdIncreaseDecimal(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdIncreaseDecimal ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDecreaseDecimal

dll v5.0

Ум.разряд

Уменьшить разрядность числа.

XLL API:

LPXLOPER12 XLLcmdDecreaseDecimal(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdDecreaseDecimal ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdSetSheetFormat

dll v5.13

Ф.Лист

Хранение форматов листа и их применение к активному листу или к файлам в выбранных папках.

Хранятся данные: обычный формат листа, условный формат, проверка данных, примечания, автофильтр, закрепить области, масштаб, отобразить сетку, показать заголовки, скрытые строки, скрытые столбцы.

XLL API:

LPXLOPER12 XLLcmdSetSheetFormat (XCHAR* param=0, LPXLOPER12 param2)

Параметры

param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - имя сохранения нужного формата (сохраняется в пользовательской форме).

Возвращаемое значение

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Комментарии

Для массовых операций с файлами есть два фильтра: для имен файлов и для имен листов в файлах.

В обоих фильтрах применяется функция Like()

Примеры использования на языках Visual Basic и Python

Visual Basic

Sub TestXLLcmdSetSheetFormat()

    Dim dialogMode, formatName, result

    'Режим пользовательского диалога для данной команды, константы:

    '0 или пусто – значение по умолчанию (то, что выбрано в меню)

    '1 - Всё включено (рекомендуется).

    '2 - Отключить пользовательские сообщения.

    '3 - Отключить информацию в статус-баре Excel.

    '4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.

    '5 - Отключить всё (в т.ч. сообщения об ошибках). Можно только кодом в командах меню, в первом параметре.

    dialogMode = "1"

    'Имя сохранения нужного формата (сохраняется в пользовательской форме).

    formatName = "Мой сохраненный формат"

    'Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

    'Если второй аргумент пропущен - выводится пользовательская форма.

    result = Application.RUN("XLLcmdSetSheetFormat", dialogMode, formatName)

    Debug.Print result

    'примеры вариантов запуска:

    '1.вывод пользовательской формы

    Debug.Print Application.RUN("XLLcmdSetSheetFormat", "1")

    '2.отключение всех пользовательских сообщений, в.ч. ошибок (вывод ошибки только как результат выполнения функции)

    Debug.Print Application.RUN("XLLcmdSetSheetFormat", "5", formatName)

End Sub

Python

from win32com import client

input_xll = r'C:\Users\...\AppData\Roaming\Microsoft\AddIns\BedvitXLL64.xll'

input_file = r'C:\Users\...\Documents\Test.xlsb'

app = client.DispatchEx("Excel.Application")

app.Visible = True

app.RegisterXLL(input_xll)

workbook = app.Workbooks.Open(input_file)

app.Application.Run("XLLcmdSetSheetFormat", "1", "Мой сохраненный формат")

app.Application.Quit()

del app

XLL ▶ Commands ▶ XLLcmdTextToNumber

dll v5.1

Число

Преобразовать выделенные значения/формулы, сохраненные как текст - в числа/формулы. Если выделена одна ячека - обрабатывается весь лист. Будут удалены из числа: неразрывный пробел, пробел, апостроф, перенос строки.

Начиная с версии 5.4 - можно настраивать свой список символов Unicode для удаления из числа (см. подробнее.)

Особенности:

+ максимальная длина строки для преобразования в ячейке - 8190 символов.

+ если выделена одна ячейка, обрабатывается весь лист

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

+ по умолчанию будут удалены из числа: пробел Ch(32), апостроф Ch(39), неразрывный пробел Ch(160)

+ список символов Unicode к удалению из числа можно настроить.

+ этот список символов к удалению применяется только для строк, которые удалось преобразовать в число (удалив эти символы), т.е. в результате - для чисел. Если строку не удалось преобразовать в число - строка выводится полностью, со всеми изначальными символами.

+ новый список символов сохраняется автоматически, при удачном выполнении команды.

+ список символов Unicode к удалению можно, при необходимости, сбросить на список по умолчанию.

XLL API:

LPXLOPER12 XLLcmdTextToNumber(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdTextToNumber ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdNumberToText

dll v5.1

Текст

Преобразовать выделенные числа/формулы - в значения/формулы, сохраненные как текст. Если выделена одна ячейка - обрабатывается весь лист. (см. подробнее)

Особенности:

+ максимальная длина строки для преобразования в ячейке - 8190 символов.

+ если выделена одна ячейка, обрабатывается весь лист

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

XLL API:

LPXLOPER12 XLLcmdNumberToText(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 – зарезервирован 

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdNumberToText ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdTranspose

dll v5.0

Трансп

Транспонирование данных на месте.

XLL API:

LPXLOPER12 XLLcmdTranspose(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdTranspose("1") //Включены все сообщения для данной команды

Имена (группа)

Показать скрытые имена, удалить ошибочные, удалить все имена

XLL ▶ Commands ▶ XLLcmdVisibleHiddenName

dll v5.0

Показать скрытые имена

Показать скрытые имена (отобразить в диспетчере имён).

XLL API:

LPXLOPER12 XLLcmdVisibleHiddenName(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdVisibleHiddenName("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDeleteErrorName

dll v5.0

Удалить ошибочные имена

Удалить все имена с ошибочными значениями (в т.ч. скрытые, не отображаемые в диспетчере имён).

XLL API:

LPXLOPER12 XLLcmdDeleteErrorName(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdDeleteErrorName("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDeleteNames

dll v5.0

Удалить все имена

Удалить все имена (в т.ч. скрытые, не отображаемые в диспетчере имён).

XLL API:

LPXLOPER12 XLLcmdDeleteNames(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdDeleteNames("1") //Включены все сообщения для данной команды

УФ->Ф (группа)

Перевести условное форматирование в обычный формат.

XLL ▶ Commands ▶ XLLcmdConditionalFormatToFormat

dll v5.0

Условный формат в обычный

Перевести условное форматирование в обычный формат ячейки в выделенном диапазоне или на всем листе. Если выделена одна ячейка - обрабатывается весь лист.

XLL API:

LPXLOPER12 XLLcmdConditionalFormatToFormat(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdConditionalFormatToFormat("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdConditionalFormatToFormatAllSheets

dll v5.0

Условный формат в обычный - все листы

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

XLL API:

LPXLOPER12 XLLcmdConditionalFormatToFormatAllSheets(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdConditionalFormatToFormatAllSheets("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdFindSummands

dll v5.0

Поиск сл.

Поиск слагаемых для заданной суммы.

XLL API:

LPXLOPER12 XLLcmdFindSummands(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdFindSummands("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDuplicateValues

dll v5.0

Повторы

Выделить уникальным цветом группы повторов в выделенном диапазоне или на всем листе и/или вывести статистику. Выделение цветом нельзя отменить! В процессе выполнения команды все скрытые ячейки будут показаны. Если выделена одна ячейка - обрабатывается весь лист.

Особенности:

Повторы внутри группы выделяются одинаковым цветом.

Цвета уникальные для каждой группы и каждый раз генерируются случайным образом.

Ограничения Excel - количество уникальных форматов/стилей ячеек (разных цветов): 65 490.

XLL API:

LPXLOPER12 XLLcmdDuplicateValues(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает статистику в виде строки - если команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:

Visual Basic

Option Explicit
 
Sub TestXLLcmdDuplicateValues()
    Dim dialogMode, paint

    'Режим пользовательского диалога для данной команды, константы:
    '0 или пусто – значение по умолчанию (то, что выбрано в меню)
    '1 - Всё включено (рекомендуется).
    '2 - Отключить пользовательские сообщения.
    '3 - Отключить информацию в статус-баре Excel.
    '4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.
    '5 - Отключить всё (в т.ч. сообщения об ошибках). Можно только кодом в командах меню, в первом параметре.
    dialogMode = "1"
    
    'выделяем группы повторов цветом
    paint = True

    'выполняем команду и смотрим статистику в отладчике
    Debug.Print Application.RUN("XLLcmdDuplicateValues", dialogMode, paint)
 
End Sub

XLL ▶ Commands ▶ XLLcmdFindValues

dll v5.0

Найти

Найти на текущем листе значения из выделенной ячейки и выделить все ячейки с найденными дубликатами (учитываются значения и результаты формул). «Tab» - переход по найденным (выделенным) ячейкам.

XLL API:

LPXLOPER12 XLLcmdFindValues(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdFindValues("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdSheets

dll v5.0

Листы

Вывести на новый лист список всех листов текущей книги (с гиперссылкой).

XLL API:

LPXLOPER12 XLLcmdSheets(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdSheets("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdErrors

dll v5.0

Ошибки

Вывести на новый лист список всех ячеек текущей книги, содержащих ошибку. Обрабатываются только видимые листы.

Особенности:

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

По умолчанию проверяется следующий текст похожий на ошибку (можно не проверять, выбрав другой ответ в первоначальном диалоге команды):

#N/A, #VALUE!, #REF!, #DIV/0!, #NUM!, #NAME?, #NULL!, #Н/Д, #ЗНАЧ!, #ССЫЛКА!, #ДЕЛ/0!, #ЧИСЛО!, #ИМЯ?, #ПУСТО!

Проверяются ошибки в итогах формулы в ячейке, в сводной таблице, в таблице.

Обрабатываются только видимые листы.

XLL API:

LPXLOPER12 XLLcmdErrors(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdErrors("1") //Включены все сообщения для данной команды

Связи (группа)

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

XLL ▶ Commands ▶ XLLcmdLinksWorkBook

dll v5.0

Список связей на другие книги

Вывести на новый лист список всех книг, на которые есть связи из данной книги.

XLL API:

LPXLOPER12 XLLcmdLinksWorkBook(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdLinksWorkBook("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdLinksRangeWorkBook

dll v5.0

Список ячеек со связями на другие книги

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

XLL API:

LPXLOPER12 XLLcmdLinksRangeWorkBook(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdLinksRangeWorkBook("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdBreakLinksSheet

dll v5.0

Разорвать связи на ЛИСТЕ

Разорвать связи на текущем ЛИСТЕ с другими ЛИСТАМИ этой книги и ВНЕШНИМИ файлами. Формулы с такими связями при разрыве будут преобразованы в принимаемые на данный момент значения.

XLL API:

LPXLOPER12 XLLcmdBreakLinksSheet(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdBreakLinksSheet ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdCompactValues

dll v5.0

Упл.данные

Уплотнить данные, удалив пустые (не содержащие данные) строки и столбцы. Обрабатывается весь лист. Эту команду нельзя отменить. В процессе выполнения команды все скрытые ячейки будут показаны.

XLL API:

LPXLOPER12 XLLcmdCompactValues(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdCompactValues("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdA1R1C1ReferenceStyle

dll v5.0

A1<->R1C1

Стиль ссылок A1. Изменение формата ссылок на ячейки в формулах Excel.

XLL API:

LPXLOPER12 XLLcmdA1referenceStyle(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdA1referenceStyle("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdArrayUnPivot

dll v5.17

Сл.трансп.

Сложное транспонирование (Unpivot) с условиями. Unpivot (анпивот, отмена свертывания) в Excel — преобразование двумерной таблицы в плоскую, пригодную для построения сводной таблицы.

Особенности:

Уровни заголовка (сверху над данными), будут транспонированы в столбцы, а данные под ними в один итоговый столбец, см. рис.

Созданная таблица будет выгружена на новый лист или несколько листов, если не поместится на один.

XLL API:
LPXLOPER12 XLLcmdArrayUnPivot (XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdArrayUnPivot ("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDataLoadFromExcelSheets

dll v5.17

Загрузить

Загрузка данных из рабочих листов Excel.

 Особенности, что умеет:

>собирать данные для разных шаблонов с заголовками и данными

>объединять данные из разных шаблонов с заголовками и данными

>фильтровать данные по любому столбцу и с любым условием

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

>загружать данные из файлов нужной папки и нужного уровня вложенных подпапок

>фильтровать файлы по имени

>фильтровать листы Excel по имени

>хранить любое количество настроенных шаблонов для дальнейшего использования

>выгружать итоговые данные на указанный лист Excel или в указанную сводную таблицу

XLL API:

LPXLOPER12 XLLcmdDataLoadFromExcelSheets (XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для команд меню XLL - см. "Диалог".
param2 - имя сохранения нужного формата (сохраняется в пользовательской форме).

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Примеры использования на языках Visual Basic и Python

Visual Basic

Sub TestXLLcmdSetSheetFormat()

    Dim dialogMode, saveName, result

    'Режим пользовательского диалога для данной команды, константы:

    '0 или пусто – значение по умолчанию (то, что выбрано в меню)

    '1 - Всё включено (рекомендуется).

    '2 - Отключить пользовательские сообщения.

    '3 - Отключить информацию в статус-баре Excel.

    '4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.

    '5 - Отключить всё (в т.ч. сообщения об ошибках). Можно только кодом в командах меню, в первом параметре.

    dialogMode = "1"

    'Имя нужного пользовательского сохранения (сохраняется в пользовательской форме).

    saveName = "Имя моего сохранения"

    'Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

    'Если второй аргумент пропущен - выводится пользовательская форма.

    result = Application.RUN("XLLcmdDataLoadFromExcelSheets", dialogMode, saveName)

    Debug.Print result

    'примеры вариантов запуска:

    '1.вывод пользовательской формы

    Debug.Print Application.RUN("XLLcmdDataLoadFromExcelSheets", "1")

    '2.отключение всех пользовательских сообщений, в.ч. ошибок (вывод ошибки только как результат выполнения функции)

    Debug.Print Application.RUN("XLLcmdDataLoadFromExcelSheets", "5", saveName)

End Sub

Python

from win32com import client

input_xll = r'C:\Users\...\AppData\Roaming\Microsoft\AddIns\BedvitXLL64.xll'

input_file = r'C:\Users\...\Documents\Test.xlsb'

app = client.DispatchEx("Excel.Application")

app.Visible = True

app.RegisterXLL(input_xll)

workbook = app.Workbooks.Open(input_file)

app.Application.Run("XLLcmdDataLoadFromExcelSheets", "1", "Имя моего сохранения")

app.Application.Quit()

del app

Face (группа)

Коллекция иконок Excel по FaceID (около 32 тыс. штук). Можно вывести на лист.

XLL ▶ Commands ▶ XLLcmdCreateMenuFaceID

dll v5.0

Вывести

Вывести все возможные иконки Excel в меню (по ID).

XLL API:

LPXLOPER12 XLLcmdCreateMenuFaceID(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdCreateMenuFaceID("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDeleteMenuFaceID

dll v5.0

Удалить

Удалить ранее выведенные иконки Excel из меню.

XLL API:

 LPXLOPER12 XLLcmdDeleteMenuFaceID(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdDeleteMenuFaceID("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdCopyFormula

dll v5.0

Copy

Копировать формулы для вставки (без смещения адресов). Не используется буфер обмена. Копируются и скрытые ячейки.

XLL API:

 LPXLOPER12 XLLcmdCopyFormulaLocal(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdCopyFormulaLocal("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdPasteFormula

dll v5.0

Paste

Вставить формулы (без смещения адресов). Не используется буфер обмена. В процессе выполнения команды все скрытые ячейки будут показаны.

XLL API:

 LPXLOPER12 XLLcmdPasteFormulaLocal(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdPasteFormulaLocal("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdVBAModuleStore

dll v5.0

VBA store - beta-версия, эксперимент

Хранилище VBA модулей.

XLL API:

 LPXLOPER12 XLLcmdVBAModuleStore(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdVBAModuleStore("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdRangeStore

dll v5.0

Хран.данных

Хранилище диапазонов формул/значений с возможностью шифрования алгоритмами AES.

Хранение и шифрование диапазонов формул/значений с листа Excel в файле пользовательских сохранений, шифрование данных алгоритмами AES на листе Excel, шифрования файла пользовательских сохранений. (см. https://bedvit.ru/xll/crypto/)
Использованы исходники Crypto++

XLL API:
LPXLOPER12 XLLcmdRangeStore(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 – зарезервирован

Алгоритмы шифрования AES:
    1 - "Без шифрования"
    2 - "AES256:ECB"
    3 - "AES256:CBC"
    4 - "AES256:OFB"
    5 - "AES256:CFB"
    6 - "AES256:CBC-CTS"
    7 - "AES256:CTR"

 Функционал:
+ Можно шифровать как отдельные значения так и диапазоны/массивы.
+ Шифровать можно на листе, шифровать можно сохраняемые диапазоны и шифровать можно и файл пользовательских сохранений.
+ Шифровать данные можно прям на листе Excel, с дальнейшей расшифровкой нужного диапазона или всего листа в виде значений (value2), так и в виде формул (formula).
+ Зашифрованные данные можно хранить в XLL как в виде значений (value2), так и в виде формул (formula). Формула может содержать максимум 8 тыс. символов
+ Пароль нигде не хранится, его знает только пользователь и при утере, расшифровать данные не получится никому
+ Тип данных и алгоритм шифрования запоминается при зашифровки, и их нужно указывать только при шифровании. При расшифровки нужен только 1 пароль (повтор пароля нужен только для шифрования, для расшифровки достаточно одного-первого)
+ Зашифрованные диапазоны - независимые, т.е. можно каждый отдельный диапазон зашифровать со своим паролем, можно зашифровать диапазон дважды (для гиков)
+ Реализовано автоматическое распознавание разных блоков зашифрованных диапазонов, с разными алгоритмами и их расшифровка разом (см. видео), но должен быть одинаковый пароль для случаев пакетной распаковки (сразу всего листа)
+ Для данных у которых упаковка будет экономить размер итоговой зашифрованной строки (для массивов и длинных строк)  - используется алгоритм сжатия WinAPI:XPRESS_HUFF
+ Реализован механизм (shared string table), как и в Excel, для оптимизации размера одинаковых строк (для массивов), см. особенности ниже.
+ Данные на листе Excel шифруются для каждой ячейки отдельно (для возможности хранить и расшифровывать данные независимо для каждой ячейки)
+ Итоговый результат шифрования (любого типа данных: строки, числа, ошибки и т.д.) - хранится в виде строки (массива зашифрованных байт).
+ Для каждой команды есть всплывающие подсказки


Особенности:
+ Сохранять диапазон в списке диапазонов можно в зашифрованном виде или не в зашифрованном (в незашифрованном эффективнее сжимаются сохранения т.к. обрабатываются все дубликаты во всех сохранённых диапазонах, а не частично в отдельном диапазоне), но можно шифровать сам файл пользовательских настроек - эффективность сжатия сохраняется.
+ Есть возможность автоматически определять границы диапазона, выделяя весь лист или целый столбец или целую строку, см. usedrange
+ Добавлена возможность выключать пользовательские сообщения и сообщения в статус-баре Excel

UPD: 03.02.2024 BedvitXLL.dll_v5.1
 
+добавлена возможность использования разных локализаций и разной разрядности Excel при шифровании, дешифровки и сохранении формул/значений (см. видео справку ниже).
+добавлена обработка ошибок на листе Excel при шифровании, дешифровки и сохранении формул/значений.

Справочно: форма для шифрования - МОДАЛЬНАЯ, т.е. что бы выделить новый диапазон нужно щелкнуть на адрес.

UPD: 20.06.2024 BedvitXLL.dll_v5.8
+ В процессе выполнения команды все скрытые ячейки будут показаны.

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdHelp("1") //Включены все сообщения для данной команды

Архив (группа)

Тестовые команды, beta-функционал или команды, которые устарели или были заменены более новыми (в след. версиях библиотеки эти команды могут быть удалены).

v(version)

Текущая версия XLL-библиотеки.

f(file)

Версия и расположение активного файла пользовательских настроек (все пользовательские настройки и данные сохраняются в нем сразу же при изменениях).

XLL ▶ Commands ▶ XLLcmdRegisterBedvitCOM

dll v5.0

BedvitCOM: OFF/ON/R

Регистрация библиотеки BedvitCOM в реестре и автоподключение в References (VBA): OFF/ON/R.
OFF - нет автоподключения (ни в реестре Windows, ни в References (VBA).
ON - есть автоподключение (и в реестре Windows, и в References (VBA).
R - только регистрация в реестре Windows (нет автоподключения в References (VBA).
Порядок переключений: OFF->ON->R->OFF.

XLL API:

 LPXLOPER12 XLLcmdRegisterBedvitCOM(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdHelp("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdMenuLanguage

dll v5.0

Язык

Язык основного меню и контекстного меню.

XLL API:

LPXLOPER12 XLLcmdMenuLanguag (XCHAR* param=0, LPXLOPER12 param2)

param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdMenuLanguag("1") //Включены все сообщения для данной команды

XLL ▶ Commands ▶ XLLcmdDialogMode

dll v5.0

Диалог

Режим пользовательского диалога по умолчанию для команд меню XLL  (пользовательские сообщения, информация в статус-баре Excel и сообщения об ошибках).

Задается в меню XLL для всех команд - как значение "по умолчанию". Пользовательский функционал.

Для разработчика, дополнительно, кодом можно задать свое, отдельное значение для каждой команды XLL API - в первом параметре (на время выполнения этой команды), см. константы ниже.

Константы:

0 или пусто – значение по умолчанию (то, что выбрано в меню)

1 - Всё включено (рекомендуется).
2 - Отключить пользовательские сообщения.
3 - Отключить информацию в статус-баре Excel.
4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.

5 - Отключить всё (в т.ч. сообщения об ошибках).  Можно только программно в командах XLL API - кодом в первом параметре = '5'

XLL API:

LPXLOPER12 XLLcmdDialogMode(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - новое значение константы (режима пользовательского диалога), назначаемое по умолчанию (значения 1 - 4).

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:

Visual Basic

Option Explicit
 
Sub TestXLLcmdDialogMode()
    Dim dialogMode, dialogModeNew
    
    'Режим пользовательского диалога для данной команды (на время выполнения команды), константы:
    '0 или пусто – значение по умолчанию (то, что выбрано в меню)
    '1 - Всё включено (рекомендуется).
    '2 - Отключить пользовательские сообщения.
    '3 - Отключить информацию в статус-баре Excel.
    '4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.
    '5 - Отключить всё (в т.ч. сообщения об ошибках). Можно только кодом в командах меню, в первом параметре.
    dialogModeNew = "1"
    
    'Назначаем новый режим "по умолчанию" для всех команд
    dialogModeNew = "2"
    
    'выполняем команду и смотрим новый режим пользовательского диалога по умолчанию для команд меню XLL (в меню).
    Debug.Print Application.RUN("XLLcmdDialogMode", dialogMode, dialogModeNew)
 
End Sub

XLL ▶ Commands ▶ XLLcmdXLLAPIList

dll v5.0

XLL API

Надстройка BedvitXLL имеет свое API для возможности использования функционала надстройки в других инструментах/языках/скриптах.

Все команды XLL (с префиксом XLLcmd) зарегистрированы в Excel и их можно вызывать с нужными параметрами с помощью Application.RUN (см. пример ниже)

Клик на контрол-список XLL API в меню надстройки - выводит список всех зарегистрированных в Excel команд XLL.

Формат списка: Имя команды меню XLL/Имя кнопки/Описание

Пример использования API в VBA (Excel), Python (Excel):

Visual Basic

Sub TestXLLcmdHelp()

    Dim dialogMode, result

    'Режим пользовательского диалога для данной команды, константы:

    '0 или пусто – значение по умолчанию (то, что выбрано в меню)

    '1 - Всё включено (рекомендуется).

    '2 - Отключить пользовательские сообщения.

    '3 - Отключить информацию в статус-баре Excel.

    '4 - Отключить пользовательские сообщения + информацию в статус-баре Excel.

    '5 - Отключить всё (в т.ч. сообщения об ошибках). Можно только кодом в командах меню, в первом параметре.

    dialogMode = "1"

    'Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

    result = Application.RUN("XLLcmdHelp", dialogMode)

    Debug.Print result

End Sub

Python

from win32com import client

input_xll = r'C:\Users\...\AppData\Roaming\Microsoft\AddIns\BedvitXLL64.xll'

input_file = r'C:\Users\...\Documents\Test.xlsb'

app = client.DispatchEx("Excel.Application")

app.Visible = True

app.RegisterXLL(input_xll)

workbook = app.Workbooks.Open(input_file)

app.Application.Run("XLLcmdHelp", "1")

app.Application.Quit()

del app

XLL ▶ Commands ▶ XLLcmdMenuSetting

dll v5.0

МЕНЮ

Настройка меню BedvitXLL (основное + контекстное). Можно включать и отключать элементы меню.

XLL API:

LPXLOPER12 XLLcmdMenuSetting(XCHAR* param=0, LPXLOPER12 param2)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 - зарезервирован

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример:
XLLcmdMenuSetting("1") //Включены все сообщения для данной команды

Команды библиотеки (надстройки) XLL не в меню 

XLL ▶ Commands ▶ XLLcmdE12xlSet

dll v5.3

XLLcmdE12xlSet

Команда XLL. Очень быстро помещает значения констант в ячейки или диапазоны.

Данные помещаются в том же формате, в котором эти данные были изначально в значении или в массиве, т.е. без преобразования.

Использована функция xlSet из Excel C API.

XLL API:

LPXLOPER12 XLLcmdE12xlSet(XCHAR * param, LPXLOPER12 param2, LPXLOPER12 pxReference, LPXLOPER12 pxValue)
param - отдельный режим диалога для данной команды меню XLL - см. "Диалог".
param2 – зарезервирован

pxReference - Прямоугольная ссылка (адрес), описывающая целевую ячейку или ячейки. Адрес должен описывать смежные ячейки.

pxValue - Значение или значения, помещаемые в ячейку или ячейки.

Аргумент pxValue

pxValue может быть значением или массивом. Если это значение, этим значением заполняется весь диапазон назначения. Если это массив, элементы массива помещаются в соответствующие расположения в прямоугольнике.

Если для четвертого аргумента используется горизонтальный массив, он дублируется вниз, чтобы заполнить весь прямоугольник. Если используется вертикальный массив, он дублируется вправо для заполнения всего прямоугольника. Если вы используете прямоугольный массив, и он слишком мал для прямоугольного диапазона, в который вы хотите его поместить, этот диапазон заполняется исходными данными размером с массив, а остальной диапазон заполняется #Н/Д.

Если целевой диапазон меньше исходного массива, значения копируются до пределов целевого диапазона, а лишние данные из массива игнорируются.

Чтобы очистить элемент прямоугольника назначения, используйте элемент массива типа Empty в исходном массиве.

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

Ограничения

Невозможно отменить xlSet. Кроме того, он удаляет все сведения об отмене, которые могли быть доступны ранее.

XlSet может помещать в ячейки только константы, а не формулы. Максимальная длина помещаемой строки 8190 символов.

Возвращает код ошибки: 0 - команда выполнена успешно и Error 2036, #NUM!, #ЧИСЛО! - если ошибка.

Пример использования:

Visual Basic

Sub TestXLLcmdE12xlSet()

    Dim i, testSize As Long: testSize = 2

    Dim arrOrValue: ReDim arrOrValue(1 To testSize, 1 To 1)

    For i = 1 To testSize

        arrOrValue(i, 1) = Str(i) 'MAX количество символов для ячейки: 8190

    Next

    'Варианты использования:

    '1.Выводим массив или значение по указанному диапазону на лист Excel

    Debug.Print Application.RUN("XLLcmdE12xlSet", "", 0, Range("a1:a2").Address, arrOrValue)

    '2. Помещаем в диапазон значение "1"

    Debug.Print Application.RUN("XLLcmdE12xlSet", "", 0, Range("b1:b2").Address, "1")

    '3. Выводим массив по указанному диапазону на лист Excel, первый элемент = Empty

    arrOrValue(1, 1) = Empty 'первый элемент Empty

    Debug.Print Application.RUN("XLLcmdE12xlSet", "", 0, Range("c1:c2").Address, arrOrValue)

    '4 Очищаем заданный диапазон от данных

    [d1:d5] = 2 'заполняем данными (2) диапазон для теста

    Debug.Print Application.RUN("XLLcmdE12xlSet", "", 0, Range("d1:d2").Address) ' очищаем в заданном диапазоне

End Sub

COM

 
Библиотека COM

DLL c COM интерфейсом. Реализованы dual-интерфейсы с Automation-совместимыми типами данных, структур (поддержка как раннего связывания (статистической линковки), так и позднего (динамической). Раннее - предпочтительнее в части скорости (на 50% быстрее).

Регистрация COM реализовано как под админом, так и под пользователем (актуально в офисной части клиентов).

Регистрация стандартная:

Админ: Regsvr32 "FullName.DLL"

Пользователь: Regsvr32 /i /n "FullName.DLL"

Удалить из реестра:

Regsvr32 /u "FullName" 

Главная страница библиотеки BedvitCOM (здесь можно посмотреть примеры, скачать надстройку)

COM ▶ BignumArithmeticInteger

 
Класс BignumArithmeticInteger

Класс целых чисел с арифметикой (BignumArithmeticInteger).

Реализовано два класса: класс целых чисел с арифметикой (BignumArithmeticInteger) и класс чисел с плавающей точкой (BignumArithmeticFloat).

При создании экземпляра класса создается массив из длинных чисел и арифметикой. К Bignum числам можно обращаться по индексам в массиве.

BignumArithmeticInteger (Bignum) увеличивается в памяти по мере расчета - автоматически, перераспределяя память.

Размер чисел ничем не ограничен, кроме вашей оперативной памяти.
Проект основан на исходниках (С++) библиотеки MPIR, Edition 3.0.0. (https://github.com/wbhart/mpir).

COM ▶ BignumArithmeticInteger ▶ Help

dll v4.0

Help

HTML Справка (без параметров). Открывает html-страницу с описанием свойств и методов класса.

void Help()

COM ▶ BignumArithmeticInteger ▶ Bignum

dll v4.0

Bignum

Принимает и возвращает BSTR строку StringBSTR (задает число или возвращает значение).

BSTR Bignum(LONG Bignum, LONG BignumBase=10) = BSTR 
Bignum-индекс длинного числа в массиве. 
BignumBase-база длинного числа (от 2 до 62), по умолчанию = 10.

COM ▶ BignumArithmeticInteger ▶ Sign

dll v4.0

Sign

Возвращает знак длинного числа.

LONG Sign(LONG Bignum)
Возвращает 1 если Bignum > 0, 0 если Bignum = 0, и -1 если Bignum < 0.

COM ▶ BignumArithmeticInteger ▶ Even

dll v4.0

Even

Определяет, является ли Bignum четное или нечетное.

LONG Even(BYTE Bignum)
Возвращает 1 если Bignum четное, 0 если Bignum нечетное.

COM ▶ BignumArithmeticInteger ▶ Compare

dll v4.0

Compare

Сравнивает два длинных числа.

LONG Compare(LONG Bignum1, LONG Bignum2)
Возвращает 1 если Bignum1 > Bignum2, 0 если Bignum1 = Bignum2, и -1 если Bignum1 < Bignum2.

COM ▶ BignumArithmeticInteger ▶ BignumSet

dll v4.0

BignumSet

Задает число с параметрами аналогичными методу Bignum().

BignumSet(LONG Bignum, BSTR StringBSTR, LONG BignumBase=10)

COM ▶ BignumArithmeticInteger ▶ Sum

dll v4.0

Sum

Суммирует два длинных числа.

Sum(BYTE BignumSet, BYTE Bignum1, BYTE Bignum2); 
BignumSet = Bignum1 + Bignum2

COM ▶ BignumArithmeticInteger ▶ SumL

dll v4.0

SumL

Суммирует длинное число с обычным.

SumL(BYTE BignumSet, BYTE Bignum1, LONG_PTR LONG_PTR); 
BignumSet = Bignum1 + LONG_PTR(х64:LONG_PTR= LONGLONG, х32:LONG_PTR= LONG)

COM ▶ BignumArithmeticInteger ▶ Abs

dll v4.0

Abs

Возвращает модуль числа.

Abs(BYTE BignumSet, BYTE Bignum1); 
Возвращает модуль значения из Bignum1 в BignumSet.

COM ▶ BignumArithmeticInteger ▶ Negate

dll v4.0

Negate

Задает значение с противоположным знаком.

Negate(BYTE BignumSet, BYTE Bignum1); 
Возвращает значение с противоположным знаком из Bignum1 в BignumSet. BignumSet = - Bignum1.

COM ▶ BignumArithmeticInteger ▶ Subtract

dll v4.0

Subtract

Вычитает из одного длинного числа другое.

Subtract(BYTE BignumSet, BYTE Bignum1, BYTE Bignum2); 
BignumSet = Bignum1 - Bignum2

COM ▶ BignumArithmeticInteger ▶ SubtractL

dll v4.0

SubtractL

Вычитает из длинного числа обычное.

SubtractL(BYTE BignumSet, BYTE Bignum1, LONG_PTR LONG_PTR); 
BignumSet = Bignum1 - LONG_PTR.

COM ▶ BignumArithmeticInteger ▶ Multiply

dll v4.0

Multiply

Умножает одно длинное число на другое. 

Multiply(BYTE BignumSet, BYTE Bignum1, BYTE Bignum2); 
BignumSet = Bignum1 * Bignum2.

COM ▶ BignumArithmeticInteger ▶ MultiplyL

dll v4.0

MultiplyL

Умножает длинное число на обычное. 

MultiplyL(BYTE BignumSet, BYTE Bignum1, LONG_PTR LONG_PTR); 
BignumSet = Bignum1 * LONG_PTR.

COM ▶ BignumArithmeticInteger ▶ Divide

dll v4.0

Divide

Делит одно длинное число на другое.

Divide(BYTE BignumQuotient, BYTE BignumRemainder, BYTE Bignum1, BYTE Bignum2); 
При делении получаем частное в BignumQuotient, остаток от деления в BignumRemainder = Bignum1 / Bignum2.

COM ▶ BignumArithmeticInteger ▶ DivideL

dll v4.0

DivideL

Делит длинное число на обычное.

DivideL(BYTE BignumQuotient, BYTE BignumRemainder, BYTE Bignum1, LONG_PTR LONG_PTR); 
При делении получаем частное в BignumQuotient, остаток от деления в BignumRemainder = Bignum1 / LONG_PTR.

COM ▶ BignumArithmeticInteger ▶ Power

dll v4.0

Power

Возводит в степень длинное число.

Power(BYTE BignumSet, BYTE Bignum1, LONG_PTR LONG_PTR);
Возводит в степень LONG_PTR длинное число Bignum1, результат возвращает в BignumSet.  BignumSet = Bignum1 ^ LONG_PTR.

COM ▶ BignumArithmeticInteger ▶ Clone

dll v4.0

Clone

Копирует одно длинное число в другое.

Clone(BYTE BignumSet, BYTE Bignum1); 
Копирует Bignum1 в BignumSet. 
BignumSet = Bignum1

COM ▶ BignumArithmeticInteger ▶ RootRem

dll v4.0

RootRem

Извлекает корень длинного числа.

RootRem(BYTE BignumRoot, BYTE BignumRemainder, BYTE Bignum1, LONG_PTR n_root);
Извлекает корень n_root-степени из Bignum1. 
Целочисленный результат возвращает в BignumRoot, остаток в BignumRemainder = (n-th root)√ Bignum1.

COM ▶ BignumArithmeticInteger ▶ Factorial

dll v4.0

Factorial

Возвращает факториал для длинного числа.

Factorial(BYTE BignumSet, LONG n);
Возвращает в BignumSet факториал n!

COM ▶ BignumArithmeticInteger ▶ Fibonacci

dll v4.0

Fibonacci

Возвращает в число Фибоначчи для длинного числа.

Fibonacci(BYTE BignumSet, LONG_PTR n);
Возвращает в BignumSet число Фибоначчи n. 
Fn+1 = Fn + Fn-1

COM ▶ BignumArithmeticInteger ▶ LucNum

dll v4.0

LucNum

Возвращает число Лукаса для длинного числа.

LucNum(BYTE BignumSet, LONG_PTR n); 
Возвращает в BignumSet число Лукаса n. 
Ln+1 =Ln + Ln-1

COM ▶ BignumArithmeticInteger ▶ FileSet

dll v4.0

FileSet
 
Загружает длинное число из файла (*.txt).

FileSet(BYTE Bignum, BSTR StringBSTRFileName, LONG BignumBase=10);
Принимает BSTR* строку StringBSTRFileName в качестве полного пути и имени файла. 
Bignum-индекс длинного числа в массиве. 
BignumBase-база числа (от 2 до 62), по умолчанию = 10.

COM ▶ BignumArithmeticInteger ▶ FileGet

dll v4.0

FileGet

Сохраняет длинное число в файл (*.txt).

FileGet(BYTE Bignum, BSTR StringBSTRFileName, LONG BignumBase=10);
Сохраняет длинное число в файл (*.txt). 
Принимает BSTR* строку StringBSTRFileName в качестве полного пути и имени файла. 
Bignum-индекс длинного числа в массиве. 
BignumBase-база числа (от 2 до 62), по умолчанию = 10.BignumSet

COM ▶ BignumArithmeticInteger ▶ Clear

dll v4.0

Clear

Освобождает память занятую длинным числом.

Clear(LONG Bignum=-1);
Освобождает память занятую длинным числом Bignum, или освобождает память занятую всеми числами при заданном параметре по умолчанию = -1.

COM ▶ BignumArithmeticInteger ▶ BignumArraySize

dll v4.0

BignumArraySize

Возвращает количество чисел Bignum в созданном классе/массиве.

LONG Val = BignumArraySize();
Возвращает количество чисел Bignum в созданном классе/массиве.
Начиная с v2.0.0.0 (теперь массив чисел может быть произвольного размера, а не как ранее 256 чисел, размер увеличиваться автоматически.)

COM ▶ BignumArithmeticFloat

Класс BignumArithmeticFloat

Класс чисел с плавающей точкой (BignumArithmeticFloat).

Реализовано два класса: класс целых чисел с арифметикой (BignumArithmeticInteger) и класс чисел с плавающей точкой (BignumArithmeticFloat).

При создании экземпляра класса создается массив из длинных чисел и арифметикой.

К Bignum числам можно обращаться по индексам в массиве.

BignumArithmeticFloat (Bignum) - задается изначально, т.к. дробь может быть бесконечной (по умолчанию принимается минимальный размер).
Размер чисел ничем не ограничен, кроме вашей оперативной памяти.

Обратите внимание, что функции BignumArithmeticFloat (Bignum) основаны на таком же принципе действия, как и IEEE, но не предназначены для плавного расширения для арифметики IEEE P754. В частности, результаты, полученные на одном компьютере, часто отличаются от результатов на компьютере с другим размером машинного слова.

Проект основан на исходниках (С++) библиотеки MPIR, Edition 3.0.0. (https://github.com/wbhart/mpir).

COM ▶ BignumArithmeticFloat ▶ Help

dll v4.0

Help

HTML Справка (без параметров). Открывает html-страницу с описанием свойств и методов класса.

void Help()

COM ▶ BignumArithmeticFloat ▶ SizeBits

dll v4.0

SizeBits

Задает и возвращает размер длинного числа.

LONG Val = SizeBits(BYTE Bignum, LONG_PTR* pVal) = .LONG Val;
Задает и возвращает размер длинного числа в БИТАХ LONG Val. 
Bignum-индекс длинного числа в массиве.

COM ▶ BignumArithmeticFloat ▶ Bignum

dll v4.0

Bignum

Принимает и возвращает BSTR строку StringBSTR (задает число или возвращает значение).

BSTR* StringOut = Bignum(BYTE Bignum, LONG BignumBase=10, LONG_PTR Precision=0, BSTR Separator=”.”, VARIANT_BOOL eNotationOFF=0) = BSTR* StringIn; 
Принимает и возвращает BSTR* строку String (задает число или возвращает значение). 
Bignum-индекс длинного числа в массиве. 
BignumBase-база длинного числа (от 2 до 62), по умолчанию = 10. 
Precision – точность (кол-во значимых цифр в числе), по умолчанию = 0 - максимальная (равна заданному размеру в битах). 
Separator – символ разделителя целой и дробной частей числа, по умолчанию точка(“.”). 
eNotationOFF – по умолчанию =0 - экспоненциальная запись (Е-нотация), 1 – дробная по выбранному основанию.
Для Е-нотации с основанием от 2 до 62: в десятичном основании - символ 'e', в других 2 - 9,11 - 62 - символ '@'.
Мантисса выводится в указанном основании, экспонента всегда в десятичном формате.

COM ▶ BignumArithmeticFloat ▶ Sign

dll v4.0

Sign

Возвращает знак длинного числа.

LONG Val = Sign(BYTE Bignum); 
Возвращает знак длинного числа LONG Val.
Возвращает 1 если Bignum > 0, 0 если Bignum = 0, и -1 если Bignum < 0.

COM ▶ BignumArithmeticFloat ▶ Compare

dll v4.0

Compare

Сравнивает два длинных числа.

LONG Val = Compare(BYTE Bignum1, BYTE Bignum2); 
Возвращает 1 если Bignum1 > Bignum2, 0 если Bignum1 = Bignum2, и -1 если Bignum1 < Bignum2.

COM ▶ BignumArithmeticFloat ▶ SizeBitsSet

dll v4.0

SizeBitsSet

Метод. Задает размер длинного числа.

SizeBitsSet(BYTE Bignum, LONG_PTR SizeBits);
Задает размер длинного числа в БИТАХ LONG Val.

COM ▶ BignumArithmeticFloat ▶ BignumSet

dll v4.0

BignumSet

Задает длинное число.

BignumSet(BYTE Bignum, BSTR StringBSTR, LONG BignumBase=10, BSTR Separator=”.”); 
Задает число с параметрами, аналогичными методу Bignum(), см. Bignum().