txt: ## move.md
  move
  
  Combined from primary sources listed below.
  
  # [In IO::Path](#___top "go to top of document")[§](#(IO::Path)_routine_move "direct link")
  
  See primary documentation
  [in context](/type/IO/Path#routine_move)
  for **routine move**.
  
  ```raku
  method move(IO::Path:D: IO() $to, :$createonly --> Bool:D)
  sub    move(IO() $from, IO() $to, :$createonly --> Bool:D)
  ```
  
  Copies a file and then removes the original. If removal fails, it's possible to end up with two copies of the file. Returns `True` on success; [fails](/routine/fail) with [`X::IO::Move`](/type/X/IO/Move) if `:$createonly` is `True` and the `$to` path already exists or if the operation failed for some other reason, such as when `$to` and `$from` are the same file.
  
  To avoid copying, you can use [`rename`](/routine/rename), if the files are on the same storage device. It also works with directories, while `move` does not.
  