system Function

Execute a command.

Attention: This function is not implemented by MPLAB XC8 C compilers.

Include

<stdlib.h>

Prototype

int system(const char * string);

Argument

string
command to be executed

Default Behavior

C STD: If string is a null pointer, the system function determines whether the host environment has a command processor. If string is not a null pointer, the system function passes the string pointed to by string to that command processor to be executed in a manner which the implementation shall document; this might then cause the program calling system to behave in a non-conforming manner or to terminate.

PREVIOUSLY: As distributed, this function acts as a stub or placeholder for your function. If string is not NULL, an error message is written to stdout and the program will reset; otherwise, a value of -1 is returned.