Partager via


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.

277bwbdz.collapse_all(fr-fr,VS.110).gifSortie

Line one.
Line two.

Équivalent .NET Framework

Voir aussi

Référence

Processus et contrôle ambiance

_exec, fonctions de _wexec

exit, _exit

_flushall

_spawn, fonctions de _wspawn