mirror of
https://github.com/SpaceVim/SpaceVim.git
synced 2025-01-24 05:20:04 +08:00
68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
---
|
|
title: "job 接口"
|
|
description: "兼容 neovim 和 vim 的异步协同接口，对于旧版 vim 采用非异步机制"
|
|
lang: zh
|
|
---
|
|
|
|
# [可用接口](../) >> job
|
|
|
|
<!-- vim-markdown-toc GFM -->
|
|
|
|
- [简介](#简介)
|
|
- [函数及变量](#函数及变量)
|
|
- [使用示例](#使用示例)
|
|
|
|
<!-- vim-markdown-toc -->
|
|
|
|
## 简介
|
|
|
|
`job` 接口提供了一套可以兼容 neovim 和 vim 的异步控制机制，具体实现模型是参考的 neovim 的模型。
|
|
|
|
## 函数及变量
|
|
|
|
| 名称 | 描述 |
|
|
| ------------------ | ---------------------------- |
|
|
| `start(cmd, argv)` | 开始一个 job, 并返回 job id. |
|
|
| `send(id, data)` | 传递数据至指定 id 的 job |
|
|
| `stop(id)` | 终止指定 id 的 job |
|
|
| `status(id)` | 查看指定 id 的 job 的状态 |
|
|
| `list()` | 列出所有 job |
|
|
|
|
以上这个 api 仅提供了基础的 job 函数，当你的脚本需要用到 job 高级功能时，建议直接使用 neovim 或 vim 内置函数。
|
|
|
|
## 使用示例
|
|
|
|
以下为通过该 API 异步执行命令 `python test.py`，并设置相关的回调函数：
|
|
|
|
```vim
|
|
" 导入 job API 并赋值给 s:JOB
|
|
let s:JOB = SpaceVim#api#import('job')
|
|
|
|
" 定义回调函数，这里定义了三个回调函数，分别对应 stdout stderr 以及 exit。
|
|
function! s:on_stdout(id, data, event) abort
|
|
" do something with stdout
|
|
endfunction
|
|
|
|
function! s:on_stderr(id, data, event) abort
|
|
" do something with stderr
|
|
endfunction
|
|
|
|
function! s:on_exit(id, data, event) abort
|
|
" handle exit code
|
|
endfunction
|
|
|
|
let cmd = ['python', 'test.py']
|
|
|
|
call s:JOB.start(cmd,
|
|
\ {
|
|
\ 'on_stdout' : function('s:on_stdout'),
|
|
\ 'on_stderr' : function('s:on_stderr'),
|
|
\ 'on_exit' : function('s:on_exit'),
|
|
\ }
|
|
\ )
|
|
```
|
|
|
|
以上代码可以在 vim 或者 neovim 中异步运行命令，甚至对于老版本的 vim 也兼容，但是在老版本 vim 中执行的时候不是异步的。
|
|
|
|
|