editorconfig.h File Reference

Header file of EditorConfig. More...

#include <editorconfig/editorconfig_handle.h>

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

EDITORCONFIG_PARSE_MEMORY_ERROR

#define EDITORCONFIG_PARSE_MEMORY_ERROR   (-3)

editorconfig_parse() return value: a memory error occurs.

EDITORCONFIG_PARSE_NOT_FULL_PATH

#define EDITORCONFIG_PARSE_NOT_FULL_PATH   (-2)

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

EDITORCONFIG_PARSE_VERSION_TOO_NEW

#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

editorconfig_get_error_msg()

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.

editorconfig_get_version()

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.

editorconfig_get_version_suffix()

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.

editorconfig_parse()

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.