system, _wsystem
Exécute une commande.
Important
Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.
int system(
const char *command
);
int _wsystem(
const wchar_t *command
);
Paramètres
- command
Commande à exécuter.
Valeur de retour
Si command est NULL et l'interpréteur de commandes est trouvé, retourne une valeur différente de zéro.Si l'interpréteur de commandes est introuvable, retourne 0 et définit errno à ENOENT.Si command n'est pas NULL, system retourne la valeur retournée par l'interpréteur de commandes.Elle retourne la valeur 0 uniquement si l'interpréteur de commandes retourne la valeur 0.Une valeur de retour à 1 indique une erreur, et errno a une des valeurs suivantes :
E2BIG
La liste d'arguments (qui est dépendant système) est trop grande.ENOENT
L'interpréteur de commandes est introuvable.ENOEXEC
Le fichier de l'interpréteur de commandes ne peut pas être exécuté car le format est pas valide.ENOMEM
Mémoire insuffisante est disponible pour exécuter la commande ; ou de la mémoire a été endommagé ; ou un bloc non valide existe, ce qui indique que le processus qui effectue l'appel n'a pas été alloué correctement.
Consultez l' _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ces codes de retour.
Notes
La fonction d' system passe command à l'interpréteur de commandes, qui exécute la chaîne comme commande du système d'exploitation.system utilise les variables d'environnement de COMSPEC et d' PATH pour localiser le fichier CMD.exe de l'interpréteur de commandes.Si command est NULL, la fonction vérifie uniquement si l'interpréteur de commandes existe.
Vous devez explicitement vidage- par utiliser fflush ou _flushall(ou fermer tout flux avant d'appeler system.
_wsystem est une version à caractère élargi d' system; l'argument d' command à _wsystem est une chaîne à caractères larges.Ces fonctions se comportent de sinon.
Mappages de routines de texte générique
Routine de TCHAR.H |
_UNICODE et non définis _MBCS |
_MBCS défini |
_UNICODE défini |
|---|---|---|---|
_tsystem |
system |
system |
_wsystem |
Configuration requise
Routine |
En-tête requis |
|---|---|
system |
<process.h> ou <stdlib.h> |
_wsystem |
<process.h> ou <stdlib.h> ou <wchar.h> |
Pour des informations de compatibilité supplémentaires, consultez Compatibilité.
Exemple
Cet exemple utilise system POUR TAPER un fichier texte.
// crt_system.c
#include <process.h>
int main( void )
{
system( "type crt_system.txt" );
}
Entrée : crt_system.txt
Line one.
Line two.
.gif "277bwbdz.collapse_all(fr-fr,VS.110).gif")
Sortie
Line one.
Line two.