CHAR LTRIM()

From Recital Documentation Wiki
Jump to: navigation, search

PURPOSE

Remove leading blank spaces from a string


SYNONYM

api_char_ltrim()


SYNOPSIS

#include "dbapi.h"
 
char	CHAR_LTRIM(string,)
 
<input parameters>
char	*string;		/* Address of a buffer containing character string	*/
 
<output parameters>
none


DESCRIPTION

The CHAR_LTRIM() function removes leading blank spaces from the specified character string.


EXAMPLE

The following example trims all leading blank spaces from the first parameter passed..

#include "dbapi.h"
 
dbapi_char_ltrim()
{
    char	string[1025]
 
    if ( _parinfo(1) == API_CTYPE)  {
       strcpy(string, CHAR_LTRIM( _parc(1) ) );
    } else {
       strcpy(string,"");
    }
 
    _retc( string );
}


SEE ALSO

_parc(), _parclen(), _parcsiz(), _parinfo(), _retc(), _retclen(), ISCHAR(), CHAR_ALLTRIM(), CHAR_LOWER(), CHAR_LPAD(), CHAR_RPAD(), CHAR_RTRIM(), CHAR_STR(), CHAR_UPPER(), DATE_STOD()