@@ -862,31 +862,6 @@ console.log(buf2.toString()); |
862 | 862 |
|
863 | 863 | A `TypeError` will be thrown if `buffer` is not a `Buffer`. |
864 | 864 |
|
865 | | -### Class Method: Buffer.from(string[, encoding]) |
866 | | -<!-- YAML |
867 | | -added: v5.10.0 |
868 | | ---> |
869 | | - |
870 | | -* `string` {string} A string to encode. |
871 | | -* `encoding` {string} The encoding of `string`. **Default:** `'utf8'`. |
872 | | - |
873 | | -Creates a new `Buffer` containing `string`. The `encoding` parameter identifies |
874 | | -the character encoding of `string`. |
875 | | - |
876 | | -```js |
877 | | -const buf1 = Buffer.from('this is a tést'); |
878 | | -const buf2 = Buffer.from('7468697320697320612074c3a97374', 'hex'); |
879 | | - |
880 | | -console.log(buf1.toString()); |
881 | | -// Prints: this is a tést |
882 | | -console.log(buf2.toString()); |
883 | | -// Prints: this is a tést |
884 | | -console.log(buf1.toString('ascii')); |
885 | | -// Prints: this is a tC)st |
886 | | -``` |
887 | | - |
888 | | -A `TypeError` will be thrown if `string` is not a string. |
889 | | - |
890 | 865 | ### Class Method: Buffer.from(object[, offsetOrEncoding[, length]]) |
891 | 866 | <!-- YAML |
892 | 867 | added: v8.2.0 |
@@ -921,6 +896,31 @@ const buf = Buffer.from(new Foo(), 'utf8'); |
921 | 896 | // Prints: <Buffer 74 68 69 73 20 69 73 20 61 20 74 65 73 74> |
922 | 897 | ``` |
923 | 898 |
|
| 899 | +### Class Method: Buffer.from(string[, encoding]) |
| 900 | +<!-- YAML |
| 901 | +added: v5.10.0 |
| 902 | +--> |
| 903 | + |
| 904 | +* `string` {string} A string to encode. |
| 905 | +* `encoding` {string} The encoding of `string`. **Default:** `'utf8'`. |
| 906 | + |
| 907 | +Creates a new `Buffer` containing `string`. The `encoding` parameter identifies |
| 908 | +the character encoding of `string`. |
| 909 | + |
| 910 | +```js |
| 911 | +const buf1 = Buffer.from('this is a tést'); |
| 912 | +const buf2 = Buffer.from('7468697320697320612074c3a97374', 'hex'); |
| 913 | + |
| 914 | +console.log(buf1.toString()); |
| 915 | +// Prints: this is a tést |
| 916 | +console.log(buf2.toString()); |
| 917 | +// Prints: this is a tést |
| 918 | +console.log(buf1.toString('ascii')); |
| 919 | +// Prints: this is a tC)st |
| 920 | +``` |
| 921 | + |
| 922 | +A `TypeError` will be thrown if `string` is not a string. |
| 923 | + |
924 | 924 | ### Class Method: Buffer.isBuffer(obj) |
925 | 925 | <!-- YAML |
926 | 926 | added: v0.1.101 |
@@ -2642,6 +2642,9 @@ in UTF-16 code units. |
2642 | 2642 |
|
2643 | 2643 | This value may depend on the JS engine that is being used. |
2644 | 2644 |
|
| 2645 | +[RFC1345]: https://tools.ietf.org/html/rfc1345 |
| 2646 | +[RFC4648, Section 5]: https://tools.ietf.org/html/rfc4648#section-5 |
| 2647 | +[WHATWG Encoding Standard]: https://encoding.spec.whatwg.org/ |
2645 | 2648 | [`ArrayBuffer#slice()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/slice |
2646 | 2649 | [`ArrayBuffer`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer |
2647 | 2650 | [`Buffer.alloc()`]: #buffer_class_method_buffer_alloc_size_fill_encoding |
@@ -2678,7 +2681,4 @@ This value may depend on the JS engine that is being used. |
2678 | 2681 | [`buffer.constants.MAX_STRING_LENGTH`]: #buffer_buffer_constants_max_string_length |
2679 | 2682 | [`buffer.kMaxLength`]: #buffer_buffer_kmaxlength |
2680 | 2683 | [`util.inspect()`]: util.html#util_util_inspect_object_options |
2681 | | -[RFC1345]: https://tools.ietf.org/html/rfc1345 |
2682 | | -[RFC4648, Section 5]: https://tools.ietf.org/html/rfc4648#section-5 |
2683 | | -[WHATWG Encoding Standard]: https://encoding.spec.whatwg.org/ |
2684 | 2684 | [iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols |