DataBlade API Programmer's Manual Chapter 12: DataBlade API Function Descriptions

Home

Contents

Index

Master Index

New Book

char *mi_file_to_file(conn, fromfile, fromflags, tofile, toflags)

		MI_CONNECTION *conn;

		const char *fromfile;

		mi_integer fromflags;

		const char *tofile;

		mi_integer toflags ; 


conn
is the connection descriptor established by a previous call to mi_open() or mi_server_connect().

fromfile
is the full pathname of the source file.

fromflags
is a bitmask argument indicating how to open the source file. Its value must include either MI_O_CLIENT_FILE or MI_O_SERVER_FILE, but not both. Possible values for fromflags follow:


MI_O_EXCL
Raise an exception if there is already a file by that name.


MI_O_TRUNC
Truncate the file if there.


MI_O_APPEND
Append to the file.


MI_O_RDWR
Read/Write.


MI_O_RDONLY
Read-only.


MI_O_TEXT
Text mode.


MI_O_SERVER_FILE
Server file.


MI_O_CLIENT_FILE
Client file.

tofile
is the full pathname of the destination file.

toflags
is a bitmask argument indicating how to open the destination file. Possible values for toflags follow:


MI_O_EXCL
Raise an exception if there is already a file by that name.


MI_O_TRUNC
Truncate the file if it exists.


MI_O_APPEND
Append to the file.


MI_O_RDWR
Read/Write.


MI_O_WRONLY
Write-only.


MI_O_BINARY
Data is binary.


MI_O_TEXT
Text mode.


MI_O_SERVER_FILE
Server file.


MI_O_CLIENT_FILE
Client file.


The default values are MI_O_CLIENT_FILE, MI_O_WRONLY, and MI_O_TRUNC.





 



Valid in Client Application?

Valid in Server Routine?

No
Yes