---
title: async / async_write
---
# async_write

### NAME

    async_write() - appends a string to a file then executes a callback

### SYNOPSIS

    void async_write( string file, string str, int flag, function callback );

### DESCRIPTION

    Append  the string 'str' into the file 'file'. If flag is 1, write_file
    overwrites instead of appending.

    Unlike write_file, which returns 0 for failure or 1 for success, this efun
    will return -1 for failure and 0 for success to the callback.

    The callback should follow this format:

        function (int res) {
            // -1 for failure
            //  0 for success
        }

### NOTE

    When the 'this_player in call_out' driver setting is enabled,
    this_player() inside the callback is preserved from the time the
    request was made, like call_out().

### SEE ALSO

    file_size(3), read_file(3), write_buffer(3), write_file(3), async_read(3),
    valid_read(4), valid_write(4)