README

String is a library that turns your strings in PHP into objects. This allows you to have a more object oriented approach to
executing PHP's built in string functions using a fluent interface. The objective of this library was to create a readable way
to execute all of your string functions and have the manipulated string returned at the end, without the need for nesting
functions.

Notice we didn't pass the original string to the trim method. This is because the string class keeps all of the evolutions that occur to your starting string and automaticlly sends the last evolution to the requested method.
We will review later how to retrieve all of the evolutions, so you can compare them.

When the last evolution to occur to your string is not a string, and cannot be casted into a string the library returns with an empty string to prevent
errors from occuring. To get around this you can tell the string library to return a specific data type. There are two ways of doing this.
You can either call direct_return() which will return the last evolution to your starting string, or you can call return_{datatype}*. If you call
return_{datatype} the string class will verify that the last evolution datatype is matching your requested datatype. If it doesn't an exception will be thrown.

*At this point there are two datatype return methods.

return_string

return_array

Exposed Methods

All the string functions listed on PHP's manual page excepted the following are exposed as method calls in the String class.

convert_cyr_string

fprintf

hebrev

hebrevc

hex2bin

money_format

nl_langinfo

strtok

vfprintf

vprintf

vsprintf

Natural Methods

Natural methods are class methods that were either directly created for this class, or native PHP string functions that had parameters in a certain order. Here is a list of all the natural methods that occur in this class.

set_string

evolution_counter

_call_last_evolution

_agitate_arguments

return_string

return_array

chr

md5_file

sha1_file

implode

join

explode

get_html_translation_table

localeconv

number_format

hash

echos

prints

str_replace

str_ireplace

direct_return

undo

redo

concatenate

append

prepend

hashit

shorten

Native PHP Functions

Native PHP functions are class methods that did not require any additional coding and can be used just like their native PHP function counterpart. Here is a list of all the native PHP functions that are supported in this class.