R googledrive drive_rename 重命名雲端硬盤文件

這是 drive_mv() 的包裝器，僅重命名文件。如果您想重命名並移動文件，請參閱drive_mv()。

用法

drive_rename(file, name = NULL, overwrite = NA, verbose = deprecated())

參數

file

識別您的 Google 雲端硬盤上感興趣的文件的內容。可以是名稱或路徑、標有 as_id() 或 dribble 的文件 ID 或 URL。

name

特點。您希望文件具有的名稱。

overwrite

邏輯，指示是否檢查目標"filepath"處是否存在預先存在的文件。 "filepath" 周圍的引號是指 Drive 不會像典型的文件係統那樣在文件路徑和文件之間強加一對一的關係；在 drive_get() 中了解更多相關信息。

NA(默認)：隻需執行該操作，即使它會導致多個文件具有相同的文件路徑。
TRUE ：檢查文件路徑中是否存在預先存在的文件。如果有零個或一個，請將預先存在的文件移至箱子，然後繼續。請注意，新文件不會繼承舊文件的任何屬性，例如共享或發布設置。它將有一個新的文件 ID。如果找到兩個或多個預先存在的文件，則會引發錯誤。
FALSE：如果文件路徑中存在任何預先存在的文件，則會出錯。

請注意，基於文件路徑的存在性檢查是昂貴的操作，即它們需要額外的 API 調用。

verbose

這種對各個 googledrive 函數的邏輯論證已被棄用。要全局禁止 googledrive 消息傳遞，請使用options(googledrive_quiet = TRUE)(默認行為是發出信息性消息)。要以更有限的方式抑製消息傳遞，請使用幫助程序local_drive_quiet()或者with_drive_quiet().

值

dribble 類的對象，每個文件一行的 tibble。

例子

# Create a file to rename
file <- drive_create("file-to-rename")
#> Created Drive file:
#> • file-to-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> With MIME type:
#> • application/octet-stream

# Rename it
file <- drive_rename(file, name = "renamed-file")
#> Original file:
#> • file-to-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> Has been renamed:
#> • renamed-file <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

# `overwrite = FALSE` errors if something already exists at target filepath
# THIS WILL ERROR!
drive_create("name-squatter-rename")
#> Created Drive file:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>
#> With MIME type:
#> • application/octet-stream
drive_rename(file, name = "name-squatter-rename", overwrite = FALSE)
#> Error in check_for_overwrite(parent = params[["addParents"]] %||% parent_before,     name = params[["name"]] %||% file$name, overwrite = overwrite): 1 item already exists at the target filepath and `overwrite =
#> FALSE`:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>

# `overwrite = TRUE` moves the existing item to trash, then proceeds
file <- drive_rename(file, name = "name-squatter-rename", overwrite = TRUE)
#> File trashed:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>
#> Original file:
#> • renamed-file <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> Has been renamed:
#> • name-squatter-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

# Clean up
drive_rm(file)
#> File deleted:
#> • name-squatter-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

源代碼：R/drive_rename.R

相關用法

注：本文由純淨天空篩選整理自Jennifer Bryan等大神的英文原創作品 Rename a Drive file。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。