compiler_cxx

Try to detect a C++ compiler from the list of supported compilers (g++, msvc, etc):

def options(opt):
        opt.load('compiler_cxx')
def configure(cnf):
        cnf.load('compiler_cxx')
def build(bld):
        bld.program(source='main.cpp', target='app')

The compilers are associated to platforms in waflib.Tools.compiler_cxx.cxx_compiler. To register a new C++ compiler named cfoo (assuming the tool waflib/extras/cfoo.py exists), use:

from waflib.Tools.compiler_cxx import cxx_compiler
cxx_compiler['win32'] = ['cfoo', 'msvc', 'gcc']

def options(opt):
        opt.load('compiler_cxx')
def configure(cnf):
        cnf.load('compiler_cxx')
def build(bld):
        bld.program(source='main.c', target='app')

Not all compilers need to have a specific tool. For example, the clang compilers can be detected by the gcc tools when using:

$ CXX=clang waf configure

waflib.Tools.compiler_cxx.debug(*k, **kw)

Wraps logging.debug and discards messages if the verbosity level waflib.Logs.verbose ≤ 0

waflib.Tools.compiler_cxx.cxx_compiler = {'aix': ['xlc++', 'g++', 'clang++'], 'cygwin': ['g++', 'clang++'], 'darwin': ['clang++', 'g++'], 'default': ['clang++', 'g++'], 'gnu': ['g++', 'clang++'], 'gnukfreebsd': ['g++', 'clang++'], 'hpux': ['g++'], 'irix': ['g++'], 'java': ['g++', 'msvc', 'clang++', 'icpc'], 'linux': ['g++', 'clang++', 'icpc'], 'osf1V': ['g++'], 'sunos': ['sunc++', 'g++'], 'win32': ['msvc', 'g++', 'clang++']}

Dict mapping the platform names to Waf tools finding specific C++ compilers:

from waflib.Tools.compiler_cxx import cxx_compiler
cxx_compiler['linux'] = ['gxx', 'icpc', 'suncxx']

waflib.Tools.compiler_cxx.configure(conf)

Detects a suitable C++ compiler

Raises

waflib.Errors.ConfigurationError when no suitable compiler is found

waflib.Tools.compiler_cxx.options(opt)

This is how to provide compiler preferences on the command-line:

$ waf configure --check-cxx-compiler=gxx