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

The byfill() function fills a specified area with one character.

void byfill(to,  length,  ch)

	char  *to;

	mint  length;

	char  ch;

 



to

is a pointer to the first byte of the memory area that you want byfill() to fill. 


length  

is the number of times that you want byfill() to repeat the character within the area.


ch

is the character that you want byfill() to use to fill the area.








Important: Take care not to overwrite areas of memory adjacent to the area that you want byfill() to fill. 

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

/*
* byfill.ec *

The following program shows the results of three byfill() operations on an
area that is initialized to x's.
*/

#include <stdio.h>

main()
{
static char area[20] = "xxxxxxxxxxxxxxxxxxx";

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

printf("String = %s\n", area);

printf("\nFilling string with five 's' characters:\n");
byfill(area, 5, 's');
printf("Result = %s\n", area);

printf("\nFilling string with two 's' characters starting at ");
printf("position 16:\n");
byfill(&area[16], 2, 's');
printf("Result = %s\n", area);

printf("Filling entire string with 'b' characters:\n");
byfill(area, sizeof(area)-1, 'b');
printf("Result = %s\n", area);

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

BYFILL Sample ESQL Program running.

String = xxxxxxxxxxxxxxxxxxx

Filling string with five 's' characters:
Result = sssssxxxxxxxxxxxxxx

Filling string with two 's' characters starting at position 16:
Result = sssssxxxxxxxxxxxssx

Filling entire string with 'b' characters:
Result = bbbbbbbbbbbbbbbbbbb

BYFILL Sample Program over.