Home Explore Blog CI



neovim

10th chunk of `runtime/doc/api.txt`
1598e289053f62a29e8605d9f15c0a63605049e82bc461a60000000100000fd8
 (optional) name or ID `hl_group`.
      • {history}  if true, add to |message-history|.
      • {opts}     Optional parameters.
                   • err: Treat the message like `:echoerr`. Sets `hl_group`
                     to |hl-ErrorMsg| by default.
                   • kind: Set the |ui-messages| kind with which this message
                     will be emitted.
                   • verbose: Message is controlled by the 'verbose' option.
                     Nvim invoked with `-V3log` will write the message to the
                     "log" file instead of standard output.

nvim_eval_statusline({str}, {opts})                   *nvim_eval_statusline()*
    Evaluates statusline string.

    Attributes: ~
        |api-fast|
        Since: 0.6.0

    Parameters: ~
      • {str}   Statusline string (see 'statusline').
      • {opts}  Optional parameters.
                • winid: (number) |window-ID| of the window to use as context
                  for statusline.
                • maxwidth: (number) Maximum width of statusline.
                • fillchar: (string) Character to fill blank spaces in the
                  statusline (see 'fillchars'). Treated as single-width even
                  if it isn't.
                • highlights: (boolean) Return highlight information.
                • use_winbar: (boolean) Evaluate winbar instead of statusline.
                • use_tabline: (boolean) Evaluate tabline instead of
                  statusline. When true, {winid} is ignored. Mutually
                  exclusive with {use_winbar}.
                • use_statuscol_lnum: (number) Evaluate statuscolumn for this
                  line number instead of statusline.

    Return: ~
        Dict containing statusline information, with these keys:
        • str: (string) Characters that will be displayed on the statusline.
        • width: (number) Display width of the statusline.
        • highlights: Array containing highlight information of the
          statusline. Only included when the "highlights" key in {opts} is
          true. Each element of the array is a |Dict| with these keys:
          • start: (number) Byte index (0-based) of first character that uses
            the highlight.
          • group: (string) Deprecated. Use `groups` instead.
          • groups: (array) Names of stacked highlight groups (highest
            priority last).

nvim_exec_lua({code}, {args})                                *nvim_exec_lua()*
    Execute Lua code. Parameters (if any) are available as `...` inside the
    chunk. The chunk can return a value.

    Only statements are executed. To evaluate an expression, prefix it with
    `return`: return my_function(...)

    Attributes: ~
        |RPC| only
        Since: 0.5.0

    Parameters: ~
      • {code}  Lua code to execute
      • {args}  Arguments to the code

    Return: ~
        Return value of Lua code if present or NIL.

nvim_feedkeys({keys}, {mode}, {escape_ks})                   *nvim_feedkeys()*
    Sends input-keys to Nvim, subject to various quirks controlled by `mode`
    flags. This is a blocking call, unlike |nvim_input()|.

    On execution error: does not fail, but updates v:errmsg.

    To input sequences like <C-o> use |nvim_replace_termcodes()| (typically
    with escape_ks=false) to replace |keycodes|, then pass the result to
    nvim_feedkeys().

    Example: >vim
        :let key = nvim_replace_termcodes("<C-o>", v:true, v:false, v:true)
        :call nvim_feedkeys(key, 'n', v:false)
<

    Attributes: ~
        Since: 0.1.0

    Parameters: ~
      • {keys}       to be typed
      • {mode}       behavior flags, see |feedkeys()|
      • {escape_ks}  If true, escape K_SPECIAL bytes in `keys`. This should be
                     false if you already used |nvim_replace_termcodes()|, and
                     true otherwise.

    See also: ~
      • feedkeys()
      • vim_strsave_escape_ks

nvim_get_api_info()                                      *nvim_get_api_info()*

Title: Nvim API: Global Functions (Continued)
Summary
This section continues detailing global functions in the Nvim API, including expanded descriptions of `nvim_echo()` and `nvim_eval_statusline()`. It also includes `nvim_exec_lua()` for executing Lua code, `nvim_feedkeys()` for sending input keys to Nvim, and `nvim_get_api_info()`.