2016-06-18 03:46:40 +08:00
|
|
|
// -*- C++ -*-
|
|
|
|
//===--------------------------- filesystem -------------------------------===//
|
|
|
|
//
|
2019-01-19 18:56:40 +08:00
|
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
2016-06-18 03:46:40 +08:00
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef _LIBCPP_EXPERIMENTAL_FILESYSTEM
|
|
|
|
#define _LIBCPP_EXPERIMENTAL_FILESYSTEM
|
|
|
|
/*
|
|
|
|
filesystem synopsis
|
|
|
|
|
|
|
|
namespace std { namespace experimental { namespace filesystem { inline namespace v1 {
|
|
|
|
|
|
|
|
class path;
|
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
void swap(path& lhs, path& rhs) noexcept;
|
|
|
|
size_t hash_value(const path& p) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool operator==(const path& lhs, const path& rhs) noexcept;
|
|
|
|
bool operator!=(const path& lhs, const path& rhs) noexcept;
|
|
|
|
bool operator< (const path& lhs, const path& rhs) noexcept;
|
|
|
|
bool operator<=(const path& lhs, const path& rhs) noexcept;
|
|
|
|
bool operator> (const path& lhs, const path& rhs) noexcept;
|
|
|
|
bool operator>=(const path& lhs, const path& rhs) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
path operator/ (const path& lhs, const path& rhs);
|
|
|
|
|
2018-02-04 11:10:53 +08:00
|
|
|
// fs.path.io operators are friends of path.
|
2016-06-18 03:46:40 +08:00
|
|
|
template <class charT, class traits>
|
2018-02-04 11:10:53 +08:00
|
|
|
friend basic_ostream<charT, traits>&
|
2016-06-18 03:46:40 +08:00
|
|
|
operator<<(basic_ostream<charT, traits>& os, const path& p);
|
|
|
|
|
|
|
|
template <class charT, class traits>
|
2018-02-04 11:10:53 +08:00
|
|
|
friend basic_istream<charT, traits>&
|
2016-06-18 03:46:40 +08:00
|
|
|
operator>>(basic_istream<charT, traits>& is, path& p);
|
|
|
|
|
|
|
|
template <class Source>
|
|
|
|
path u8path(const Source& source);
|
|
|
|
template <class InputIterator>
|
|
|
|
path u8path(InputIterator first, InputIterator last);
|
|
|
|
|
|
|
|
class filesystem_error;
|
|
|
|
class directory_entry;
|
|
|
|
|
|
|
|
class directory_iterator;
|
|
|
|
|
|
|
|
// enable directory_iterator range-based for statements
|
|
|
|
directory_iterator begin(directory_iterator iter) noexcept;
|
|
|
|
directory_iterator end(const directory_iterator&) noexcept;
|
|
|
|
|
|
|
|
class recursive_directory_iterator;
|
|
|
|
|
|
|
|
// enable recursive_directory_iterator range-based for statements
|
|
|
|
recursive_directory_iterator begin(recursive_directory_iterator iter) noexcept;
|
|
|
|
recursive_directory_iterator end(const recursive_directory_iterator&) noexcept;
|
|
|
|
|
|
|
|
class file_status;
|
|
|
|
|
|
|
|
struct space_info
|
|
|
|
{
|
|
|
|
uintmax_t capacity;
|
|
|
|
uintmax_t free;
|
|
|
|
uintmax_t available;
|
|
|
|
};
|
|
|
|
|
|
|
|
enum class file_type;
|
|
|
|
enum class perms;
|
2018-03-26 14:23:55 +08:00
|
|
|
enum class perm_options;
|
2016-06-18 03:46:40 +08:00
|
|
|
enum class copy_options;
|
|
|
|
enum class directory_options;
|
|
|
|
|
|
|
|
typedef chrono::time_point<trivial-clock> file_time_type;
|
|
|
|
|
|
|
|
// operational functions
|
|
|
|
|
2018-04-03 07:03:41 +08:00
|
|
|
path absolute(const path& p);
|
|
|
|
path absolute(const path& p, error_code &ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-04-03 07:03:41 +08:00
|
|
|
path canonical(const path& p);
|
2016-06-18 03:46:40 +08:00
|
|
|
path canonical(const path& p, error_code& ec);
|
|
|
|
|
|
|
|
void copy(const path& from, const path& to);
|
2017-10-31 02:59:59 +08:00
|
|
|
void copy(const path& from, const path& to, error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
void copy(const path& from, const path& to, copy_options options);
|
|
|
|
void copy(const path& from, const path& to, copy_options options,
|
2017-10-31 02:59:59 +08:00
|
|
|
error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool copy_file(const path& from, const path& to);
|
2018-02-04 15:35:36 +08:00
|
|
|
bool copy_file(const path& from, const path& to, error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
bool copy_file(const path& from, const path& to, copy_options option);
|
|
|
|
bool copy_file(const path& from, const path& to, copy_options option,
|
2018-02-04 15:35:36 +08:00
|
|
|
error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void copy_symlink(const path& existing_symlink, const path& new_symlink);
|
|
|
|
void copy_symlink(const path& existing_symlink, const path& new_symlink,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool create_directories(const path& p);
|
2018-02-04 15:35:36 +08:00
|
|
|
bool create_directories(const path& p, error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool create_directory(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool create_directory(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool create_directory(const path& p, const path& attributes);
|
|
|
|
bool create_directory(const path& p, const path& attributes,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void create_directory_symlink(const path& to, const path& new_symlink);
|
|
|
|
void create_directory_symlink(const path& to, const path& new_symlink,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void create_hard_link(const path& to, const path& new_hard_link);
|
|
|
|
void create_hard_link(const path& to, const path& new_hard_link,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void create_symlink(const path& to, const path& new_symlink);
|
|
|
|
void create_symlink(const path& to, const path& new_symlink,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
path current_path();
|
|
|
|
path current_path(error_code& ec);
|
|
|
|
void current_path(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
void current_path(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool exists(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool exists(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool exists(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool equivalent(const path& p1, const path& p2);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool equivalent(const path& p1, const path& p2, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
uintmax_t file_size(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
uintmax_t file_size(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
uintmax_t hard_link_count(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
uintmax_t hard_link_count(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_block_file(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_block_file(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_block_file(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_character_file(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_character_file(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_character_file(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_directory(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_directory(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_directory(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
bool is_empty(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_empty(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_fifo(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_fifo(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_fifo(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_other(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_other(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_other(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_regular_file(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_regular_file(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_regular_file(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_socket(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_socket(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_socket(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_symlink(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
bool is_symlink(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool is_symlink(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
file_time_type last_write_time(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
file_time_type last_write_time(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
void last_write_time(const path& p, file_time_type new_time);
|
|
|
|
void last_write_time(const path& p, file_time_type new_time,
|
2018-07-25 11:41:31 +08:00
|
|
|
error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-03-26 14:23:55 +08:00
|
|
|
void permissions(const path& p, perms prms,
|
|
|
|
perm_options opts=perm_options::replace);
|
|
|
|
void permissions(const path& p, perms prms, error_code& ec) noexcept;
|
|
|
|
void permissions(const path& p, perms prms, perm_options opts,
|
|
|
|
error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-04-03 07:03:41 +08:00
|
|
|
path proximate(const path& p, error_code& ec);
|
|
|
|
path proximate(const path& p, const path& base = current_path());
|
|
|
|
path proximate(const path& p, const path& base, error_code &ec);
|
|
|
|
|
2016-06-18 03:46:40 +08:00
|
|
|
path read_symlink(const path& p);
|
|
|
|
path read_symlink(const path& p, error_code& ec);
|
|
|
|
|
2018-04-03 07:03:41 +08:00
|
|
|
path relative(const path& p, error_code& ec);
|
|
|
|
path relative(const path& p, const path& base=current_path());
|
|
|
|
path relative(const path& p, const path& base, error_code& ec);
|
|
|
|
|
2016-06-18 03:46:40 +08:00
|
|
|
bool remove(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
bool remove(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
uintmax_t remove_all(const path& p);
|
2018-02-04 15:35:36 +08:00
|
|
|
uintmax_t remove_all(const path& p, error_code& ec);
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void rename(const path& from, const path& to);
|
2018-07-25 11:41:31 +08:00
|
|
|
void rename(const path& from, const path& to, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
void resize_file(const path& p, uintmax_t size);
|
2018-07-25 11:41:31 +08:00
|
|
|
void resize_file(const path& p, uintmax_t size, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
space_info space(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
space_info space(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
file_status status(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
file_status status(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
bool status_known(file_status s) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
file_status symlink_status(const path& p);
|
2018-07-25 11:41:31 +08:00
|
|
|
file_status symlink_status(const path& p, error_code& ec) noexcept;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
path temp_directory_path();
|
|
|
|
path temp_directory_path(error_code& ec);
|
|
|
|
|
2018-04-03 07:03:41 +08:00
|
|
|
path weakly_canonical(path const& p);
|
|
|
|
path weakly_canonical(path const& p, error_code& ec);
|
|
|
|
|
|
|
|
|
2016-06-18 03:46:40 +08:00
|
|
|
} } } } // namespaces std::experimental::filesystem::v1
|
|
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <experimental/__config>
|
Implement <filesystem>
This patch implements the <filesystem> header and uses that
to provide <experimental/filesystem>.
Unlike other standard headers, the symbols needed for <filesystem>
have not yet been placed in libc++.so. Instead they live in the
new libc++fs.a library. Users of filesystem are required to link this
library. (Also note that libc++experimental no longer contains the
definition of <experimental/filesystem>, which now requires linking libc++fs).
The reason for keeping <filesystem> out of the dylib for now is that
it's still somewhat experimental, and the possibility of requiring an
ABI breaking change is very real. In the future the symbols will likely
be moved into the dylib, or the dylib will be made to link libc++fs automagically).
Note that moving the symbols out of libc++experimental may break user builds
until they update to -lc++fs. This should be OK, because the experimental
library provides no stability guarantees. However, I plan on looking into
ways we can force libc++experimental to automagically link libc++fs.
In order to use a single implementation and set of tests for <filesystem>, it
has been placed in a special `__fs` namespace. This namespace is inline in
C++17 onward, but not before that. As such implementation is available
in C++11 onward, but no filesystem namespace is present "directly", and
as such name conflicts shouldn't occur in C++11 or C++14.
llvm-svn: 338093
2018-07-27 11:07:09 +08:00
|
|
|
#include <filesystem>
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
|
|
|
|
#pragma GCC system_header
|
|
|
|
#endif
|
|
|
|
|
2018-07-20 09:51:48 +08:00
|
|
|
_LIBCPP_PUSH_MACROS
|
|
|
|
#include <__undef_macros>
|
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
#ifndef _LIBCPP_CXX03_LANG
|
|
|
|
|
2016-06-18 03:46:40 +08:00
|
|
|
#define __cpp_lib_experimental_filesystem 201406
|
|
|
|
|
|
|
|
_LIBCPP_BEGIN_NAMESPACE_EXPERIMENTAL_FILESYSTEM
|
|
|
|
|
Implement <filesystem>
This patch implements the <filesystem> header and uses that
to provide <experimental/filesystem>.
Unlike other standard headers, the symbols needed for <filesystem>
have not yet been placed in libc++.so. Instead they live in the
new libc++fs.a library. Users of filesystem are required to link this
library. (Also note that libc++experimental no longer contains the
definition of <experimental/filesystem>, which now requires linking libc++fs).
The reason for keeping <filesystem> out of the dylib for now is that
it's still somewhat experimental, and the possibility of requiring an
ABI breaking change is very real. In the future the symbols will likely
be moved into the dylib, or the dylib will be made to link libc++fs automagically).
Note that moving the symbols out of libc++experimental may break user builds
until they update to -lc++fs. This should be OK, because the experimental
library provides no stability guarantees. However, I plan on looking into
ways we can force libc++experimental to automagically link libc++fs.
In order to use a single implementation and set of tests for <filesystem>, it
has been placed in a special `__fs` namespace. This namespace is inline in
C++17 onward, but not before that. As such implementation is available
in C++11 onward, but no filesystem namespace is present "directly", and
as such name conflicts shouldn't occur in C++11 or C++14.
llvm-svn: 338093
2018-07-27 11:07:09 +08:00
|
|
|
using namespace _VSTD_FS;
|
2016-06-18 03:46:40 +08:00
|
|
|
|
|
|
|
_LIBCPP_END_NAMESPACE_EXPERIMENTAL_FILESYSTEM
|
|
|
|
|
2018-07-25 11:41:31 +08:00
|
|
|
#endif // !_LIBCPP_CXX03_LANG
|
|
|
|
|
2018-07-20 09:51:48 +08:00
|
|
|
_LIBCPP_POP_MACROS
|
|
|
|
|
2016-06-18 03:46:40 +08:00
|
|
|
#endif // _LIBCPP_EXPERIMENTAL_FILESYSTEM
|