Voice Software Reference: Programmer's Guide: dx

dx_filewrite( )

Description | Cautions | Example | Errors | See Also

Name:

int dx_filewrite(handle, buffer, count)

Inputs:

int handle

handle returned from dx_fileopen( )

void *buffer

data to be written

unsigned int count

number of bytes

Returns:

number of bytes if success

-1 if failure

Category:

File Management

Description

The dx_filewrite( ) function writes data from a buffer into a file associated with file handle. The write operation begins at the current position of the file pointer (if any) associated with the given file. If the file was opened for appending, the operation begins at the current end of the file. After the write operation, the file pointer is increased by the number of bytes actually written. See the _write function in the Microsoft Visual C++ Run-Time Library Reference for more information.

Cautions

Use dx_filewrite( ) instead of _write to ensure the compatibility of applications with the libraries across various versions of Visual C++.

Example

#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
int cd;                 /* channel descriptor */  
DX_UIO myio;            /* user definable I/O structure */  
/*  
 * User defined I/O functions  
 */  
int my_read(fd,ptr,cnt)  
int fd;  
char * ptr;  
unsigned cnt;  
{  
   printf("My read\n");  
   return(dx_fileread(fd,ptr,cnt));  
}  
/*  
 * my write function  
 */  
int my_write(fd,ptr,cnt)  
int fd;  
char * ptr;  
unsigned cnt;  
{  
printf("My write \n");  
   return(dx_filewrite(fd,ptr,cnt));  
}  
/*  
 * my seek function  
 */  
long my_seek(fd,offset,whence)  
int fd;  
long offset;  
int whence;  
{  
   printf("My seek\n");  
   return(dx_fileseek(fd,offset,whence));  
}  
void main(argc,argv)  
int argc;  
char *argv[];  
{  
   .  
   . /* Other initialization */  
   .  
   DX_UIO uioblk;  
/* Initialize the UIO structure */  
uioblk.u_read=my_read;  
uioblk.u_write=my_write;  
uioblk.u_seek=my_seek;  
/* Install my I/O routines */  
dx_setuio(uioblk);  
vodat_fd = dx_fileopen("JUNK.VOX",O_RDWR|O_BINARY);  
/*This block uses standard I/O functions */  
iott->io_type = IO_DEV|IO_CONT  
iott->io_fhandle = vodat_fd;  
iott->io_offset = 0;  
iott->io_length = 20000;  
/*This block uses my I/O functions */  
iottp++;  
iottp->io_type = IO_DEV|IO_UIO|IO_CONT  
iottp->io_fhandle = vodat_fd;  
iott->io_offset = 20001;  
iott->io_length = 20000;  
/*This block uses standard I/O functions */  
iottp++  
iott->io_type = IO_DEV|IO_CONT  
iott->io_fhandle = vodat_fd;  
iott->io_offset = 20002;  
iott->io_length = 20000;  
/*This block uses my I/O functions */  
iott->io_type = IO_DEV|IO_UIO|IO_EOT  
iott->io_fhandle = vodat_fd;  
iott->io_offset = 10003;  
iott->io_length = 20000;  
devhandle = dx_open("dxxxB1C1", NULL);  
dx_sethook(devhandle, DX-ONHOOK,EV_SYNC)  
dx_wtring(devhandle,1,DX_OFFHOOK,EV_SYNC);  
dx_clrdigbuf;  
   if(dx_rec(devhandle,iott,(DX_TPT*)NULL,RM_TONE|EV_SYNC) == -1) {  
  perror("");  
  exit(1);  
}  
dx_clrdigbuf(devhandle);  
   if(dx_play(devhandle,iott,(DX_TPT*)EV_SYNC) == -1 {  
   perror("");  
   exit(1);  
   }  
   dx_close(devhandle);

Errors

If this function returns -1 to indicate failure, a system error has occurred; use dx_fileerrno( ) to obtain the system error value. Refer to the dx_fileerrno( ) function for a list of the possible system error values.

Name:	int dx_filewrite(handle, buffer, count)
Inputs:	int handle	handle returned from dx_fileopen( )
	void *buffer	data to be written
	unsigned int count	number of bytes
Returns:	number of bytes if success
	-1 if failure
Category:	File Management