aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/join_paths.yaml
blob: f0cef0c7d36d884964a7c8eb5ad1e78514c5c9be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
name: join_paths
returns: str
since: 0.36.0
description: |
  Joins the given strings into a file system path segment. For example
  `join_paths('foo', 'bar')` results in `foo/bar`. If any one of the
  individual segments is an absolute path, all segments before it are
  dropped. That means that `join_paths('foo', '/bar')` returns `/bar`.

  *(since 0.49.0)* Using the `/` operator on strings is equivalent to calling
  [[join_paths]].

  ```meson
  # res1 and res2 will have identical values
  res1 = join_paths(foo, bar)
  res2 = foo / bar
  ```

warnings:
  - Don't use [[join_paths]] for sources in [[library]] and [[executable]]. You should use [[files]] instead.

varargs:
  name: part
  type: str
  description: The path parts to join.
  min_varargs: 1