mirror of
https://github.com/inkarkat/vim-ingo-library.git
synced 2026-05-29 11:18:51 +02:00
Ingo Karkat
55 lines
2.0 KiB
VimL
55 lines
2.0 KiB
VimL
" ingo/escape/command.vim: Additional escapings of Ex commands.
|
|
"
|
|
" DEPENDENCIES:
|
|
"
|
|
" Copyright: (C) 2013-2016 Ingo Karkat
|
|
" The VIM LICENSE applies to this script; see ':help copyright'.
|
|
"
|
|
" Maintainer: Ingo Karkat <ingo@karkat.de>
|
|
"
|
|
" REVISION DATE REMARKS
|
|
" 1.025.002 29-Apr-2016 Add ingo#escape#command#mapunescape().
|
|
" 1.012.001 09-Aug-2013 file creation
|
|
|
|
function! ingo#escape#command#mapescape( command )
|
|
"******************************************************************************
|
|
"* PURPOSE:
|
|
" Escape the Ex command a:command for use in the right-hand side of a mapping.
|
|
" If you want to redefine an existing mapping, use ingo#compat#maparg()
|
|
" instead; it already returns this in the correct format.
|
|
"* ASSUMPTIONS / PRECONDITIONS:
|
|
" None.
|
|
"* EFFECTS / POSTCONDITIONS:
|
|
" None.
|
|
"* INPUTS:
|
|
" a:command Ex command(s).
|
|
"* RETURN VALUES:
|
|
" a:command for use in a :map command.
|
|
"******************************************************************************
|
|
let l:command = a:command
|
|
let l:command = substitute(l:command, '<', '<lt>', 'g') " '<' may introduce a special-notation key; better escape them all.
|
|
let l:command = substitute(l:command, '|', '<Bar>', 'g') " '|' must be escaped, or the map command will end prematurely.
|
|
return l:command
|
|
endfunction
|
|
|
|
function! ingo#escape#command#mapunescape( command )
|
|
"******************************************************************************
|
|
"* PURPOSE:
|
|
" Unescape special mapping characters (<Bar>, <lt>) in a:command.
|
|
"* ASSUMPTIONS / PRECONDITIONS:
|
|
" None.
|
|
"* EFFECTS / POSTCONDITIONS:
|
|
" None.
|
|
"* INPUTS:
|
|
" a:command Ex command(s).
|
|
"* RETURN VALUES:
|
|
" a:command for use in a :map command.
|
|
"******************************************************************************
|
|
let l:command = a:command
|
|
let l:command = substitute(l:command, '<lt>', '<', 'g')
|
|
let l:command = substitute(l:command, '<Bar>', '|', 'g')
|
|
return l:command
|
|
endfunction
|
|
|
|
" vim: set ts=8 sts=4 sw=4 noexpandtab ff=unix fdm=syntax :
|