3.8.2/doc/cmake/html/command/create_test_sourcelist.html - platform/prebuilts/cmake/darwin-x86 - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


 <html xmlns="http://www.w3.org/1999/xhtml">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

   <title>create_test_sourcelist &mdash; CMake 3.8.2 Documentation</title>


     <link rel="stylesheet" href="../_static/cmake.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />

     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
         VERSION:     '3.8.2',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true,
         SOURCELINK_SUFFIX: '.txt'
       };
     </script>
     <script type="text/javascript" src="../_static/jquery.js"></script>
     <script type="text/javascript" src="../_static/underscore.js"></script>
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <link rel="shortcut icon" href="../_static/cmake-favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
     <link rel="next" title="define_property" href="define_property.html" />
     <link rel="prev" title="continue" href="continue.html" />
   </head>
   <body role="document">
     <div class="related" role="navigation" aria-label="related navigation">
       <h3>Navigation</h3>
       <ul>
         <li class="right" style="margin-right: 10px">
           <a href="../genindex.html" title="General Index"
              accesskey="I">index</a></li>
         <li class="right" >
           <a href="define_property.html" title="define_property"
              accesskey="N">next</a> |</li>
         <li class="right" >
           <a href="continue.html" title="continue"
              accesskey="P">previous</a> |</li>
   <li>
     <img src="../_static/cmake-logo-16.png" alt=""
          style="vertical-align: middle; margin-top: -2px" />
   </li>
   <li>
     <a href="https://cmake.org/">CMake</a> &#187;
   </li>
   <li>
     <a href="../index.html">3.8.2 Documentation</a> &#187;
   </li>

           <li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" accesskey="U">cmake-commands(7)</a> &#187;</li>
       </ul>
     </div>

     <div class="document">
       <div class="documentwrapper">
         <div class="bodywrapper">
           <div class="body" role="main">

   <div class="section" id="create-test-sourcelist">
 <span id="command:create_test_sourcelist"></span><h1>create_test_sourcelist<a class="headerlink" href="#create-test-sourcelist" title="Permalink to this headline">¶</a></h1>
 <p>Create a test driver and source list for building test programs.</p>
 <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">create_test_sourcelist</span><span class="p">(</span><span class="n">sourceListName</span> <span class="n">driverName</span>
                        <span class="n">test1</span> <span class="n">test2</span> <span class="n">test3</span>
                        <span class="n">EXTRA_INCLUDE</span> <span class="n">include</span><span class="o">.</span><span class="n">h</span>
                        <span class="n">FUNCTION</span> <span class="n">function</span><span class="p">)</span>
 </pre></div>
 </div>
 <p>A test driver is a program that links together many small tests into a
 single executable.  This is useful when building static executables
 with large libraries to shrink the total required size.  The list of
 source files needed to build the test driver will be in
 <code class="docutils literal"><span class="pre">sourceListName</span></code>.  <code class="docutils literal"><span class="pre">driverName</span></code> is the name of the test driver program.
 The rest of the arguments consist of a list of test source files, can
 be semicolon separated.  Each test source file should have a function
 in it that is the same name as the file with no extension (foo.cxx
 should have int foo(int, char*[]);) <code class="docutils literal"><span class="pre">driverName</span></code> will be able to call
 each of the tests by name on the command line.  If <code class="docutils literal"><span class="pre">EXTRA_INCLUDE</span></code> is
 specified, then the next argument is included into the generated file.
 If <code class="docutils literal"><span class="pre">FUNCTION</span></code> is specified, then the next argument is taken as a
 function name that is passed a pointer to ac and av.  This can be used
 to add extra command line processing to each test.  The
 <code class="docutils literal"><span class="pre">CMAKE_TESTDRIVER_BEFORE_TESTMAIN</span></code> cmake variable can be set to
 have code that will be placed directly before calling the test main function.
 <code class="docutils literal"><span class="pre">CMAKE_TESTDRIVER_AFTER_TESTMAIN</span></code> can be set to have code that
 will be placed directly after the call to the test main function.</p>
 </div>


           </div>
         </div>
       </div>
       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
         <div class="sphinxsidebarwrapper">
   <h4>Previous topic</h4>
   <p class="topless"><a href="continue.html"
                         title="previous chapter">continue</a></p>
   <h4>Next topic</h4>
   <p class="topless"><a href="define_property.html"
                         title="next chapter">define_property</a></p>
   <div role="note" aria-label="source link">
     <h3>This Page</h3>
     <ul class="this-page-menu">
       <li><a href="../_sources/command/create_test_sourcelist.rst.txt"
             rel="nofollow">Show Source</a></li>
     </ul>
    </div>
 <div id="searchbox" style="display: none" role="search">
   <h3>Quick search</h3>
     <form class="search" action="../search.html" method="get">
       <div><input type="text" name="q" /></div>
       <div><input type="submit" value="Go" /></div>
       <input type="hidden" name="check_keywords" value="yes" />
       <input type="hidden" name="area" value="default" />
     </form>
 </div>
 <script type="text/javascript">$('#searchbox').show(0);</script>
         </div>
       </div>
       <div class="clearer"></div>
     </div>
     <div class="related" role="navigation" aria-label="related navigation">
       <h3>Navigation</h3>
       <ul>
         <li class="right" style="margin-right: 10px">
           <a href="../genindex.html" title="General Index"
              >index</a></li>
         <li class="right" >
           <a href="define_property.html" title="define_property"
              >next</a> |</li>
         <li class="right" >
           <a href="continue.html" title="continue"
              >previous</a> |</li>
   <li>
     <img src="../_static/cmake-logo-16.png" alt=""
          style="vertical-align: middle; margin-top: -2px" />
   </li>
   <li>
     <a href="https://cmake.org/">CMake</a> &#187;
   </li>
   <li>
     <a href="../index.html">3.8.2 Documentation</a> &#187;
   </li>

           <li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> &#187;</li>
       </ul>
     </div>
     <div class="footer" role="contentinfo">
         &#169; Copyright 2000-2017 Kitware, Inc. and Contributors.
       Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.2.
     </div>
   </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


	<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

	<title>create_test_sourcelist — CMake 3.8.2 Documentation</title>


	<link rel="stylesheet" href="../_static/cmake.css" type="text/css" />
	<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />

	<script type="text/javascript">
	var DOCUMENTATION_OPTIONS = {
	URL_ROOT: '../',
	VERSION: '3.8.2',
	COLLAPSE_INDEX: false,
	FILE_SUFFIX: '.html',
	HAS_SOURCE: true,
	SOURCELINK_SUFFIX: '.txt'
	};
	</script>
	<script type="text/javascript" src="../_static/jquery.js"></script>
	<script type="text/javascript" src="../_static/underscore.js"></script>
	<script type="text/javascript" src="../_static/doctools.js"></script>
	<link rel="shortcut icon" href="../_static/cmake-favicon.ico"/>
	<link rel="index" title="Index" href="../genindex.html" />
	<link rel="search" title="Search" href="../search.html" />
	<link rel="next" title="define_property" href="define_property.html" />
	<link rel="prev" title="continue" href="continue.html" />
	</head>
	<body role="document">
	<div class="related" role="navigation" aria-label="related navigation">
	<h3>Navigation</h3>
	<ul>
	<li class="right" style="margin-right: 10px">
	<a href="../genindex.html" title="General Index"
	accesskey="I">index</a></li>
	<li class="right" >
	<a href="define_property.html" title="define_property"
	accesskey="N">next</a> \|</li>
	<li class="right" >
	<a href="continue.html" title="continue"
	accesskey="P">previous</a> \|</li>
	<li>
	<img src="../_static/cmake-logo-16.png" alt=""
	style="vertical-align: middle; margin-top: -2px" />
	</li>
	<li>
	<a href="https://cmake.org/">CMake</a> »
	</li>
	<li>
	<a href="../index.html">3.8.2 Documentation</a> »
	</li>

	<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" accesskey="U">cmake-commands(7)</a> »</li>
	</ul>
	</div>

	<div class="document">
	<div class="documentwrapper">
	<div class="bodywrapper">
	<div class="body" role="main">

	<div class="section" id="create-test-sourcelist">
	<span id="command:create_test_sourcelist"></span><h1>create_test_sourcelist<a class="headerlink" href="#create-test-sourcelist" title="Permalink to this headline">¶</a></h1>
	<p>Create a test driver and source list for building test programs.</p>
	<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">create_test_sourcelist</span><span class="p">(</span><span class="n">sourceListName</span> <span class="n">driverName</span>
	<span class="n">test1</span> <span class="n">test2</span> <span class="n">test3</span>
	<span class="n">EXTRA_INCLUDE</span> <span class="n">include</span><span class="o">.</span><span class="n">h</span>
	<span class="n">FUNCTION</span> <span class="n">function</span><span class="p">)</span>
	</pre></div>
	</div>
	<p>A test driver is a program that links together many small tests into a
	single executable. This is useful when building static executables
	with large libraries to shrink the total required size. The list of
	source files needed to build the test driver will be in
	<code class="docutils literal"><span class="pre">sourceListName</span></code>. <code class="docutils literal"><span class="pre">driverName</span></code> is the name of the test driver program.
	The rest of the arguments consist of a list of test source files, can
	be semicolon separated. Each test source file should have a function
	in it that is the same name as the file with no extension (foo.cxx
	should have int foo(int, char*[]);) <code class="docutils literal"><span class="pre">driverName</span></code> will be able to call
	each of the tests by name on the command line. If <code class="docutils literal"><span class="pre">EXTRA_INCLUDE</span></code> is
	specified, then the next argument is included into the generated file.
	If <code class="docutils literal"><span class="pre">FUNCTION</span></code> is specified, then the next argument is taken as a
	function name that is passed a pointer to ac and av. This can be used
	to add extra command line processing to each test. The
	<code class="docutils literal"><span class="pre">CMAKE_TESTDRIVER_BEFORE_TESTMAIN</span></code> cmake variable can be set to
	have code that will be placed directly before calling the test main function.
	<code class="docutils literal"><span class="pre">CMAKE_TESTDRIVER_AFTER_TESTMAIN</span></code> can be set to have code that
	will be placed directly after the call to the test main function.</p>
	</div>


	</div>
	</div>
	</div>
	<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
	<div class="sphinxsidebarwrapper">
	<h4>Previous topic</h4>
	<p class="topless"><a href="continue.html"
	title="previous chapter">continue</a></p>
	<h4>Next topic</h4>
	<p class="topless"><a href="define_property.html"
	title="next chapter">define_property</a></p>
	<div role="note" aria-label="source link">
	<h3>This Page</h3>
	<ul class="this-page-menu">
	<li><a href="../_sources/command/create_test_sourcelist.rst.txt"
	rel="nofollow">Show Source</a></li>
	</ul>
	</div>
	<div id="searchbox" style="display: none" role="search">
	<h3>Quick search</h3>
	<form class="search" action="../search.html" method="get">
	<div><input type="text" name="q" /></div>
	<div><input type="submit" value="Go" /></div>
	<input type="hidden" name="check_keywords" value="yes" />
	<input type="hidden" name="area" value="default" />
	</form>
	</div>
	<script type="text/javascript">$('#searchbox').show(0);</script>
	</div>
	</div>
	<div class="clearer"></div>
	</div>
	<div class="related" role="navigation" aria-label="related navigation">
	<h3>Navigation</h3>
	<ul>
	<li class="right" style="margin-right: 10px">
	<a href="../genindex.html" title="General Index"
	>index</a></li>
	<li class="right" >
	<a href="define_property.html" title="define_property"
	>next</a> \|</li>
	<li class="right" >
	<a href="continue.html" title="continue"
	>previous</a> \|</li>
	<li>
	<img src="../_static/cmake-logo-16.png" alt=""
	style="vertical-align: middle; margin-top: -2px" />
	</li>
	<li>
	<a href="https://cmake.org/">CMake</a> »
	</li>
	<li>
	<a href="../index.html">3.8.2 Documentation</a> »
	</li>

	<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> »</li>
	</ul>
	</div>
	<div class="footer" role="contentinfo">
	© Copyright 2000-2017 Kitware, Inc. and Contributors.
	Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.2.
	</div>
	</body>
	</html>