cmakeConfigurer le fichier


Introduction

configure_file est une fonction CMake permettant de copier un fichier vers un autre emplacement et de modifier son contenu. Cette fonction est très utile pour générer des fichiers de configuration avec des chemins, des variables personnalisées, en utilisant un modèle générique.

Remarques

Copiez un fichier vers un autre emplacement et modifiez son contenu.

configure_file(<input> <output>
           [COPYONLY] [ESCAPE_QUOTES] [@ONLY]
           [NEWLINE_STYLE [UNIX|DOS|WIN32|LF|CRLF] ])

Copie un fichier pour classer et remplacer les valeurs de variable référencées dans le contenu du fichier. Si est un chemin relatif, il est évalué par rapport au répertoire source actuel. Le doit être un fichier, pas un répertoire. Si est un chemin relatif, il est évalué par rapport au répertoire binaire actuel. Si nomme un répertoire existant, le fichier d'entrée est placé dans ce répertoire avec son nom d'origine.

Si le fichier est modifié, le système de génération réexécutera CMake pour reconfigurer le fichier et générer à nouveau le système de génération.

Cette commande remplace toutes les variables du fichier d'entrée référencées $ {VAR} ou @ VAR @ par leurs valeurs déterminées par CMake. Si une variable n'est pas définie, elle sera remplacée par rien. Si COPYONLY est spécifié, aucune expansion de variable n'aura lieu. Si ESCAPE_QUOTES est spécifié, toutes les citations substituées seront échappées avec le style C. Le fichier sera configuré avec les valeurs actuelles des variables CMake. Si @ONLY est spécifié, seules les variables de la forme @ VAR @ seront remplacées et $ {VAR} sera ignoré. Ceci est utile pour configurer des scripts qui utilisent $ {VAR}.

Les lignes de fichier d'entrée de la forme "#cmakedefine VAR ..." seront remplacées par "#define VAR ..." ou / * #undef VAR * / selon que VAR est défini dans CMake à une valeur non considérée comme fausse constante par la commande if (). (Le contenu de "...", le cas échéant, est traité comme ci-dessus.) Les lignes de fichier d'entrée de la forme "# cmakedefine01 VAR" seront remplacées de manière similaire par "#define VAR 1" ou "#define VAR 0".

Avec NEWLINE_STYLE, la fin de ligne peut être ajustée:

'UNIX' or 'LF' for \n, 'DOS', 'WIN32' or 'CRLF' for \r\n.

COPYONLY ne doit pas être utilisé avec NEWLINE_STYLE.

Configurer le fichier Exemples Liés