Ticket #5897 (closed Feature Requests: fixed)

Opened 4 years ago

Last modified 5 weeks ago

Make path relative function.

Reported by: jmckesson@… Owned by: bemandawes
Milestone: Boost 1.60.0 Component: filesystem
Version: Boost 1.47.0 Severity: Problem
Keywords: Cc:


It is often useful to take a path that is absolute and make it relative to some other path. For example, if you're copying from directory A to directory B using a recursive_directory_iterator, it is often the case that you will do the following:

for_each(bfs::recursive_directory_iterator(directoryA), bfs::recursive_directory_iterator(), [=](const bfs::directory_entry &entry)
    bfs::path dstPath = directoryB / make_relative(directoryA, entry.path());
    bfs::copy_file(entry.path(), dstPath);

The make_relative function would iterate through the path components of the two arguments, removing entries until it found different ones. Then, it would add ".." to the beginning of the second path argument, until it ran out of directories in the first path. What you are left with is the second path relative to the first one.

Obviously, this would not work if both paths are absolute. But this is such a common operation that there has to be some way to make it work.


Change History

comment:1 Changed 4 years ago by anonymous

Great idea! I was looking for that exact function just today.

comment:2 Changed 4 years ago by anonymous

I've added an example for 1.46.1 ( probably works for trunk as well, haven't tried ). For details take a look at .

comment:3 Changed 2 years ago by anonymous

Please consider this feature, it is required rather often -

comment:4 Changed 2 years ago by anonymous

This would be really helpful, I'd consider it one of the basic functions you want to do with paths.

comment:5 Changed 11 months ago by slowriot <riot@…>

+1 for this.

comment:6 Changed 11 months ago by mojes@…

+1 for this

comment:7 Changed 10 months ago by fhntv24fhntv24@…

+1 for this.

comment:8 Changed 8 months ago by londinop@…

+1 for this.

comment:9 Changed 7 months ago by anonymous


comment:10 Changed 7 months ago by anonymous


comment:11 Changed 5 months ago by jarruda

Could a contributor at least comment on this? This at least seems like a "must-have" feature for any utility file system API. 4 years is a pretty long time for a simple feature request to not be acknowledged.

comment:12 Changed 5 months ago by anonymous

Have you not seen the other 2692 active tickets they're equally busy ignoring? ;)

comment:13 Changed 5 weeks ago by bemandawes

  • Status changed from new to closed
  • Resolution set to fixed
  • Milestone changed from To Be Determined to Boost 1.60.0

Boost 1.60.0 will add functions lexically_normal, lexically_relative, relative, and weakly_canonical. These are designed to provide the functionality requested by this ticket.

See for more information. It proposes additional lexical and operational proximate functions, but I have chosen not to include those now. They will be reconsidered once users get some field experience with the core functionality for computing relative paths.

These function are available now on the develop branch, and will be merged to master as soon as sufficient regression tests have cycled. They will also be proposed for inclusion in the next version of the C++ committee's TS 18822, File System Technical Specification.

Many thanks to Jamie Allsop for his help and perseverance, and to everyone else who made suggestions and comments. Jamie's paper is available at




Add a comment

Modify Ticket

Change Properties
<Author field>
as closed
The resolution will be deleted. Next status will be 'reopened'

E-mail address and user name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.