2 " @Author: Thomas Link (micathom AT gmail com?subject=[vim])
3 " @Website: http://www.vim.org/account/profile.php?user_id=4037
4 " @License: GPL (see http://www.gnu.org/licenses/gpl.txt)
5 " @Created: 2007-06-30.
6 " @Last Change: 2008-06-15.
9 if &cp || exists("loaded_tlib_arg_autoload")
12 let loaded_tlib_arg_autoload = 1
15 " :def: function! tlib#arg#Get(n, var, ?default="", ?test='')
16 " Set a positional argument from a variable argument list.
17 " See tlib#string#RemoveBackslashes() for an example.
18 function! tlib#arg#Get(n, var, ...) "{{{3
19 let default = a:0 >= 1 ? a:1 : ''
20 let atest = a:0 >= 2 ? a:2 : ''
21 " TLogVAR default, atest
23 let atest = ' && (a:'. a:n .' '. atest .')'
25 let test = printf('a:0 >= %d', a:n) . atest
26 return printf('let %s = %s ? a:%d : %s', a:var, test, a:n, string(default))
30 " :def: function! tlib#arg#Let(list, ?default='')
31 " Set a positional arguments from a variable argument list.
32 " See tlib#input#List() for an example.
33 function! tlib#arg#Let(list, ...) "{{{3
34 let default = a:0 >= 1 ? a:1 : ''
35 let list = map(copy(a:list), 'type(v:val) == 3 ? v:val : [v:val, default]')
36 let args = map(range(1, len(list)), 'call("tlib#arg#Get", [v:val] + list[v:val - 1])')
37 return join(args, ' | ')
41 " :def: function! tlib#arg#Key(dict, list, ?default='')
43 function! tlib#arg#Key(list, ...) "{{{3
44 let default = a:0 >= 1 ? a:1 : ''
46 let list = map(copy(a:list[1:-1]), 'type(v:val) == 3 ? v:val : [v:val, default]')
47 let args = map(list, '"let ". v:val[0] ." = ". string(get(dict, v:val[0], v:val[1]))')
48 " TLogVAR dict, list, args
49 return join(args, ' | ')
53 " :def: function! tlib#arg#StringAsKeyArgs(string, ?keys=[], ?evaluate=0)
54 function! tlib#arg#StringAsKeyArgs(string, ...) "{{{1
55 TVarArg ['keys', {}], ['evaluate', 0]
57 let args = split(a:string, '\\\@<! ')
58 let arglist = map(args, 'matchlist(v:val, ''^\(\w\+\):\(.*\)$'')')
59 " TLogVAR a:string, args, arglist
60 for matchlist in arglist
62 throw 'Malformed key arguments: '. string(matchlist) .' in '. a:string
64 let [match, key, val; rest] = matchlist
65 if empty(keys) || has_key(keys, key)
66 let val = substitute(val, '\\\\', '\\', 'g')
70 let keyargs[key] = val
72 echom 'Unknown key: '. key .'='. val
82 " :def: function! tlib#arg#Ex(arg, ?chars='%#! ')
83 " Escape some characters in a string.
85 " Use |fnamescape()| if available.
88 " exec 'edit '. tlib#arg#Ex('foo%#bar.txt')
89 function! tlib#arg#Ex(arg, ...) "{{{3
90 if exists('*fnameescape') && a:0 == 0
91 return fnameescape(a:arg)
98 return escape(a:arg, chars)