xref: /freebsd/contrib/llvm-project/libcxx/include/__chrono/tzdb_list.h (revision 0fca6ea1d4eea4c934cfff25ac9ee8ad6fe95583)
1 // -*- C++ -*-
2 //===----------------------------------------------------------------------===//
3 //
4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5 // See https://llvm.org/LICENSE.txt for license information.
6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //
8 //===----------------------------------------------------------------------===//
9 
10 // For information see https://libcxx.llvm.org/DesignDocs/TimeZone.html
11 
12 #ifndef _LIBCPP___CHRONO_TZDB_LIST_H
13 #define _LIBCPP___CHRONO_TZDB_LIST_H
14 
15 #include <version>
16 // Enable the contents of the header only when libc++ was built with experimental features enabled.
17 #if !defined(_LIBCPP_HAS_NO_EXPERIMENTAL_TZDB)
18 
19 #  include <__chrono/time_zone.h>
20 #  include <__chrono/tzdb.h>
21 #  include <__config>
22 #  include <__fwd/string.h>
23 #  include <forward_list>
24 
25 #  if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
26 #    pragma GCC system_header
27 #  endif
28 
29 _LIBCPP_BEGIN_NAMESPACE_STD
30 
31 #  if _LIBCPP_STD_VER >= 20 && !defined(_LIBCPP_HAS_NO_TIME_ZONE_DATABASE) && !defined(_LIBCPP_HAS_NO_FILESYSTEM) &&   \
32       !defined(_LIBCPP_HAS_NO_LOCALIZATION)
33 
34 namespace chrono {
35 
36 // TODO TZDB
37 // Libc++ recently switched to only export __ugly_names from the dylib.
38 // Since the library is still experimental the functions in this header
39 // should be adapted to this new style. The other tzdb headers should be
40 // evaluated too.
41 
42 class _LIBCPP_AVAILABILITY_TZDB tzdb_list {
43 public:
44   class __impl; // public to allow construction in dylib
tzdb_list(__impl * __p)45   _LIBCPP_HIDE_FROM_ABI explicit tzdb_list(__impl* __p) : __impl_(__p) {
46     _LIBCPP_ASSERT_NON_NULL(__impl_ != nullptr, "initialized time_zone without a valid pimpl object");
47   }
48   _LIBCPP_EXPORTED_FROM_ABI ~tzdb_list();
49 
50   tzdb_list(const tzdb_list&)            = delete;
51   tzdb_list& operator=(const tzdb_list&) = delete;
52 
53   using const_iterator = forward_list<tzdb>::const_iterator;
54 
front()55   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI const tzdb& front() const noexcept { return __front(); }
56 
erase_after(const_iterator __p)57   _LIBCPP_HIDE_FROM_ABI const_iterator erase_after(const_iterator __p) { return __erase_after(__p); }
58 
begin()59   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI const_iterator begin() const noexcept { return __begin(); }
end()60   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI const_iterator end() const noexcept { return __end(); }
61 
cbegin()62   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI const_iterator cbegin() const noexcept { return __cbegin(); }
cend()63   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI const_iterator cend() const noexcept { return __cend(); }
64 
__implementation()65   [[nodiscard]] _LIBCPP_HIDE_FROM_ABI __impl& __implementation() { return *__impl_; }
66 
67 private:
68   [[nodiscard]] _LIBCPP_EXPORTED_FROM_ABI const tzdb& __front() const noexcept;
69 
70   _LIBCPP_EXPORTED_FROM_ABI const_iterator __erase_after(const_iterator __p);
71 
72   [[nodiscard]] _LIBCPP_EXPORTED_FROM_ABI const_iterator __begin() const noexcept;
73   [[nodiscard]] _LIBCPP_EXPORTED_FROM_ABI const_iterator __end() const noexcept;
74 
75   [[nodiscard]] _LIBCPP_EXPORTED_FROM_ABI const_iterator __cbegin() const noexcept;
76   [[nodiscard]] _LIBCPP_EXPORTED_FROM_ABI const_iterator __cend() const noexcept;
77 
78   __impl* __impl_;
79 };
80 
81 [[nodiscard]] _LIBCPP_AVAILABILITY_TZDB _LIBCPP_EXPORTED_FROM_ABI tzdb_list& get_tzdb_list();
82 
get_tzdb()83 [[nodiscard]] _LIBCPP_AVAILABILITY_TZDB _LIBCPP_HIDE_FROM_ABI inline const tzdb& get_tzdb() {
84   return get_tzdb_list().front();
85 }
86 
locate_zone(string_view __name)87 [[nodiscard]] _LIBCPP_AVAILABILITY_TZDB _LIBCPP_HIDE_FROM_ABI inline const time_zone* locate_zone(string_view __name) {
88   return get_tzdb().locate_zone(__name);
89 }
90 
current_zone()91 [[nodiscard]] _LIBCPP_AVAILABILITY_TZDB _LIBCPP_HIDE_FROM_ABI inline const time_zone* current_zone() {
92   return get_tzdb().current_zone();
93 }
94 
95 _LIBCPP_AVAILABILITY_TZDB _LIBCPP_EXPORTED_FROM_ABI const tzdb& reload_tzdb();
96 
97 [[nodiscard]] _LIBCPP_AVAILABILITY_TZDB _LIBCPP_EXPORTED_FROM_ABI string remote_version();
98 
99 } // namespace chrono
100 
101 #  endif // _LIBCPP_STD_VER >= 20 && !defined(_LIBCPP_HAS_NO_TIME_ZONE_DATABASE) && !defined(_LIBCPP_HAS_NO_FILESYSTEM)
102          // && !defined(_LIBCPP_HAS_NO_LOCALIZATION)
103 
104 _LIBCPP_END_NAMESPACE_STD
105 
106 #endif // !defined(_LIBCPP_HAS_NO_EXPERIMENTAL_TZDB)
107 
108 #endif // _LIBCPP___CHRONO_TZDB_LIST_H
109