From b6cede2928e80d6bd0512c82ad6787c03faae1e6 Mon Sep 17 00:00:00 2001 From: Xavier Claessens Date: Thu, 6 Dec 2018 15:03:46 -0500 Subject: find_library: Add 'has_headers' kwarg A library without its headers is often useless, so it is common to check them together. --- docs/markdown/snippets/find_library_header.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/markdown/snippets/find_library_header.md (limited to 'docs/markdown/snippets') diff --git a/docs/markdown/snippets/find_library_header.md b/docs/markdown/snippets/find_library_header.md new file mode 100644 index 0000000..55597ab --- /dev/null +++ b/docs/markdown/snippets/find_library_header.md @@ -0,0 +1,21 @@ +## Find library with its headers + +The `find_library()` method can now also verify if the library's headers are +found in a single call, using the `has_header()` method internally. + +```meson +# Aborts if the 'z' library is found but not its header file +zlib = find_library('z', has_headers : 'zlib.h') +# Returns not-found if the 'z' library is found but not its header file +zlib = find_library('z', has_headers : 'zlib.h', required : false) +``` + +Any keyword argument with the `header_` prefix passed to `find_library()` will +be passed to the `has_header()` method with the prefix removed. + +```meson +libfoo = find_library('foo', + has_headers : ['foo.h', 'bar.h'], + header_prefix : '#include ', + header_include_directories : include_directories('.')) +``` -- cgit v1.1