##############################################################################
###+-------+##################################################################
#+-| LEN() |-------------------------------------+############################
#| +-------+ Returns the length of source_string |############################
#+-----------------------------------------------+############################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------------+#############################
#|     FUNCTION UINT len PROTOTYPE              |#############################
#|      PARAMETERS CONST CHAR source_string     |#############################
#+----------------------------------------------+#############################
##############################################################################
##############################################################################
##########+---| Description |---------------------------------------+#########
##########| The len() function returns the length of source_string. |#########
##########| The length of a string is determined by the position of |#########
##########| the NULL character in the string versus the declared    |#########
##########| size of the string.                                     |#########
##########+---------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Len() returns the length of the current             |#########
#########| *    value of a string, not its declared value.          |#########
#########|                                                          |#########
#########| VARDEF                                                   |#########
#########|     CHAR(90)    really_long_string                       |#########
#########| ENDDEF                                                   |#########
#########|                                                          |#########
#########|     really_long_string = "this"                          |#########
#########|     ? len( really_long_string )   && prints 4            |#########
#########|                                                          |#########
#########| *--- Examples                                            |#########
#########|                                                          |#########
#########| ? len("Melanie Neale")            && Prints 13           |#########
#########| ? len("")                         && Prints 0            |#########
#########| ? len(space(40))                  && Prints 40           |#########
#########+----------------------------------------------------------+#########
##############################################################################