################################################################################
Script : Chem String Functions Library 
Author : Chem
E-mail : chemodun@gmail.com 
Web    : http://www.elite-games.ru/x3/ 
Version: 2.09
Desc.  :
  Provide some functions for manipulate with string
################################################################################
_____________
Installation: 

For installation of script copy content an archive in a catalogue with the set game. 


______
Use: 

Libraries has two script files:
setup.lib.chem.string.xml  - this file prepare special array for filling string by space. 
	Script doesn't have any parameters.
lib.chem.strings.xml - main library script.
	Script has 6 parameters:
		mode (Work Mode) - for defining which function called from library
		Arg1..Arg5 - for setting functions parameters
Now in version 2.09 library provide 6 functions:
1. split.string.by.delim
	Arg1 - string-delimeter
	Arg2 - string-source
	Arg3 - max count parts of source string (if null - max count = 99)
	return - array of found parts of source string
	It's function can split source string (Arg2) by separator (Arg1). 
	You can set maximum count of parts for splitting (Arg3), i.e. if Arg1 has more then one occurrence of delimiter (Arg1), but you set Arg3 = 2 - function will return array with only 2 elements, first - source string before first occurrence of Arg1 in Arg2, and second - all source after this first occurrence.
	
2.'fill.spaces'
	Arg1 - source string
	Arg2 - max len
	Arg3 - fill from :left - [TRUE] or  right - [FALSE]
	It's function will fill source string by spaces based not on count of symbols in string, but on their width on screen in player logbook.
	I.e. default length for one symbols it this function will taken equal to two spaces.
	In fact some symbols have length more then two spaces, some - less.
	Function use special array, was prepared in setup script by experimental data form text files x8910.xml.
	Now supported only English, Russian, and German languages.
	If length source string more then (Arg2*2) spaces - return unchanged string, else return source string was filled by spaces from left or right(based on value Arg3). 
	See examples:
		If you browser support animated gif - 
			http://img72.imageshack.us/img72/5404/lsccompare01engid5.gif
			http://img216.imageshack.us/img216/5885/lsccompare02engls6.gif	
		Or if not:
			output without 'fill.spaces'
				http://img137.imageshack.us/img137/2357/lcsengnot01rx8.jpg
				http://img141.imageshack.us/my.php?image=lcsengnot02vz9.jpg
			output wtih 'fill.spaces'
				http://img144.imageshack.us/img144/9210/lcsengyes01bc7.jpg
				http://img149.imageshack.us/img149/5686/lcsengyes02xt5.jpg

3,4 'sum.to.string'and 'number.to.string' 
	Arg1 - integer
	return - string
	will do convert number 1234567890 to string like 1,234,567,890 or
	will do convert sum 1234567890 to string like 1,234,567,890 Cr (add default name of games currency)

5,6 'fill.sum.to.string'and 'fill.number.to.string' 
	Arg1 - integer
	Arg2 - max length
	Arg3 - fill from :left - [TRUE] or  right - [FALSE]
	return - string
	will do convert number 1234567890 to string like 1,234,567,890 or
	will do convert sum 1234567890 to string like 1,234,567,890 Cr (add default name of games currency)
	Then fill converted string as it can be done via 'fill.spaces'

_____________
Uninstallation: 

For the delete of script will delete files from the proper catalogues of game. 

_____________
Info:
Uses 
Text Files Used:
8910
Text Pages Used:
8910


_____________
History:

2.09 - first public release

_______________________
  Chem
