This is a vim plugin that helps you transpose (in the sense of matrix transposition) blocks of text, words, delimited text, or lines that you can tokenize with a custom pattern.
vim-transpose is written in pure VimL (no need for Python nor Perl).
Five commands are provided:
:Transpose(for character array transposition),
:TransposeWords(for word array transposition),
:TransposeTab(for tab-separated table transposition),
:TransposeCSV(for general delimited text transposition), and
:TransposeInteractive(for custom transposition).
An additional variable,
g:transpose_keepindent controls whether the plugin
should detect indentation of the range. The
will toggle this variable.
If you have the Pathogen plugin installed or any other plugin manager, then just copy this filetree into a subfolder of your Bundle folder.
Otherwise, copy the contents of the
After having built help tags (run
:Helptags if you have pathogen installed)
:help transpose-tutorial, and follow the instructions. If you don't have
pathogen installed and don't know how to build the help tags, just open
doc/transpose.txt inside vim.
Example use cases
This plugin can be useful:
- When you have tabular data (for example, pasted from a spreadsheet
application) and you need to remove or swap columns: using regular
expressions should be more difficult than using
:TransposeTab, perform the operations on lines instead of columns, and
- When you need to ensure that tabular data has a consistent number of
columns: since transposition will create missing fields such that it
operates on a rectangular matrix, running twice a
:Transpose… command will create the missing fields.
The main git repository for this plugin is at
Copyright (c) 2012 Benoit Mortgat
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
This notice may not be removed or altered from any source distribution.