From c1ac57888199ba13df7eda4912cdb53dcfb5a2ee Mon Sep 17 00:00:00 2001 From: Vse Mozhet Byt Date: Thu, 17 Jan 2019 13:09:02 +0200 Subject: [PATCH] doc: add a note to `buf.fill()` description PR-URL: https://github.com/nodejs/node/pull/25547 Reviewed-By: Anna Henningsen Reviewed-By: Anto Aravinth Reviewed-By: James M Snell --- doc/api/buffer.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/api/buffer.md b/doc/api/buffer.md index 0a73a1d8a9afd5..49766866dc6586 100644 --- a/doc/api/buffer.md +++ b/doc/api/buffer.md @@ -1238,7 +1238,9 @@ console.log(b.toString()); // Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh ``` -`value` is coerced to a `uint32` value if it is not a string or integer. +`value` is coerced to a `uint32` value if it is not a string, `Buffer`, or +integer. If the resulting integer is greater than `255` (decimal), `buf` will be +filled with `0`. If the final write of a `fill()` operation falls on a multi-byte character, then only the bytes of that character that fit into `buf` are written: