Основы
В данном разделе представлены основные правила работы с LibreOffice Basic.
Код LibreOffice Basic основан на подпрограммах и функциях, которые определены между разделами sub...end sub и function...end function. Каждая подпрограмма или функция может вызывать другие подпрограммы или функции. Если записать общий код для подпрограммы или функции, скорее всего, его можно будет использовать в других программах. См. также Процедуры и функции.
Существуют некоторые ограничения для имён ваших публичных переменных и функций. Не допускается использование имён совпадающих с именами модулей в библиотеке.
Что такое "Sub"
Sub — краткая форма слова subroutine (подпрограмма). Подпрограмма используется для управления конкретной задачей в программе. Подпрограммы служат для разбиения задачи на отдельные процедуры. Разбиение программы на процедуры и подпроцедуры улучшает читаемость и уменьшает возможность возникновения ошибок. Подпрограмма по возможности использует некоторые параметры как аргументы, но не возвращает значения вызывающей подпрограмме или функции, например:
DoSomethingWithTheValues(MyFirstValue,MySecondValue)
Что такое функция?
Функция, по существу, является подпрограммой, возвращающей значение. Функцию можно использовать в правой части описания переменной или в других местах, где обычно используются значения, например:
MySecondValue = myFunction(MyFirstValue)
Глобальные и локальные переменные
Глобальные переменные являются общими для всех подпрограмм и функций в модуле. Они описываются в начале модуля до первой подпрограммы или функции.
Переменные, описанные в подпрограмме или функции, могут использоваться только в пределах этой подпрограммы или функции. Эти переменные переопределяют глобальные переменные с таким же именем и локальные переменные с таким же именем из родительских подпрограмм или функций.
Структурирование
После разделения программы на процедуры и функции, их можно сохранить как файлы для использования в других проектах. В LibreOffice Basic предусмотрена поддержка модулей и библиотек. Подпрограммы и функции всегда содержатся в модулях. Модули можно определить как глобальные или как часть документа. Несколько модулей можно объединить в библиотеку.
Подпрограммы, функции, модули и библиотеки разрешается копировать или перемещать из одного файла в другой с помощью диалогового окна Макрос.