@@ -1745,6 +1745,14 @@ v:cmdbang Set like v:cmdarg for a file read/write command. When a "!"
17451745 was used the value is 1, otherwise it is 0. Note that this
17461746 can only be used in autocommands. For user commands |<bang>|
17471747 can be used.
1748+ *v:collate* *collate-variable*
1749+ v:collate The current locale setting for collation order of the runtime
1750+ environment. This allows Vim scripts to be aware of the
1751+ current locale encoding. Technical: it's the value of
1752+ LC_COLLATE. When not using a locale the value is "C".
1753+ This variable can not be set directly, use the |:language|
1754+ command.
1755+ See |multi-lang|.
17481756
17491757 *v:completed_item* *completed_item-variable*
17501758v:completed_item
@@ -2683,8 +2691,10 @@ pyxeval({expr}) any evaluate |python_x| expression
26832691rand([{expr}]) Number get pseudo-random number
26842692range({expr} [, {max} [, {stride}]])
26852693 List items from {expr} to {max}
2686- readdir({dir} [, {expr}]) List file names in {dir} selected by {expr}
2687- readdirex({dir} [, {expr}]) List file info in {dir} selected by {expr}
2694+ readdir({dir} [, {expr} [, {dict}]])
2695+ List file names in {dir} selected by {expr}
2696+ readdirex({dir} [, {expr} [, {dict}]])
2697+ List file info in {dir} selected by {expr}
26882698readfile({fname} [, {type} [, {max}]])
26892699 List get list of lines from file {fname}
26902700reduce({object}, {func} [, {initial}])
@@ -7904,11 +7914,12 @@ rand([{expr}]) *rand()* *random*
79047914 :echo rand(seed)
79057915 :echo rand(seed) % 16 " random number 0 - 15
79067916<
7907- readdir({directory} [, {expr}]) *readdir()*
7917+ readdir({directory} [, {expr} [, {dict}]]) *readdir()*
79087918 Return a list with file and directory names in {directory}.
79097919 You can also use |glob()| if you don't need to do complicated
79107920 things, such as limiting the number of matches.
7911- The list will be sorted (case sensitive).
7921+ The list will be sorted (case sensitive), see the {dict}
7922+ argument below for changing the sort order.
79127923
79137924 When {expr} is omitted all entries are included.
79147925 When {expr} is given, it is evaluated to check what to do:
@@ -7926,18 +7937,38 @@ readdir({directory} [, {expr}]) *readdir()*
79267937< To skip hidden and backup files: >
79277938 readdir(dirname, {n -> n !~ '^\.\|\~$'})
79287939
7940+ < The optional {dict} argument allows for further custom
7941+ values. Currently this is used to specify if and how sorting
7942+ should be performed. The dict can have the following members:
7943+
7944+ sort How to sort the result returned from the system.
7945+ Valid values are:
7946+ "none" do not sort (fastest method)
7947+ "case" sort case sensitive (byte value of
7948+ each character, technically, using
7949+ strcmp()) (default)
7950+ "icase" sort case insensitive (technically
7951+ using strcasecmp())
7952+ "collate" sort using the collation order
7953+ of the "POSIX" or "C" |locale|
7954+ (technically using strcoll())
7955+ Other values are silently ignored.
7956+
7957+ For example, to get a list of all files in the current
7958+ directory without sorting the individual entries: >
7959+ readdir('.', '1', #{sort: 'none'})
79297960< If you want to get a directory tree: >
7930- function! s:tree(dir)
7931- return {a:dir : map(readdir(a:dir),
7961+ function! s:tree(dir)
7962+ return {a:dir : map(readdir(a:dir),
79327963 \ {_, x -> isdirectory(x) ?
7933- \ {x : s:tree(a:dir . '/' . x)} : x})}
7934- endfunction
7935- echo s:tree(".")
7964+ \ {x : s:tree(a:dir . '/' . x)} : x})}
7965+ endfunction
7966+ echo s:tree(".")
79367967<
79377968 Can also be used as a |method|: >
79387969 GetDirName()->readdir()
79397970<
7940- readdirex({directory} [, {expr}]) *readdirex()*
7971+ readdirex({directory} [, {expr} [, {dict}] ]) *readdirex()*
79417972 Extended version of |readdir()|.
79427973 Return a list of Dictionaries with file and directory
79437974 information in {directory}.
@@ -7946,7 +7977,9 @@ readdirex({directory} [, {expr}]) *readdirex()*
79467977 This is much faster than calling |readdir()| then calling
79477978 |getfperm()|, |getfsize()|, |getftime()| and |getftype()| for
79487979 each file and directory especially on MS-Windows.
7949- The list will be sorted by name (case sensitive).
7980+ The list will by default be sorted by name (case sensitive),
7981+ the sorting can be changed by using the optional {dict}
7982+ argument, see |readdir()|.
79507983
79517984 The Dictionary for file and directory information has the
79527985 following items:
@@ -7986,6 +8019,11 @@ readdirex({directory} [, {expr}]) *readdirex()*
79868019 When {expr} is a function the entry is passed as the argument.
79878020 For example, to get a list of files ending in ".txt": >
79888021 readdirex(dirname, {e -> e.name =~ '.txt$'})
8022+ <
8023+ For example, to get a list of all files in the current
8024+ directory without sorting the individual entries: >
8025+ readdirex(dirname, '1', #{sort: 'none'})
8026+
79898027<
79908028 Can also be used as a |method|: >
79918029 GetDirName()->readdirex()
0 commit comments