strljust
Previous Topic  Next Topic 

Synopsis:

       new_string=strljust(str,char, tot_chars)


Arguments:

       str - The string to pad with char at the end

       char - The character to insert at the end of the string

       tot_chars - How big the string should be after padding


Description:   This function left justifies the given string to the length specified by tot_chars by padding the end of the string, str, with char.     If the string, str, already contains the same or more characters that specified in tot_chars then the sting str will be returned unchanged.


For example:


       // This will return "ABC   "

       new_str=strljust("ABC"," ",6);


       // This will return "ABC***"

       new_str=strljust("ABC","*",6);


       // This will return ABCDEF

       new_str=strljust("ABCDEF","*",6);


Returns:  Returns the given string left justified with with the character char up to the number of characters specified by tot_chars