strrjust
Previous Topic  Next Topic 

Synopsis:

       new_string=strrjust(str,char, tot_chars)


Arguments:

       str - The string to pad with char at the beginning

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

       tot_chars - How big the string should be after padding


Description:   This function right justifies the given string to the length specified by tot_chars by padding the beggining 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 "00000023"

       new_str=strrjust("23","0",8);


       // This will return ***ABC

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


       // This will return ABCDEF

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


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