Home Explore Blog CI



neovim

13th chunk of `runtime/doc/api.txt`
ed0900821716034251f5dde170918b931b230db871412fc20000000100000fb8
 *nvim_get_hl_ns()*
    Gets the active highlight namespace.

    Attributes: ~
        Since: 0.10.0

    Parameters: ~
      • {opts}  Optional parameters
                • winid: (number) |window-ID| for retrieving a window's
                  highlight namespace. A value of -1 is returned when
                  |nvim_win_set_hl_ns()| has not been called for the window
                  (or was called with a namespace of -1).

    Return: ~
        Namespace id, or -1

nvim_get_keymap({mode})                                    *nvim_get_keymap()*
    Gets a list of global (non-buffer-local) |mapping| definitions.

    Attributes: ~
        Since: 0.2.1

    Parameters: ~
      • {mode}  Mode short-name ("n", "i", "v", ...)

    Return: ~
        Array of |maparg()|-like dictionaries describing mappings. The
        "buffer" key is always zero.

nvim_get_mark({name}, {opts})                                *nvim_get_mark()*
    Returns a `(row, col, buffer, buffername)` tuple representing the position
    of the uppercase/file named mark. "End of line" column position is
    returned as |v:maxcol| (big number). See |mark-motions|.

    Marks are (1,0)-indexed. |api-indexing|

    Note: ~
      • Lowercase name (or other buffer-local mark) is an error.

    Attributes: ~
        Since: 0.6.0

    Parameters: ~
      • {name}  Mark name
      • {opts}  Optional parameters. Reserved for future use.

    Return: ~
        4-tuple (row, col, buffer, buffername), (0, 0, 0, '') if the mark is
        not set.

    See also: ~
      • |nvim_buf_set_mark()|
      • |nvim_del_mark()|

nvim_get_mode()                                              *nvim_get_mode()*
    Gets the current mode. |mode()| "blocking" is true if Nvim is waiting for
    input.

    Attributes: ~
        |api-fast|
        Since: 0.2.0

    Return: ~
        Dict { "mode": String, "blocking": Boolean }

nvim_get_proc({pid})                                         *nvim_get_proc()*
    Gets info describing process `pid`.

    Attributes: ~
        Since: 0.3.0

    Return: ~
        Map of process properties, or NIL if process not found.

nvim_get_proc_children({pid})                       *nvim_get_proc_children()*
    Gets the immediate children of process `pid`.

    Attributes: ~
        Since: 0.3.0

    Return: ~
        Array of child process ids, empty if process not found.

nvim_get_runtime_file({name}, {all})                 *nvim_get_runtime_file()*
    Finds files in runtime directories, in 'runtimepath' order.

    "name" can contain wildcards. For example
    `nvim_get_runtime_file("colors/*.{vim,lua}", true)` will return all color
    scheme files. Always use forward slashes (/) in the search pattern for
    subdirectories regardless of platform.

    It is not an error to not find any files. An empty array is returned then.

    Attributes: ~
        |api-fast|
        Since: 0.5.0

    Parameters: ~
      • {name}  pattern of files to search for
      • {all}   whether to return all matches or only the first

    Return: ~
        list of absolute paths to the found files

nvim_get_var({name})                                          *nvim_get_var()*
    Gets a global (g:) variable.

    Attributes: ~
        Since: 0.1.0

    Parameters: ~
      • {name}  Variable name

    Return: ~
        Variable value

nvim_get_vvar({name})                                        *nvim_get_vvar()*
    Gets a v: variable.

    Attributes: ~
        Since: 0.1.0

    Parameters: ~
      • {name}  Variable name

    Return: ~
        Variable value

nvim_input({keys})                                              *nvim_input()*
    Queues raw user-input. Unlike |nvim_feedkeys()|, this uses a low-level
    input buffer and the call is non-blocking (input is processed
    asynchronously by the eventloop).

    To input blocks of text, |nvim_paste()| is much faster and should be
    preferred.

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

    Note: ~

Title: Nvim API: Global Functions - Highlight Namespace, Keymaps, Marks, Mode, Processes, Runtime Files, Variables, and Input
Summary
This section describes global Nvim API functions for advanced editor interaction. It includes functions for retrieving the highlight namespace (`nvim_get_hl_ns()`), global keymap definitions (`nvim_get_keymap()`), mark positions (`nvim_get_mark()`), the current editor mode (`nvim_get_mode()`), information about processes (`nvim_get_proc()`, `nvim_get_proc_children()`), runtime files (`nvim_get_runtime_file()`), global and v: variables (`nvim_get_var()`, `nvim_get_vvar()`), and queuing raw user input (`nvim_input()`).