Prepare NEWS file for next release
[libmodbus.git] / docs / modbus_write_registers.md
blob0b1d6a8b35ce3e7f66a3abd9410b380ba0d37e60
1 # modbus_write_registers
3 ## Name
5 modbus_write_registers - write many registers
7 ## Synopsis
9 ```c
10 int modbus_write_registers(modbus_t *ctx, int addr, int nb, const uint16_t *src);
11 ```
13 ## Description
15 The *modbus_write_registers()* function shall write the content of the `nb`
16 holding registers from the array `src` at address `addr` of the remote device.
18 The function uses the Modbus function code 0x10 (preset multiple registers).
20 ## Return value
22 The function shall return the number of written registers if
23 successful. Otherwise it shall return -1 and set errno.
25 ## See also
27 - [modbus_write_register](modbus_write_register.md)
28 - [modbus_read_registers](modbus_read_registers.md)