# Method Stdio.async_cp()

Method async_cp

  ``void` async_cp(`string` `from`, `string` `to`, `function`(`int`, `mixed` ... :`void`) `callback`, `mixed` ... `args`)`

Description

  Copy a file asynchronously.

  This function is similar to cp(), but works asynchronously.

Parameter `from`

  Name of file to copy.

Parameter `to`

  Name of file to create or replace with a copy of `from`.

Parameter `callback`

  Function to be called on completion. The first argument will be `1` on success, and `0` (zero) otherwise. The rest of the arguments to `callback` are passed verbatim from `args`.

Parameter `args`

  Extra arguments to pass to `callback`.

Note

  For `callback` to be called, the backend must be active (ie `main()` must have returned `-1`, or Pike.DefaultBackend get called in some other way). The actual copying may start before the backend has activated.

Bugs

  Currently the file sizes are not compared, so the destination file (`to`) may be truncated.

See also

  cp(), sendfile()