comparison runtime/doc/eval.txt @ 5808:e5f1f2ea0b4a v7.4.248

updated for version 7.4.248 Problem: Cannot distinguish between NL and NUL in output of system(). Solution: Add systemlist(). (ZyX)
author Bram Moolenaar <bram@vim.org>
date Sat, 05 Apr 2014 19:44:40 +0200
parents 76863b4b48a3
children 755931e042e4
comparison
equal deleted inserted replaced
5807:0c34ebb94be0 5808:e5f1f2ea0b4a
2000 String attribute {what} of syntax ID {synID} 2000 String attribute {what} of syntax ID {synID}
2001 synIDtrans( {synID}) Number translated syntax ID of {synID} 2001 synIDtrans( {synID}) Number translated syntax ID of {synID}
2002 synconcealed( {lnum}, {col}) List info about concealing 2002 synconcealed( {lnum}, {col}) List info about concealing
2003 synstack( {lnum}, {col}) List stack of syntax IDs at {lnum} and {col} 2003 synstack( {lnum}, {col}) List stack of syntax IDs at {lnum} and {col}
2004 system( {expr} [, {input}]) String output of shell command/filter {expr} 2004 system( {expr} [, {input}]) String output of shell command/filter {expr}
2005 systemlist( {expr} [, {input}]) List output of shell command/filter {expr}
2005 tabpagebuflist( [{arg}]) List list of buffer numbers in tab page 2006 tabpagebuflist( [{arg}]) List list of buffer numbers in tab page
2006 tabpagenr( [{arg}]) Number number of current or last tab page 2007 tabpagenr( [{arg}]) Number number of current or last tab page
2007 tabpagewinnr( {tabarg}[, {arg}]) 2008 tabpagewinnr( {tabarg}[, {arg}])
2008 Number number of current window in tab page 2009 Number number of current window in tab page
2009 taglist( {expr}) List list of tags matching {expr} 2010 taglist( {expr}) List list of tags matching {expr}
5961 nothing is returned. The position just after the last 5962 nothing is returned. The position just after the last
5962 character in a line and the first column in an empty line are 5963 character in a line and the first column in an empty line are
5963 valid positions. 5964 valid positions.
5964 5965
5965 system({expr} [, {input}]) *system()* *E677* 5966 system({expr} [, {input}]) *system()* *E677*
5966 Get the output of the shell command {expr}. 5967 Get the output of the shell command {expr} as a string. See
5968 |systemlist()| to get the output as a List.
5967 5969
5968 When {input} is given and is a string this string is written 5970 When {input} is given and is a string this string is written
5969 to a file and passed as stdin to the command. The string is 5971 to a file and passed as stdin to the command. The string is
5970 written as-is, you need to take care of using the correct line 5972 written as-is, you need to take care of using the correct line
5971 separators yourself. 5973 separators yourself.
6007 Note that any wrong value in the options mentioned above may 6009 Note that any wrong value in the options mentioned above may
6008 make the function fail. It has also been reported to fail 6010 make the function fail. It has also been reported to fail
6009 when using a security agent application. 6011 when using a security agent application.
6010 Unlike ":!cmd" there is no automatic check for changed files. 6012 Unlike ":!cmd" there is no automatic check for changed files.
6011 Use |:checktime| to force a check. 6013 Use |:checktime| to force a check.
6014
6015
6016 systemlist({expr} [, {input}]) *systemlist()*
6017 Same as |system()|, but returns a |List| with lines (parts of
6018 output separated by NL) with NULs transformed into NLs. Output
6019 is the same as |readfile()| will output with {binary} argument
6020 set to "b".
6021
6022 Returns an empty string on error, so be careful not to run
6023 into |E706|.
6012 6024
6013 6025
6014 tabpagebuflist([{arg}]) *tabpagebuflist()* 6026 tabpagebuflist([{arg}]) *tabpagebuflist()*
6015 The result is a |List|, where each item is the number of the 6027 The result is a |List|, where each item is the number of the
6016 buffer associated with each window in the current tab page. 6028 buffer associated with each window in the current tab page.