EditorConfig
Configuration file format for defining coding styles in shared projects.
 All Files Functions Typedefs Macros Pages
editorconfig.h File Reference

Header file of EditorConfig. More...

Go to the source code of this file.

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. More...
 
const char * editorconfig_get_error_msg (int err_num)
 Get the error message from the error number returned by editorconfig_parse(). More...
 
void editorconfig_get_version (int *major, int *minor, int *patch)
 Get the version number of EditorConfig. More...
 
const char * editorconfig_get_version_suffix (void)
 Get the version suffix. More...
 

Detailed Description

Header file of EditorConfig.

Related page: EditorConfig File Format

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_numThe 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
majorIf not null, the integer pointed by major will be filled with the major version of EditorConfig.
minorIf not null, the integer pointed by minor will be filled with the minor version of EditorConfig.
patchIf 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_filenameThe full path of a file that is edited by the editor for which the parsing result is.
hThe 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
0Everything is OK.
Positive IntegerA 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 IntegerSome error occured. See below for the reason of the error for each return value.
EDITORCONFIG_PARSE_NOT_FULL_PATHThe full_filename is not a full path name.
EDITORCONFIG_PARSE_MEMORY_ERRORA memory error occurs.
EDITORCONFIG_PARSE_VERSION_TOO_NEWThe required version specified in editorconfig_handle is greater than the current version.