# fs.create_file

## Function

Creates a file and writes optional initial content.

## Syntax

```bt
fs(path).create_file(content)
```

## Parameters

| Parameters | Type | Required | Default value | Description |
| ------ | ------ | ------ | ------ | ------ |
| content | Any | No | '' | Initial content. |

## Return value

| Type | Description |
| ------ | ------ |
| Int | Returns the number of bytes written. |

## Example

```bt
file = fs('docs-create.txt')
result = file.create_file('BT')

// Output: 2
print result
```

## Notes

- Files with the same name will be overwritten.