Diff to HTML by rtfpessoa

Files changed (5) hide show
  1. runtime/doc/builtin.txt +66 -1
  2. runtime/doc/options.txt +2 -1
  3. runtime/doc/usr_41.txt +3 -1
  4. runtime/doc/version9.txt +3 -1
  5. runtime/doc/vim9.txt +9 -8
runtime/doc/builtin.txt CHANGED
@@ -1,4 +1,4 @@
1
- *builtin.txt* For Vim version 9.1. Last change: 2025 Jan 06
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -72,6 +72,7 @@ base64_encode({blob}) String base64 encode the bytes in {blob}
72
  bindtextdomain({package}, {path})
73
  Bool bind text domain to specified path
74
  blob2list({blob}) List convert {blob} into a list of numbers
 
75
  browse({save}, {title}, {initdir}, {default})
76
  String put up a file requester
77
  browsedir({title}, {initdir}) String put up a directory requester
@@ -609,6 +610,8 @@ split({expr} [, {pat} [, {keepempty}]])
609
  sqrt({expr}) Float square root of {expr}
610
  srand([{expr}]) List get seed for |rand()|
611
  state([{what}]) String current state of Vim
 
 
612
  str2float({expr} [, {quoted}]) Float convert String to Float
613
  str2list({expr} [, {utf8}]) List convert each character of {expr} to
614
  ASCII/UTF-8 value
@@ -1289,6 +1292,38 @@ blob2list({blob}) *blob2list()*
1289
  <
1290
  Return type: list<any> or list<number>
1291
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1292
  *browse()*
1293
  browse({save}, {title}, {initdir}, {default})
1294
  Put up a file requester. This only works when "has("browse")"
@@ -10556,6 +10591,36 @@ state([{what}]) *state()*
10556
  Return type: |String|
10557
 
10558
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10559
  str2float({string} [, {quoted}]) *str2float()*
10560
  Convert String {string} to a Float. This mostly works the
10561
  same as when using a floating point number in an expression,
1
+ *builtin.txt* For Vim version 9.1. Last change: 2025 Jan 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
72
  bindtextdomain({package}, {path})
73
  Bool bind text domain to specified path
74
  blob2list({blob}) List convert {blob} into a list of numbers
75
+ blob2str({blob} [, {options}]) String convert {blob} into a String
76
  browse({save}, {title}, {initdir}, {default})
77
  String put up a file requester
78
  browsedir({title}, {initdir}) String put up a directory requester
610
  sqrt({expr}) Float square root of {expr}
611
  srand([{expr}]) List get seed for |rand()|
612
  state([{what}]) String current state of Vim
613
+ str2blob({string} [, {options}])
614
+ Blob convert {string} into a Blob
615
  str2float({expr} [, {quoted}]) Float convert String to Float
616
  str2list({expr} [, {utf8}]) List convert each character of {expr} to
617
  ASCII/UTF-8 value
1292
  <
1293
  Return type: list<any> or list<number>
1294
 
1295
+
1296
+ blob2str({blob} [, {options}]) *blob2str()*
1297
+ Return a String in the current 'encoding' by converting the
1298
+ bytes in {blob} into characters.
1299
+
1300
+ If {options} is not supplied, the current 'encoding' value is
1301
+ used to decode the bytes in {blob}.
1302
+
1303
+ The argument {options} is a |Dict| and supports the following
1304
+ items:
1305
+ encoding Decode the bytes in {blob} using this
1306
+ encoding. The value is a |String|. See
1307
+ |encoding-names| for the supported values.
1308
+ *E1515*
1309
+ An error is given and an empty string is returned if
1310
+ an invalid byte sequence is encountered in {blob},
1311
+
1312
+ Returns an empty String if blob is empty.
1313
+
1314
+ See also |str2blob()|
1315
+
1316
+ Examples: >
1317
+ blob2str(0z6162) returns "ab"
1318
+ blob2str(0zC2ABC2BB) returns "«»"
1319
+ blob2str(0zABBB, {'encoding': 'latin1'}) returns "«»"
1320
+ <
1321
+ Can also be used as a |method|: >
1322
+ GetBlob()->blob2str()
1323
+ <
1324
+ Return type: |String|
1325
+
1326
+
1327
  *browse()*
1328
  browse({save}, {title}, {initdir}, {default})
1329
  Put up a file requester. This only works when "has("browse")"
10591
  Return type: |String|
10592
 
10593
 
10594
+ str2blob({string} [, {options}]) *str2blob()*
10595
+ Return a Blob by converting the characters in {string} into
10596
+ bytes.
10597
+
10598
+ If {options} is not supplied, the current 'encoding' value is
10599
+ used to convert the characters in {string} into bytes.
10600
+
10601
+ The argument {options} is a |Dict| and supports the following
10602
+ items:
10603
+ encoding Encode the characters in {string} using this
10604
+ encoding. The value is a |String|. See
10605
+ |encoding-names| for the supported values.
10606
+
10607
+ An error is given and an empty blob is returned if the
10608
+ character encoding fails.
10609
+
10610
+ Returns an empty Blob if {string} is empty.
10611
+
10612
+ See also |blob2str()|
10613
+
10614
+ Examples: >
10615
+ str2blob("ab") returns 0z6162
10616
+ str2blob("«»") returns 0zC2ABC2BB
10617
+ str2blob("«»", {'encoding': 'latin1'}) returns 0zABBB
10618
+ <
10619
+ Can also be used as a |method|: >
10620
+ GetStr()->str2blob()
10621
+ <
10622
+ Return type: |Blob|
10623
+
10624
  str2float({string} [, {quoted}]) *str2float()*
10625
  Convert String {string} to a Float. This mostly works the
10626
  same as when using a floating point number in an expression,
runtime/doc/options.txt CHANGED
@@ -1,4 +1,4 @@
1
- *options.txt* For Vim version 9.1. Last change: 2025 Jan 12
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -5582,6 +5582,7 @@ A jump table for the options with a short description can be found at |Q_op|.
5582
  command recursion, see |E169|.
5583
  See also |:function|.
5584
  Also used for maximum depth of callback functions.
 
5585
 
5586
  *'maxmapdepth'* *'mmd'* *E223*
5587
  'maxmapdepth' 'mmd' number (default 1000)
1
+ *options.txt* For Vim version 9.1. Last change: 2025 Jan 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
5582
  command recursion, see |E169|.
5583
  See also |:function|.
5584
  Also used for maximum depth of callback functions.
5585
+ Also used for maximum depth of import. See |:import-cycle|.
5586
 
5587
  *'maxmapdepth'* *'mmd'* *E223*
5588
  'maxmapdepth' 'mmd' number (default 1000)
runtime/doc/usr_41.txt CHANGED
@@ -1,4 +1,4 @@
1
- *usr_41.txt* For Vim version 9.1. Last change: 2025 Jan 02
2
 
3
  VIM USER MANUAL - by Bram Moolenaar
4
 
@@ -801,6 +801,8 @@ String manipulation: *string-functions*
801
  trim() trim characters from a string
802
  bindtextdomain() set message lookup translation base path
803
  gettext() lookup message translation
 
 
804
 
805
  List manipulation: *list-functions*
806
  get() get an item without error for wrong index
1
+ *usr_41.txt* For Vim version 9.1. Last change: 2025 Jan 14
2
 
3
  VIM USER MANUAL - by Bram Moolenaar
4
 
801
  trim() trim characters from a string
802
  bindtextdomain() set message lookup translation base path
803
  gettext() lookup message translation
804
+ str2blob() convert a string into a blob
805
+ blob2str() convert a blob into a string
806
 
807
  List manipulation: *list-functions*
808
  get() get an item without error for wrong index
runtime/doc/version9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *version9.txt* For Vim version 9.1. Last change: 2025 Jan 12
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -41638,6 +41638,7 @@ Functions: ~
41638
 
41639
  |base64_decode()| decode a base64 string into a blob
41640
  |base64_encode()| encode a blob into a base64 string
 
41641
  |bindtextdomain()| set message lookup translation base path
41642
  |diff()| diff two Lists of strings
41643
  |filecopy()| copy a file {from} to {to}
@@ -41653,6 +41654,7 @@ Functions: ~
41653
  |matchbufline()| all the matches of a pattern in a buffer
41654
  |matchstrlist()| all the matches of a pattern in a List of strings
41655
  |popup_setbuf()| switch to a different buffer in a popup
 
41656
 
41657
 
41658
  Autocommands: ~
1
+ *version9.txt* For Vim version 9.1. Last change: 2025 Jan 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
41638
 
41639
  |base64_decode()| decode a base64 string into a blob
41640
  |base64_encode()| encode a blob into a base64 string
41641
+ |blob2str()| convert a blob into a string
41642
  |bindtextdomain()| set message lookup translation base path
41643
  |diff()| diff two Lists of strings
41644
  |filecopy()| copy a file {from} to {to}
41654
  |matchbufline()| all the matches of a pattern in a buffer
41655
  |matchstrlist()| all the matches of a pattern in a List of strings
41656
  |popup_setbuf()| switch to a different buffer in a popup
41657
+ |str2blob()| convert a string into a blob
41658
 
41659
 
41660
  Autocommands: ~
runtime/doc/vim9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *vim9.txt* For Vim version 9.1. Last change: 2024 Dec 23
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2051,13 +2051,14 @@ prefixing the function with |<SID>| you should use|<ScriptCmd>|. For example:
2051
  >
2052
  noremap ,a <ScriptCmd>:call s:that.OtherFunc()<CR>
2053
  <
2054
- *:import-cycle*
2055
- The `import` commands are executed when encountered. If script A imports
2056
- script B, and B (directly or indirectly) imports A, this will be skipped over.
2057
- At this point items in A after "import B" will not have been processed and
2058
- defined yet. Therefore cyclic imports can exist and not result in an error
2059
- directly, but may result in an error for items in A after "import B" not being
2060
- defined. This does not apply to autoload imports, see the next section.
 
2061
 
2062
 
2063
  Importing an autoload script ~
1
+ *vim9.txt* For Vim version 9.1. Last change: 2025 Jan 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
2051
  >
2052
  noremap ,a <ScriptCmd>:call s:that.OtherFunc()<CR>
2053
  <
2054
+ *:import-cycle* *E1045*
2055
+ The `import` commands are executed when encountered. It can be nested up to
2056
+ 'maxfuncdepth' levels deep. If script A imports script B, and B (directly or
2057
+ indirectly) imports A, this will be skipped over. At this point items in A
2058
+ after "import B" will not have been processed and defined yet. Therefore
2059
+ cyclic imports can exist and not result in an error directly, but may result
2060
+ in an error for items in A after "import B" not being defined. This does not
2061
+ apply to autoload imports, see the next section.
2062
 
2063
 
2064
  Importing an autoload script ~