From Jason Turner

[time.zone.db.remote]

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpfwi4fqek/{from.md → to.md} +38 -0
tmp/tmpfwi4fqek/{from.md → to.md} RENAMED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #### Remote time zone database support <a id="time.zone.db.remote">[[time.zone.db.remote]]</a>
2
+
3
+ The local time zone database is that supplied by the implementation when
4
+ the program first accesses the database, for example via
5
+ `current_zone()`. While the program is running, the implementation may
6
+ choose to update the time zone database. This update shall not impact
7
+ the program in any way unless the program calls the functions in this
8
+ subclause. This potentially updated time zone database is referred to as
9
+ the *remote time zone database*.
10
+
11
+ ``` cpp
12
+ const tzdb& reload_tzdb();
13
+ ```
14
+
15
+ *Effects:* This function first checks the version of the remote time
16
+ zone database. If the versions of the local and remote databases are the
17
+ same, there are no effects. Otherwise the remote database is pushed to
18
+ the front of the `tzdb_list` accessed by `get_tzdb_list()`.
19
+
20
+ *Synchronization:* This function is thread-safe with respect to
21
+ `get_tzdb_list().front()` and `get_tzdb_list().erase_after()`.
22
+
23
+ *Ensures:* No pointers, references, or iterators are invalidated.
24
+
25
+ *Returns:* `get_tzdb_list().front()`.
26
+
27
+ *Throws:* `runtime_error` if for any reason a reference cannot be
28
+ returned to a valid `tzdb`.
29
+
30
+ ``` cpp
31
+ string remote_version();
32
+ ```
33
+
34
+ *Returns:* The latest remote database version.
35
+
36
+ [*Note 1*: This can be compared with `get_tzdb().version` to discover
37
+ if the local and remote databases are equivalent. — *end note*]
38
+