[][src]Function libeyelink_sys::eyemsg_printf

pub unsafe extern "C" fn eyemsg_printf(fmt: *const c_char, ...) -> INT16

link message formatting * use just like printf() * returns any send error * This sends a text message to the EyeLink tracker, which timestamps it and writes it to the EDF data file. Messages are useful for recording trial conditions, subject responses, or the time of important events. This function is used with the same formatting methods as printf(), allowing numbers to be included. Avoid end-of-line characters ("\n") at end of messages.

@param fmt Similar to printf(), format string plus arguments. @return \c 0 if successfully sent to tracker, else error code.

\b Example:

\code

#include 
char program_name[100] = "Windows Sample Experiment 2.0";

eyemsg_printf("RECORDED BY %s", program_name);
\endcode

\b Output:

\code
MSG	2248248 RECORDED BY Windows Sample Experiment 2.0
\endcode

\sa \c eyecmd_printf()