---
source_url: https://docs.dolphindb.cn/zh/funcs/w/writeBytes.html
fetched_at: 2026-05-19T09:44:07Z
category: funcs
title: writeBytes
sha1: 394771e125c89389c93227ebca1ed189c5e01306
---

# writeBytes

## 语法

`writeBytes(handle, bytes)`

## 详情

`writeBytes`
函数把整个缓冲区写入文件。缓冲区必须是一个字符标量或字符向量。如果操作成功，函数返回实际写入的字节数；否则，抛出一个 IOException。

## 参数

**handle** 文件句柄，表示写入的目标文件。

**bytes** 字符类型标量或向量，表示要写入的数据对象。

## 返回值

整型标量。

## 例子

```dolphindb
// 定义一个文件复制函数
def fileCopy(source, target){
   s = file(source)
   len = s.seek(0,TAIL)
   s.seek(0,HEAD)
   t = file(target,"w")
   if(len==0) return
   do{
       buf = s.readBytes(min(len,1024))
       t.writeBytes(buf)
       len -= buf.size()
   }while(len)
};

fileCopy("test.txt","testcopy.txt");
```
