61 lines
1.3 KiB
Plaintext
61 lines
1.3 KiB
Plaintext
P7_REQUEST(3)
|
|
=============
|
|
Thomas "Cakeisalie5" Touhey
|
|
:Email: thomas@touhey.fr
|
|
:man source: libp7
|
|
:man manual: libp7 manual
|
|
|
|
NAME
|
|
----
|
|
p7_request, p7_reqfile - request a file from the calculator
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[source,c]
|
|
----
|
|
#include <libp7.h>
|
|
|
|
int p7_request(p7_handle_t *handle, p7_buffer_t *buffer,
|
|
const char *dirname, const char *filename, const char *devname,
|
|
void (*disp)());
|
|
int p7_reqfile(p7_handle_t *handle, FILE *file,
|
|
const char *dirname, const char *filename, const char *devname,
|
|
void (*disp)());
|
|
|
|
FILE *fp = fopen("myaddin.g1a", "w");
|
|
p7_reqfile(handle, fp, NULL, "myaddin.g1a", "fls0", NULL);
|
|
----
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
These functions request a file from the calculator, and writes its content
|
|
into the given buffer. *p7_request* uses the libp7 buffer interface, see
|
|
*p7_buffer*(3) to read more about it.
|
|
|
|
If directory name is NULL, file will be read at root.
|
|
|
|
The *disp* parameter is only there if you want to display a loading bar. It
|
|
should have this prototype:
|
|
|
|
[source,c]
|
|
----
|
|
void my_display(p7ushort_t id, p7ushort_t total);
|
|
----
|
|
|
|
If it is non-null, it is first called with *id* > *total* to initialize display.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
This function returns zero if everything went well, and the error code
|
|
otherwise.
|
|
|
|
ERRORS
|
|
------
|
|
See *p7_error*(3).
|
|
|
|
SEE ALSO
|
|
--------
|
|
*libp7*(3),
|
|
*p7_sendfile*(3),
|
|
*p7_error*(3)
|