nl_tokens: Used when composing a function that needs to operate on the first character found and needs to return the original string with the modified character within it .
pl_tokens: function changeCaseOfFirstChar ( str , func , thisFuncsName ) { var search , char , right , <mask> ; // If typeof `str` is not of type "String" then bail throwTypeErrorIfNotOfType ( thisFuncsName , 'str' , str , _String ) ; // Search for first alpha char search = str . search ( / [a-z] / i ) ; // If alpha char if ( isNumber ( search ) && search > - 1 ) { // Make it lower case char = str . substr ( search , 1 ) [ func ] ( ) ; // Get string from `char`'s index right = str . substr ( search + 1 , str . length - 1 ) ; // Get string upto `char`'s index left = search !== 0 ? str . substr ( 0 , search ) : '' ; // Concatenate original string with lower case char in it str = left + char + right ; } return str ; }