INFORMIX-ESQL/C Programmer's Manual ESQL/C Function Library

The stchar() function stores a null-terminated string in a fixed-length string, padding the end with blanks, if necessary.

void stchar(from,  to,  count)

	char  *from;

	char  *to;

	mint  count;

 



from

is a pointer to the first byte of a null-terminated source string. 


to

is a pointer to the fixed-length destination string. This argument can point to a location that overlaps the location to which the from argument points. In this case, ESQL/C discards the value to which from points. 


count  

is the number of bytes in the fixed-length destination string. 

This sample program is in the stchar.ec file in the demo directory.

/*
* stchar.ec *

The following program shows the blank padded result produced by
stchar() function.
*/

#include <stdio.h>

main()
{
static char src[] = "start";
static char dst[25] = "123abcdefghijkl;.";

printf("STCHAR Sample ESQL Program running.\n\n");

printf("Source string: [%s]\n", src);
printf("Destination string before stchar: [%s]\n", dst);

stchar(src, dst, sizeof(dst) - 1);

printf("Destination string after stchar: [%s]\n", dst);

printf("\nSTCHAR Sample Program over.\n\n");
}

STCHAR Sample ESQL Program running.

Source string: [start]
Destination string before stchar: [123abcdefghijkl;.]
Destination string after stchar: [start ]

STCHAR Sample Program over.