mirrored from git://gcc.gnu.org/git/gcc.git
-
Notifications
You must be signed in to change notification settings - Fork 4.4k
/
fs_path.h
1366 lines (1142 loc) · 38.7 KB
/
fs_path.h
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
// Class filesystem::path -*- C++ -*-
// Copyright (C) 2014-2021 Free Software Foundation, Inc.
//
// This file is part of the GNU ISO C++ Library. This library is free
// software; you can redistribute it and/or modify it under the
// terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3, or (at your option)
// any later version.
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// Under Section 7 of GPL version 3, you are granted additional
// permissions described in the GCC Runtime Library Exception, version
// 3.1, as published by the Free Software Foundation.
// You should have received a copy of the GNU General Public License and
// a copy of the GCC Runtime Library Exception along with this program;
// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
// <http://www.gnu.org/licenses/>.
/** @file include/bits/fs_path.h
* This is an internal header file, included by other library headers.
* Do not attempt to use it directly. @headername{filesystem}
*/
#ifndef _GLIBCXX_FS_PATH_H
#define _GLIBCXX_FS_PATH_H 1
#if __cplusplus >= 201703L
#include <utility>
#include <type_traits>
#include <locale>
#include <iosfwd>
#include <iomanip>
#include <codecvt>
#include <string_view>
#include <system_error>
#include <bits/stl_algobase.h>
#include <bits/locale_conv.h>
#include <ext/concurrence.h>
#include <bits/shared_ptr.h>
#include <bits/unique_ptr.h>
#if __cplusplus > 201703L
# include <compare>
#endif
#if defined(_WIN32) && !defined(__CYGWIN__)
# define _GLIBCXX_FILESYSTEM_IS_WINDOWS 1
# include <algorithm>
#endif
namespace std _GLIBCXX_VISIBILITY(default)
{
_GLIBCXX_BEGIN_NAMESPACE_VERSION
namespace filesystem
{
_GLIBCXX_BEGIN_NAMESPACE_CXX11
/** @addtogroup filesystem
* @{
*/
class path;
/// @cond undocumented
namespace __detail
{
template<typename _CharT>
inline constexpr bool __is_encoded_char = false;
template<>
inline constexpr bool __is_encoded_char<char> = true;
#ifdef _GLIBCXX_USE_CHAR8_T
template<>
inline constexpr bool __is_encoded_char<char8_t> = true;
#endif
#if _GLIBCXX_USE_WCHAR_T
template<>
inline constexpr bool __is_encoded_char<wchar_t> = true;
#endif
template<>
inline constexpr bool __is_encoded_char<char16_t> = true;
template<>
inline constexpr bool __is_encoded_char<char32_t> = true;
#if __cpp_concepts >= 201907L
template<typename _Iter>
using __safe_iterator_traits = std::iterator_traits<_Iter>;
#else
template<typename _Iter>
struct __safe_iterator_traits : std::iterator_traits<_Iter>
{ };
// Protect against ill-formed iterator_traits specializations in C++17
template<> struct __safe_iterator_traits<void*> { };
template<> struct __safe_iterator_traits<const void*> { };
template<> struct __safe_iterator_traits<volatile void*> { };
template<> struct __safe_iterator_traits<const volatile void*> { };
#endif
template<typename _Iter_traits, typename = void>
struct __is_path_iter_src
: false_type
{ };
template<typename _Iter_traits>
struct __is_path_iter_src<_Iter_traits,
void_t<typename _Iter_traits::value_type>>
: bool_constant<__is_encoded_char<typename _Iter_traits::value_type>>
{ };
template<typename _Source>
inline constexpr bool __is_path_src
= __is_path_iter_src<iterator_traits<decay_t<_Source>>>::value;
template<>
inline constexpr bool __is_path_src<path> = false;
template<>
inline constexpr bool __is_path_src<volatile path> = false;
template<>
inline constexpr bool __is_path_src<void*> = false;
template<>
inline constexpr bool __is_path_src<const void*> = false;
template<>
inline constexpr bool __is_path_src<volatile void*> = false;
template<>
inline constexpr bool __is_path_src<const volatile void*> = false;
template<typename _CharT, typename _Traits, typename _Alloc>
inline constexpr bool
__is_path_src<basic_string<_CharT, _Traits, _Alloc>>
= __is_encoded_char<_CharT>;
template<typename _CharT, typename _Traits>
inline constexpr bool
__is_path_src<basic_string_view<_CharT, _Traits>>
= __is_encoded_char<_CharT>;
// SFINAE constraint for Source parameters as required by [fs.path.req].
template<typename _Tp>
using _Path = enable_if_t<__is_path_src<_Tp>, path>;
// SFINAE constraint for InputIterator parameters as required by [fs.req].
template<typename _Iter, typename _Tr = __safe_iterator_traits<_Iter>>
using _Path2 = enable_if_t<__is_path_iter_src<_Tr>::value, path>;
// The __effective_range overloads convert a Source parameter into
// either a basic_string_view or basic_string containing the
// effective range of the Source, as defined in [fs.path.req].
template<typename _CharT, typename _Traits, typename _Alloc>
inline basic_string_view<_CharT, _Traits>
__effective_range(const basic_string<_CharT, _Traits, _Alloc>& __source)
{ return __source; }
template<typename _CharT, typename _Traits>
inline const basic_string_view<_CharT, _Traits>&
__effective_range(const basic_string_view<_CharT, _Traits>& __source)
{ return __source; }
template<typename _Source>
inline auto
__effective_range(const _Source& __source)
{
if constexpr (is_pointer_v<decay_t<_Source>>)
return basic_string_view{&*__source};
else
{
// _Source is an input iterator that iterates over an NTCTS.
// Create a basic_string by reading until the null character.
using value_type
= typename iterator_traits<_Source>::value_type;
basic_string<value_type> __str;
_Source __it = __source;
for (value_type __ch = *__it; __ch != value_type(); __ch = *++__it)
__str.push_back(__ch);
return __str;
}
}
// The value type of a Source parameter's effective range.
template<typename _Tp>
using __value_t = typename remove_reference_t<
decltype(__detail::__effective_range(std::declval<_Tp>()))>::value_type;
// SFINAE helper to check that an effective range has value_type char,
// as required by path constructors taking a std::locale parameter.
// The type _Tp must have already been checked by _Path<Tp> or _Path2<_Tp>.
template<typename _Tp, typename _Val = __value_t<_Tp>>
using __value_type_is_char
= std::enable_if_t<std::is_same_v<_Val, char>, _Val>;
// As above, but also allows char8_t, as required by u8path
// C++20 [depr.fs.path.factory]
template<typename _Tp, typename _Val = __value_t<_Tp>>
using __value_type_is_char_or_char8_t
= std::enable_if_t<std::is_same_v<_Val, char>
#ifdef _GLIBCXX_USE_CHAR8_T
|| std::is_same_v<_Val, char8_t>
#endif
, _Val>;
// Create a string or string view from an iterator range.
template<typename _InputIterator>
inline auto
__string_from_range(_InputIterator __first, _InputIterator __last)
{
using _EcharT
= typename std::iterator_traits<_InputIterator>::value_type;
static_assert(__is_encoded_char<_EcharT>);
#if __cpp_lib_concepts
constexpr bool __contiguous = std::contiguous_iterator<_InputIterator>;
#else
constexpr bool __contiguous
= is_pointer_v<decltype(std::__niter_base(__first))>;
#endif
if constexpr (__contiguous)
{
// For contiguous iterators we can just return a string view.
const auto* __f = std::__to_address(std::__niter_base(__first));
const auto* __l = std::__to_address(std::__niter_base(__last));
return basic_string_view<_EcharT>(__f, __l - __f);
}
else
// Conversion requires contiguous characters, so create a string.
return basic_string<_EcharT>(__first, __last);
}
} // namespace __detail
/// @endcond
/// A filesystem path.
class path
{
public:
#ifdef _GLIBCXX_FILESYSTEM_IS_WINDOWS
using value_type = wchar_t;
static constexpr value_type preferred_separator = L'\\';
#else
# ifdef _GLIBCXX_DOXYGEN
/// Windows uses wchar_t for path::value_type, POSIX uses char.
using value_type = __os_dependent__;
# else
using value_type = char;
# endif
static constexpr value_type preferred_separator = '/';
#endif
using string_type = std::basic_string<value_type>;
/// path::format is ignored in this implementation
enum format : unsigned char { native_format, generic_format, auto_format };
// constructors and destructor
path() noexcept { }
path(const path& __p) = default;
path(path&& __p)
#if _GLIBCXX_USE_CXX11_ABI || _GLIBCXX_FULLY_DYNAMIC_STRING == 0
noexcept
#endif
: _M_pathname(std::move(__p._M_pathname)),
_M_cmpts(std::move(__p._M_cmpts))
{ __p.clear(); }
path(string_type&& __source, format = auto_format)
: _M_pathname(std::move(__source))
{ _M_split_cmpts(); }
template<typename _Source,
typename _Require = __detail::_Path<_Source>>
path(_Source const& __source, format = auto_format)
: _M_pathname(_S_convert(__detail::__effective_range(__source)))
{ _M_split_cmpts(); }
template<typename _InputIterator,
typename _Require = __detail::_Path2<_InputIterator>>
path(_InputIterator __first, _InputIterator __last, format = auto_format)
: _M_pathname(_S_convert(__first, __last))
{ _M_split_cmpts(); }
template<typename _Source,
typename _Require = __detail::_Path<_Source>,
typename _Require2 = __detail::__value_type_is_char<_Source>>
path(_Source const& __src, const locale& __loc, format = auto_format)
: _M_pathname(_S_convert_loc(__detail::__effective_range(__src), __loc))
{ _M_split_cmpts(); }
template<typename _InputIterator,
typename _Require = __detail::_Path2<_InputIterator>,
typename _Req2 = __detail::__value_type_is_char<_InputIterator>>
path(_InputIterator __first, _InputIterator __last, const locale& __loc,
format = auto_format)
: _M_pathname(_S_convert_loc(__first, __last, __loc))
{ _M_split_cmpts(); }
~path() = default;
// assignments
path& operator=(const path&);
path& operator=(path&&) noexcept;
path& operator=(string_type&& __source);
path& assign(string_type&& __source);
template<typename _Source>
__detail::_Path<_Source>&
operator=(_Source const& __source)
{ return *this = path(__source); }
template<typename _Source>
__detail::_Path<_Source>&
assign(_Source const& __source)
{ return *this = path(__source); }
template<typename _InputIterator>
__detail::_Path2<_InputIterator>&
assign(_InputIterator __first, _InputIterator __last)
{ return *this = path(__first, __last); }
// appends
path& operator/=(const path& __p);
template<typename _Source>
__detail::_Path<_Source>&
operator/=(_Source const& __source)
{
_M_append(_S_convert(__detail::__effective_range(__source)));
return *this;
}
template<typename _Source>
__detail::_Path<_Source>&
append(_Source const& __source)
{
_M_append(_S_convert(__detail::__effective_range(__source)));
return *this;
}
template<typename _InputIterator>
__detail::_Path2<_InputIterator>&
append(_InputIterator __first, _InputIterator __last)
{
_M_append(_S_convert(__first, __last));
return *this;
}
// concatenation
path& operator+=(const path& __x);
path& operator+=(const string_type& __x);
path& operator+=(const value_type* __x);
path& operator+=(value_type __x);
path& operator+=(basic_string_view<value_type> __x);
template<typename _Source>
__detail::_Path<_Source>&
operator+=(_Source const& __x) { return concat(__x); }
template<typename _CharT>
__detail::_Path2<_CharT*>&
operator+=(_CharT __x);
template<typename _Source>
__detail::_Path<_Source>&
concat(_Source const& __x)
{
_M_concat(_S_convert(__detail::__effective_range(__x)));
return *this;
}
template<typename _InputIterator>
__detail::_Path2<_InputIterator>&
concat(_InputIterator __first, _InputIterator __last)
{
_M_concat(_S_convert(__first, __last));
return *this;
}
// modifiers
void clear() noexcept { _M_pathname.clear(); _M_split_cmpts(); }
path& make_preferred();
path& remove_filename();
path& replace_filename(const path& __replacement);
path& replace_extension(const path& __replacement = path());
void swap(path& __rhs) noexcept;
// native format observers
const string_type& native() const noexcept { return _M_pathname; }
const value_type* c_str() const noexcept { return _M_pathname.c_str(); }
operator string_type() const { return _M_pathname; }
template<typename _CharT, typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
std::basic_string<_CharT, _Traits, _Allocator>
string(const _Allocator& __a = _Allocator()) const;
std::string string() const;
#if _GLIBCXX_USE_WCHAR_T
std::wstring wstring() const;
#endif
#ifdef _GLIBCXX_USE_CHAR8_T
__attribute__((__abi_tag__("__u8")))
std::u8string u8string() const;
#else
std::string u8string() const;
#endif // _GLIBCXX_USE_CHAR8_T
std::u16string u16string() const;
std::u32string u32string() const;
// generic format observers
template<typename _CharT, typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
std::basic_string<_CharT, _Traits, _Allocator>
generic_string(const _Allocator& __a = _Allocator()) const;
std::string generic_string() const;
#if _GLIBCXX_USE_WCHAR_T
std::wstring generic_wstring() const;
#endif
#ifdef _GLIBCXX_USE_CHAR8_T
__attribute__((__abi_tag__("__u8")))
std::u8string generic_u8string() const;
#else
std::string generic_u8string() const;
#endif // _GLIBCXX_USE_CHAR8_T
std::u16string generic_u16string() const;
std::u32string generic_u32string() const;
// compare
int compare(const path& __p) const noexcept;
int compare(const string_type& __s) const noexcept;
int compare(const value_type* __s) const noexcept;
int compare(basic_string_view<value_type> __s) const noexcept;
// decomposition
path root_name() const;
path root_directory() const;
path root_path() const;
path relative_path() const;
path parent_path() const;
path filename() const;
path stem() const;
path extension() const;
// query
[[nodiscard]] bool empty() const noexcept { return _M_pathname.empty(); }
bool has_root_name() const noexcept;
bool has_root_directory() const noexcept;
bool has_root_path() const noexcept;
bool has_relative_path() const noexcept;
bool has_parent_path() const noexcept;
bool has_filename() const noexcept;
bool has_stem() const noexcept;
bool has_extension() const noexcept;
bool is_absolute() const noexcept;
bool is_relative() const noexcept { return !is_absolute(); }
// generation
path lexically_normal() const;
path lexically_relative(const path& base) const;
path lexically_proximate(const path& base) const;
// iterators
class iterator;
using const_iterator = iterator;
iterator begin() const;
iterator end() const;
/// Write a path to a stream
template<typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>& __os, const path& __p)
{
__os << std::quoted(__p.string<_CharT, _Traits>());
return __os;
}
/// Read a path from a stream
template<typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>& __is, path& __p)
{
std::basic_string<_CharT, _Traits> __tmp;
if (__is >> std::quoted(__tmp))
__p = std::move(__tmp);
return __is;
}
// non-member operators
/// Compare paths
friend bool operator==(const path& __lhs, const path& __rhs) noexcept
{ return path::_S_compare(__lhs, __rhs) == 0; }
#if __cpp_lib_three_way_comparison
/// Compare paths
friend strong_ordering
operator<=>(const path& __lhs, const path& __rhs) noexcept
{ return path::_S_compare(__lhs, __rhs) <=> 0; }
#else
/// Compare paths
friend bool operator!=(const path& __lhs, const path& __rhs) noexcept
{ return !(__lhs == __rhs); }
/// Compare paths
friend bool operator<(const path& __lhs, const path& __rhs) noexcept
{ return __lhs.compare(__rhs) < 0; }
/// Compare paths
friend bool operator<=(const path& __lhs, const path& __rhs) noexcept
{ return !(__rhs < __lhs); }
/// Compare paths
friend bool operator>(const path& __lhs, const path& __rhs) noexcept
{ return __rhs < __lhs; }
/// Compare paths
friend bool operator>=(const path& __lhs, const path& __rhs) noexcept
{ return !(__lhs < __rhs); }
#endif
/// Append one path to another
friend path operator/(const path& __lhs, const path& __rhs)
{
path __result(__lhs);
__result /= __rhs;
return __result;
}
private:
enum class _Type : unsigned char {
_Multi = 0, _Root_name, _Root_dir, _Filename
};
path(basic_string_view<value_type> __str, _Type __type)
: _M_pathname(__str)
{
__glibcxx_assert(__type != _Type::_Multi);
_M_cmpts.type(__type);
}
enum class _Split { _Stem, _Extension };
void _M_append(basic_string_view<value_type>);
void _M_concat(basic_string_view<value_type>);
pair<const string_type*, size_t> _M_find_extension() const noexcept;
// path::_S_convert creates a basic_string<value_type> or
// basic_string_view<value_type> from a range (either the effective
// range of a Source parameter, or a pair of InputIterator parameters),
// performing the conversions required by [fs.path.type.cvt].
// If the value_type of the range value type is path::value_type,
// no encoding conversion is performed. If the range is contiguous
// a string_view
static string_type
_S_convert(string_type __str)
{ return __str; }
template<typename _Tp>
static auto
_S_convert(const _Tp& __str)
{
if constexpr (is_same_v<_Tp, string_type>)
return __str;
else if constexpr (is_same_v<_Tp, basic_string_view<value_type>>)
return __str;
else if constexpr (is_same_v<typename _Tp::value_type, value_type>)
return basic_string_view<value_type>(__str.data(), __str.size());
else
return _S_convert(__str.data(), __str.data() + __str.size());
}
template<typename _EcharT>
static auto
_S_convert(const _EcharT* __first, const _EcharT* __last);
template<typename _Iter>
static auto
_S_convert(_Iter __first, _Iter __last)
{ return _S_convert(__detail::__string_from_range(__first, __last)); }
static string_type
_S_convert_loc(const char* __first, const char* __last,
const std::locale& __loc);
template<typename _Iter>
static string_type
_S_convert_loc(_Iter __first, _Iter __last, const std::locale& __loc)
{
const auto __s = __detail::__string_from_range(__first, __last);
return _S_convert_loc(__s.data(), __s.data() + __s.size(), __loc);
}
template<typename _Tp>
static string_type
_S_convert_loc(const _Tp& __s, const std::locale& __loc)
{
return _S_convert_loc(__s.data(), __s.data() + __s.size(), __loc);
}
template<typename _CharT, typename _Traits, typename _Allocator>
static basic_string<_CharT, _Traits, _Allocator>
_S_str_convert(basic_string_view<value_type>, const _Allocator&);
// Returns lhs.compare(rhs), but defined after path::iterator is complete.
__attribute__((__always_inline__))
static int
_S_compare(const path& __lhs, const path& __rhs) noexcept;
void _M_split_cmpts();
_Type _M_type() const noexcept { return _M_cmpts.type(); }
string_type _M_pathname;
struct _Cmpt;
struct _List
{
using value_type = _Cmpt;
using iterator = value_type*;
using const_iterator = const value_type*;
_List();
_List(const _List&);
_List(_List&&) = default;
_List& operator=(const _List&);
_List& operator=(_List&&) = default;
~_List() = default;
_Type type() const noexcept
{ return _Type(reinterpret_cast<uintptr_t>(_M_impl.get()) & 0x3); }
void type(_Type) noexcept;
int size() const noexcept; // zero unless type() == _Type::_Multi
bool empty() const noexcept; // true unless type() == _Type::_Multi
void clear();
void swap(_List& __l) noexcept { _M_impl.swap(__l._M_impl); }
int capacity() const noexcept;
void reserve(int, bool); ///< @pre type() == _Type::_Multi
// All the member functions below here have a precondition !empty()
// (and they should only be called from within the library).
iterator begin() noexcept;
iterator end() noexcept;
const_iterator begin() const noexcept;
const_iterator end() const noexcept;
value_type& front() noexcept;
value_type& back() noexcept;
const value_type& front() const noexcept;
const value_type& back() const noexcept;
void pop_back();
void _M_erase_from(const_iterator __pos); // erases [__pos,end())
struct _Impl;
struct _Impl_deleter
{
void operator()(_Impl*) const noexcept;
};
unique_ptr<_Impl, _Impl_deleter> _M_impl;
};
_List _M_cmpts;
struct _Parser;
};
/// @relates std::filesystem::path @{
inline void swap(path& __lhs, path& __rhs) noexcept { __lhs.swap(__rhs); }
size_t hash_value(const path& __p) noexcept;
/// @}
/// Exception type thrown by the Filesystem library
class filesystem_error : public std::system_error
{
public:
filesystem_error(const string& __what_arg, error_code __ec);
filesystem_error(const string& __what_arg, const path& __p1,
error_code __ec);
filesystem_error(const string& __what_arg, const path& __p1,
const path& __p2, error_code __ec);
filesystem_error(const filesystem_error&) = default;
filesystem_error& operator=(const filesystem_error&) = default;
// No move constructor or assignment operator.
// Copy rvalues instead, so that _M_impl is not left empty.
~filesystem_error();
const path& path1() const noexcept;
const path& path2() const noexcept;
const char* what() const noexcept;
private:
struct _Impl;
std::__shared_ptr<const _Impl> _M_impl;
};
/// @cond undocumented
namespace __detail
{
[[noreturn]] inline void
__throw_conversion_error()
{
_GLIBCXX_THROW_OR_ABORT(filesystem_error(
"Cannot convert character sequence",
std::make_error_code(errc::illegal_byte_sequence)));
}
#ifdef _GLIBCXX_FILESYSTEM_IS_WINDOWS
template<typename _Tp>
inline std::wstring
__wstr_from_utf8(const _Tp& __str)
{
static_assert(std::is_same_v<typename _Tp::value_type, char>);
std::wstring __wstr;
// XXX This assumes native wide encoding is UTF-16.
std::codecvt_utf8_utf16<wchar_t> __wcvt;
const auto __p = __str.data();
if (!__str_codecvt_in_all(__p, __p + __str.size(), __wstr, __wcvt))
__detail::__throw_conversion_error();
return __wstr;
}
#endif
} // namespace __detail
/// @endcond
/** Create a path from a UTF-8-encoded sequence of char
*
* @relates std::filesystem::path
*/
template<typename _InputIterator,
typename _Require = __detail::_Path2<_InputIterator>,
typename _CharT
= __detail::__value_type_is_char_or_char8_t<_InputIterator>>
inline path
u8path(_InputIterator __first, _InputIterator __last)
{
#ifdef _GLIBCXX_FILESYSTEM_IS_WINDOWS
if constexpr (is_same_v<_CharT, char>)
return path{ __detail::__wstr_from_utf8(
__detail::__string_from_range(__first, __last)) };
else
return path{ __first, __last }; // constructor handles char8_t
#else
// This assumes native normal encoding is UTF-8.
return path{ __first, __last };
#endif
}
/** Create a path from a UTF-8-encoded sequence of char
*
* @relates std::filesystem::path
*/
template<typename _Source,
typename _Require = __detail::_Path<_Source>,
typename _CharT = __detail::__value_type_is_char_or_char8_t<_Source>>
inline path
u8path(const _Source& __source)
{
#ifdef _GLIBCXX_FILESYSTEM_IS_WINDOWS
if constexpr (is_same_v<_CharT, char>)
return path{ __detail::__wstr_from_utf8(
__detail::__effective_range(__source)) };
else
return path{ __source }; // constructor handles char8_t
#else
// This assumes native normal encoding is UTF-8.
return path{ __source };
#endif
}
/// @cond undocumented
struct path::_Cmpt : path
{
_Cmpt(basic_string_view<value_type> __s, _Type __t, size_t __pos)
: path(__s, __t), _M_pos(__pos) { }
_Cmpt() : _M_pos(-1) { }
size_t _M_pos;
};
template<typename _EcharT>
auto
path::_S_convert(const _EcharT* __f, const _EcharT* __l)
{
static_assert(__detail::__is_encoded_char<_EcharT>);
if constexpr (is_same_v<_EcharT, value_type>)
return basic_string_view<value_type>(__f, __l - __f);
#if !defined _GLIBCXX_FILESYSTEM_IS_WINDOWS && defined _GLIBCXX_USE_CHAR8_T
else if constexpr (is_same_v<_EcharT, char8_t>)
// For POSIX converting from char8_t to char is also 'noconv'
return string_view(reinterpret_cast<const char*>(__f), __l - __f);
#endif
else
{
#ifdef _GLIBCXX_FILESYSTEM_IS_WINDOWS
std::wstring __wstr;
if constexpr (is_same_v<_EcharT, char>)
{
struct _UCvt : std::codecvt<wchar_t, char, std::mbstate_t>
{ } __cvt;
if (__str_codecvt_in_all(__f, __l, __wstr, __cvt))
return __wstr;
}
#ifdef _GLIBCXX_USE_CHAR8_T
else if constexpr (is_same_v<_EcharT, char8_t>)
{
const auto __f2 = reinterpret_cast<const char*>(__f);
return __detail::__wstr_from_utf8(string_view(__f2, __l - __f));
}
#endif
else // char16_t or char32_t
{
struct _UCvt : std::codecvt<_EcharT, char, std::mbstate_t>
{ } __cvt;
std::string __str;
if (__str_codecvt_out_all(__f, __l, __str, __cvt))
return __detail::__wstr_from_utf8(__str);
}
#else // ! windows
struct _UCvt : std::codecvt<_EcharT, char, std::mbstate_t>
{ } __cvt;
std::string __str;
if (__str_codecvt_out_all(__f, __l, __str, __cvt))
return __str;
#endif
__detail::__throw_conversion_error();
}
}
/// @endcond
/// An iterator for the components of a path
class path::iterator
{
public:
using difference_type = std::ptrdiff_t;
using value_type = path;
using reference = const path&;
using pointer = const path*;
using iterator_category = std::bidirectional_iterator_tag;
iterator() : _M_path(nullptr), _M_cur(), _M_at_end() { }
iterator(const iterator&) = default;
iterator& operator=(const iterator&) = default;
reference operator*() const;
pointer operator->() const { return std::__addressof(**this); }
iterator& operator++();
iterator operator++(int) { auto __tmp = *this; ++*this; return __tmp; }
iterator& operator--();
iterator operator--(int) { auto __tmp = *this; --*this; return __tmp; }
friend bool operator==(const iterator& __lhs, const iterator& __rhs)
{ return __lhs._M_equals(__rhs); }
friend bool operator!=(const iterator& __lhs, const iterator& __rhs)
{ return !__lhs._M_equals(__rhs); }
private:
friend class path;
bool _M_is_multi() const { return _M_path->_M_type() == _Type::_Multi; }
friend difference_type
__path_iter_distance(const iterator& __first, const iterator& __last)
{
__glibcxx_assert(__first._M_path != nullptr);
__glibcxx_assert(__first._M_path == __last._M_path);
if (__first._M_is_multi())
return std::distance(__first._M_cur, __last._M_cur);
else if (__first._M_at_end == __last._M_at_end)
return 0;
else
return __first._M_at_end ? -1 : 1;
}
friend void
__path_iter_advance(iterator& __i, difference_type __n)
{
if (__n == 1)
++__i;
else if (__n == -1)
--__i;
else if (__n != 0)
{
__glibcxx_assert(__i._M_path != nullptr);
__glibcxx_assert(__i._M_is_multi());
// __glibcxx_assert(__i._M_path->_M_cmpts.end() - __i._M_cur >= __n);
__i._M_cur += __n;
}
}
iterator(const path* __path, path::_List::const_iterator __iter)
: _M_path(__path), _M_cur(__iter), _M_at_end()
{ }
iterator(const path* __path, bool __at_end)
: _M_path(__path), _M_cur(), _M_at_end(__at_end)
{ }
bool _M_equals(iterator) const;
const path* _M_path;
path::_List::const_iterator _M_cur;
bool _M_at_end; // only used when type != _Multi
};
inline path&
path::operator=(path&& __p) noexcept
{
if (&__p == this) [[__unlikely__]]
return *this;
_M_pathname = std::move(__p._M_pathname);
_M_cmpts = std::move(__p._M_cmpts);
__p.clear();
return *this;
}
inline path&
path::operator=(string_type&& __source)
{ return *this = path(std::move(__source)); }
inline path&
path::assign(string_type&& __source)
{ return *this = path(std::move(__source)); }
inline path&
path::operator+=(const string_type& __x)
{
_M_concat(__x);
return *this;
}
inline path&
path::operator+=(const value_type* __x)
{
_M_concat(__x);
return *this;
}
inline path&
path::operator+=(value_type __x)
{
_M_concat(basic_string_view<value_type>(&__x, 1));
return *this;
}
inline path&
path::operator+=(basic_string_view<value_type> __x)
{
_M_concat(__x);
return *this;
}