Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/machakann/vim-textobj-delimited
A textobject plugin to do well with each delimited part of a string.
https://github.com/machakann/vim-textobj-delimited
Last synced: 1 day ago
JSON representation
A textobject plugin to do well with each delimited part of a string.
- Host: GitHub
- URL: https://github.com/machakann/vim-textobj-delimited
- Owner: machakann
- Created: 2014-05-16T15:06:43.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-09-05T11:21:53.000Z (over 7 years ago)
- Last Synced: 2024-11-18T02:16:28.111Z (2 months ago)
- Language: Vim script
- Homepage:
- Size: 64.5 KB
- Stars: 49
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
textobj-delimited
=================
[](https://travis-ci.org/machakann/vim-textobj-delimited)
[](https://ci.appveyor.com/project/machakann/vim-textobj-delimited/branch/master)
The textobject plugin to do well with each delimited parts of string.
# Brief explanation
This textobject provides the keymappings to select a part of a delimited string. `id`, `ad`, `iD`, `aD` is used in default. Please see following examples and doc/textobj-delimited.txt.
# Examples
```
------------------------------------------------
key input: did
# # : cursor
'foo_bar_baz' -> '_bar_baz'
------------------------------------------------
key input: did
# # : cursor
'foo_bar_baz' -> 'foo__baz'
------------------------------------------------
key input: did
# # : cursor
'foo_bar_baz' -> 'foo_bar_'
------------------------------------------------
key input: d1id
# # : cursor
'foo_bar_baz' -> '_bar_baz'
------------------------------------------------
key input: d2id
# # : cursor
'foo_bar_baz' -> 'foo__baz'
------------------------------------------------
key input: d3id
# # : cursor
'foo_bar_baz' -> 'foo_bar_'
------------------------------------------------
key input: dad
# # : cursor
'foo_bar_baz' -> 'bar_baz'
------------------------------------------------
key input: dad
# # : cursor
'foo_bar_baz' -> 'foo_baz'
------------------------------------------------
key input: dad
# # : cursor
'foo_bar_baz' -> 'foo_bar'
------------------------------------------------
key input: d1ad
# # : cursor
'foo_bar_baz' -> 'bar_baz'
------------------------------------------------
key input: d2ad
# # : cursor
'foo_bar_baz' -> 'foo_baz'
------------------------------------------------
key input: d3ad
# # : cursor
'foo_bar_baz' -> 'foo_bar'
------------------------------------------------
```
---
When delimited parts are being selected in visual mode, this textobject behave differently from usual, expanding selection area like viwiwiw...
Assume the situation as following:
```
|<-->| : selected area
abcdef_ghijkl_mnopqr
```
If you use `id`, then you will get:
```
|<--------->| : selected area
abcdef_ghijkl_mnopqr
```
If you use `iD`, then you will get:
```
|<--------->| : selected area
abcdef_ghijkl_mnopqr
```
---
At the beginning of a word, `ad` and `aD` work tricky. Look the following examples.
If you use `dad`, the cut strings are different for '\_abc\_def\_ghi\_' and 'abc\_def\_ghi'.
```
# # : cursor
_abc_def_ghi_ -> _def_ghi_ (cut '_abc')
# # : cursor
abc_def_ghi -> def_ghi (cut 'abc_')
```
Thus, if a word has ended delimiters like '\_abc\_def\_ghi\_', ended delimiters would be preserved. If a word has no ended delimiters like 'abc\_def\_ghi', ended delimiters would not appear. `dad` keeps the exsistence/nonexistence of ended delimiters.