Skip to content

Commit a61a25c

Browse files
committed
Update documentation of tiledb_vfs_touch.
1 parent e9704e1 commit a61a25c

File tree

2 files changed

+5
-2
lines changed

2 files changed

+5
-2
lines changed

tiledb/api/c_api/vfs/vfs_api_external.h

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -640,7 +640,9 @@ TILEDB_EXPORT capi_return_t tiledb_vfs_fh_is_closed(
640640
tiledb_ctx_t* ctx, tiledb_vfs_fh_t* fh, int32_t* is_closed) TILEDB_NOEXCEPT;
641641

642642
/**
643-
* Touches a file, i.e., creates a new empty file.
643+
* Touches a file, i.e., creates a new empty file if it does not already exist.
644+
*
645+
* The access timestamps of the file are not guaranteed to change.
644646
*
645647
* **Example:**
646648
*

tiledb/sm/cpp_api/vfs.h

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -519,7 +519,8 @@ class VFS {
519519
ctx.ptr().get(), vfs_.get(), old_uri.c_str(), new_uri.c_str()));
520520
}
521521

522-
/** Touches a file with the input URI, i.e., creates a new empty file. */
522+
/** Touches a file with the input URI, i.e., creates a new empty file if it
523+
* does not already exist. */
523524
void touch(const std::string& uri) const {
524525
auto& ctx = ctx_.get();
525526
ctx.handle_error(

0 commit comments

Comments
 (0)