﻿################################################################################
Script : Chem String Functions Library 
Author : Chem
E-mail : chemodun@gmail.com 
Web    : http://www.elite-games.ru/x3/ 
Version: 2.09
Desc.  :
  Предоставляет в пользование несколько функций обработки строк
################################################################################
_____________
Инсталляция: 
Для установки скрипта разверните архив в каталог с установленной игрой. 

______
Использование: 

Библиотека состоит из двух файлов:
setup.lib.chem.string.xml  - подготавливает специальный массив размеров символов 
	Не требует входных параметров.
lib.chem.strings.xml - главный скрипт библиотеки.
	6 параметров:
		mode (Work Mode) - определяет имя требуемой функции
		Arg1..Arg5 - параметры функции
Версия 2.09 библиотеки предоставляет 6 функций:
1. split.string.by.delim
	Arg1 - строка-разделитель
	Arg2 - исходная строка
	Arg3 - максимальное количество частей, на которое нужно разбить исходную строку (если не задано - max count = 99)
	return - массив содержащий части исходной строки
	Функция осуществляет разбиение исходной строки (Arg2) используя разделитель (Arg1). 
	Вы можете задать максимальное число частей, на которое будет разбита строка (Arg3), т.е. если Arg1 содержит более чем одну строку-разделитель (Arg1), а вы задали Arg3 = 2 - функция вернет массив, содержащий 2 элемента, в первом будет исходная строка Arg2 до первого вхождения в нее Arg1, второй - всю остальную строку.
	
2.'fill.spaces'
	Arg1 - исходная строка
	Arg2 - максимальная необходимая длина
	Arg3 - заполняем слева - [TRUE] или справа - [FALSE]
	Эта функция дополняет строку пробелами основываясь не на количестве символов в исходной, а на их суммарной ширине, которую они будут иметь при выводе в журнал игрока.
	Длина символа по умолчанию принята равной двум пробелам.
	Однако некоторые символы фактически шире, некоторые - уже.
	Функция использует спецмассив размеров символов, полученный экспериментально., он записан в языковых файлах  x8910.xml.
	Поддержаны: English, Russian, and German languages.
	Если длина исходной строки больше чем (Arg2*2) пробелов - возвращает исходную строку, иначе - дополненную до нужной длины слева или справа (базируясь на значении Arg3). 
	См. примеры:
		Если ваш браузер поддерживает анимированные гифы - 
			http://img148.imageshack.us/img148/2916/lsccompare01rushg3.gif
			http://img204.imageshack.us/img204/6434/lsccompare02rusio7.gif	
		Если нет:
			вывод без использования 'fill.spaces'
				http://img139.imageshack.us/img139/8823/lcsruno01kh6.jpg
				http://img143.imageshack.us/img143/918/lcsruno02kc2.jpg
			вывод с использованием 'fill.spaces'
				http://img145.imageshack.us/img145/3559/lcsruyes01ao9.jpg
				http://img152.imageshack.us/img152/9528/lcsruyes02cz2.jpg
3,4 'sum.to.string'и 'number.to.string' 
	Arg1 - целое
	return - строка
	преобразовывает число 1234567890 в строку вида 1,234,567,890 или
	сумму 1234567890 в строку 1,234,567,890 Кр (использует краткое наименование валюты в игре)

5,6 'fill.sum.to.string'и 'fill.number.to.string' 
	Arg1 - целое
	Arg2 - максимальная необходимая длина
	Arg3 - заполняем слева - [TRUE] или справа - [FALSE]
	return - строка
	преобразовывает число 1234567890 в строку вида 1,234,567,890 или
	сумму 1234567890 в строку 1,234,567,890 Кр (использует краткое наименование валюты в игре)
	Затем действует аналогично вызову функции 'fill.spaces', принимая полученную строку за исходную.

_____________
Деинсталляция: 

Для удаления скрипта удалите файлы из соответствующих каталогов игры. 

_____________
Информация:
Использует 
Языковой файл:
8910
Языковая страница:
8910

_____________
История:
	
2.09	- первый публичный релиз.

_______________________
 © Chem 
