editorconfig.h

Section: C Library Functions (3)
Updated: Thu Feb 4 2021
Page Index

NAME

editorconfig.h - Header file of EditorConfig.

SYNOPSIS

#include <editorconfig/editorconfig_handle.h>

Macros

#define EDITORCONFIG_PARSE_NOT_FULL_PATH (-2)

#define EDITORCONFIG_PARSE_MEMORY_ERROR (-3)

#define EDITORCONFIG_PARSE_VERSION_TOO_NEW (-4)

Functions

int editorconfig_parse (const char *full_filename, editorconfig_handle h)
Parse editorconfig files corresponding to the file path given by full_filename, and related information is input and output in h.
const char * editorconfig_get_error_msg (int err_num)
Get the error message from the error number returned by editorconfig_parse().
void editorconfig_get_version (int *major, int *minor, int *patch)
Get the version number of EditorConfig.
const char * editorconfig_get_version_suffix (void)
Get the version suffix.

Detailed Description

Header file of EditorConfig.

Related page: EditorConfig File Format editorconfig-format(5)

Author

: EditorConfig Team

Macro Definition Documentation

#define EDITORCONFIG_PARSE_MEMORY_ERROR (-3)

editorconfig_parse() return value: a memory error occurs.

#define EDITORCONFIG_PARSE_NOT_FULL_PATH (-2)

editorconfig_parse() return value: the full_filename parameter of editorconfig_parse() is not a full path name

#define EDITORCONFIG_PARSE_VERSION_TOO_NEW (-4)

editorconfig_parse() return value: the required version specified in editorconfig_handle is greater than the current version.

Function Documentation

const char* editorconfig_get_error_msg (int err_num)

Get the error message from the error number returned by editorconfig_parse(). An example is available at src/bin/main.c in EditorConfig C Core source code.

Parameters

: err_num The error number that is used to obtain the error message.

Returns

: The error message corresponding to err_num.

void editorconfig_get_version (int * major, int * minor, int * patch)

Get the version number of EditorConfig. An example is available at src/bin/main.c in EditorConfig C Core source code.

Parameters

: major If not null, the integer pointed by major will be filled with the major version of EditorConfig.
minor If not null, the integer pointed by minor will be filled with the minor version of EditorConfig.
patch If not null, the integer pointed by patch will be filled with the patch version of EditorConfig.

Returns

: None.

const char* editorconfig_get_version_suffix (void)

Get the version suffix.

Returns

: The version suffix, such as '-development' for a development version, empty string for a stable version.

int editorconfig_parse (const char * full_filename, editorconfig_handle h)

Parse editorconfig files corresponding to the file path given by full_filename, and related information is input and output in h. An example is available at src/bin/main.c in EditorConfig C Core source code.

Parameters

: full_filename The full path of a file that is edited by the editor for which the parsing result is.
h The editorconfig_handle to be used and returned from this function (including the parsing result). The editorconfig_handle should be created by editorconfig_handle_init().

Return values

: 0 Everything is OK.
Positive Integer A parsing error occurs. The return value would be the line number of parsing error. err_file obtained from h by calling editorconfig_handle_get_err_file() will also be filled with the file path that caused the parsing error.
Negative Integer Some error occured. See below for the reason of the error for each return value.
EDITORCONFIG_PARSE_NOT_FULL_PATH The full_filename is not a full path name.
EDITORCONFIG_PARSE_MEMORY_ERROR A memory error occurs.
EDITORCONFIG_PARSE_VERSION_TOO_NEW The required version specified in editorconfig_handle is greater than the current version.

Author

Generated automatically by Doxygen for EditorConfig from the source code.