=====================================================================
AJPapps - VB string functions

Линда Кайе 2024. Посвящается Ариэль
=====================================================================

Этот скрипт содержит Ruby модуль со строковыми функциями в стиле Visual Basic 6. Я написала его в основном в учебных целях, а также потому, что все эти text[12, -5] сразу не легли на извилины.

Мне не удалось точно воспроизвести все функции, но я постаралась обеспечить максимальное соответствие. Где не удалось совладать с различиями в реализации опциональных параметров, я сделала несколько вариантов функций. Например, instr2() принимает параметр start, а instr() - нет.

Параметр Compare из перечисления превратился в булевый параметр textcompare.

Кроме функций VB6, я добавила пару функций из своей библиотеки AJPappsSupport.DLL - аналоги asTrimEx() сотоварищи. В конце концов стандартной функцией Trim() пользоваться невозможно в принципе ^^'

Модуль используется как-то так:

> require_relative "vb"
> 
> txt = VB.left(txt, 12)
> arr = VB.split(txt, "\n")

Разумеется, файл vb.rb нужно поместить в каталог с основной программой.

Модуль тестировался в Ruby 2.0.0 и выше. Так же он требует гем unicode, установить который можно следующей командой:

> gem install unicode

История изменений
-----------------

• 24.02.2017
  Первая публичная версия ^^
  
• 13.12.2017
  [-] Функции split() и split2() работали в отрыве VB реалий. Исправлена куча моментов, когда параметры интерпретировались не так, как в VB.
  
• 14.12.2017
  [-] Ещё одна ошибка в split() и split2(). Там лимит выставлялся в девять, и парсилась только часть строки.
  
• 28.10.2024
  [+] Поправлен шебанг.

Маленький копирайт
------------------

1. Программа и исходный код распространяются бесплатно.
2. Вы имеете право распространять их на тех же условиях.
3. Вы не имеете права использовать имя автора после модификации исходного кода.
4. При этом желательно указывать ссылку на автора оригинальной версии исходного кода.
5. Вы не имеете права на платное распространение исходного кода, а также программных модулей, содержащих данный исходный код.
6. Программа и исходный код распространяются как есть. Автор не несёт ответственности за любые трагедии или несчастные случаи, вызванные использованием программы и исходного кода.
7. Для любого пункта данного соглашения может быть сделано исключение с разрешения автора программы.
8. По любым вопросам, связанным с данной программой, обращайтесь по адресу [email protected]