Subversion
svn_time.h
Go to the documentation of this file.
1 /**
2  * @copyright
3  * ====================================================================
4  * Licensed to the Apache Software Foundation (ASF) under one
5  * or more contributor license agreements. See the NOTICE file
6  * distributed with this work for additional information
7  * regarding copyright ownership. The ASF licenses this file
8  * to you under the Apache License, Version 2.0 (the
9  * "License"); you may not use this file except in compliance
10  * with the License. You may obtain a copy of the License at
11  *
12  * http://www.apache.org/licenses/LICENSE-2.0
13  *
14  * Unless required by applicable law or agreed to in writing,
15  * software distributed under the License is distributed on an
16  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17  * KIND, either express or implied. See the License for the
18  * specific language governing permissions and limitations
19  * under the License.
20  * ====================================================================
21  * @endcopyright
22  *
23  * @file svn_time.h
24  * @brief Time/date utilities
25  */
26 
27 #ifndef SVN_TIME_H
28 #define SVN_TIME_H
29 
30 #include <apr_pools.h>
31 #include <apr_time.h>
32 
33 #include "svn_error.h"
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif /* __cplusplus */
38 
39 
40 /** Convert @a when to a <tt>const char *</tt> representation allocated
41  * in @a pool.
42  *
43  * @see svn_time_from_cstring() for the reverse conversion.
44  */
45 const char *
46 svn_time_to_cstring(apr_time_t when,
47  apr_pool_t *pool);
48 
49 /** Convert @a data to an @c apr_time_t @a when.
50  *
51  * @see svn_time_to_cstring() for the reverse conversion.
52  *
53  * @deprecated Also accepts a format that was used before Subversion 0.14.
54  * See implementation for details. Use of this format is deprecated.
55  *
56  * Use @a pool for temporary memory allocation.
57  */
59 svn_time_from_cstring(apr_time_t *when,
60  const char *data,
61  apr_pool_t *pool);
62 
63 /** Convert @a when to a <tt>const char *</tt> representation allocated
64  * in @a pool, suitable for human display in UTF8.
65  */
66 const char *
67 svn_time_to_human_cstring(apr_time_t when,
68  apr_pool_t *pool);
69 
70 
71 /** Convert a human-readable date @a text into an @c apr_time_t, using
72  * @a now as the current time and storing the result in @a result.
73  * The local time zone will be used to compute the appropriate GMT
74  * offset if @a text contains a local time specification. Set @a
75  * matched to indicate whether or not @a text was parsed successfully.
76  * Perform any allocation in @a pool. Return an error iff an internal
77  * error (rather than a simple parse error) occurs.
78  */
81  apr_time_t *result,
82  const char *text,
83  apr_time_t now,
84  apr_pool_t *pool);
85 
86 
87 /** Sleep until the next second, to ensure that any files modified
88  * after we exit have a different timestamp than the one we recorded.
89  *
90  * @deprecated Provided for backward compatibility with the 1.5 API.
91  * Use svn_io_sleep_for_timestamps() instead.
92  */
94 void
96 
97 #ifdef __cplusplus
98 }
99 #endif /* __cplusplus */
100 
101 #endif /* SVN_TIME_H */
svn_error_t * svn_parse_date(svn_boolean_t *matched, apr_time_t *result, const char *text, apr_time_t now, apr_pool_t *pool)
Convert a human-readable date text into an apr_time_t, using now as the current time and storing the ...
void svn_sleep_for_timestamps(void)
Sleep until the next second, to ensure that any files modified after we exit have a different timesta...
const char * svn_time_to_cstring(apr_time_t when, apr_pool_t *pool)
Convert when to a const char * representation allocated in pool.
Subversion error object.
Definition: svn_types.h:178
const char * svn_time_to_human_cstring(apr_time_t when, apr_pool_t *pool)
Convert when to a const char * representation allocated in pool, suitable for human display in UTF8...
#define SVN_DEPRECATED
Macro used to mark deprecated functions.
Definition: svn_types.h:60
Common exception handling for Subversion.
svn_error_t * svn_time_from_cstring(apr_time_t *when, const char *data, apr_pool_t *pool)
Convert data to an apr_time_t when.
int svn_boolean_t
YABT: Yet Another Boolean Type.
Definition: svn_types.h:139