[thirdparty/git.git] / line-range.h

#ifndef LINE_RANGE_H
#define LINE_RANGE_H

/*
 * Parse one item in an -L begin,end option w.r.t. the notional file
 * object 'cb_data' consisting of 'lines' lines.
 *
 * The 'nth_line_cb' callback is used to determine the start of the
 * line 'lno' inside the 'cb_data'.  The caller is expected to already
 * have a suitable map at hand to make this a constant-time lookup.
 *
 * Returns 0 in case of success and -1 if there was an error.  The
 * actual range is stored in *begin and *end.  The counting starts
 * at 1!  In case of error, the caller should show usage message.
 */

typedef const char *(*nth_line_fn_t)(void *data, long lno);

extern int parse_range_arg(const char *arg,
			   nth_line_fn_t nth_line_cb,
			   void *cb_data, long lines,
			   long *begin, long *end,
			   const char *path);

/*
 * Scan past a range argument that could be parsed by
 * 'parse_range_arg', to help the caller determine the start of the
 * filename in '-L n,m:file' syntax.
 *
 * Returns a pointer to the first character after the 'n,m' part, or
 * NULL in case the argument is obviously malformed.
 */

extern const char *skip_range_arg(const char *arg);

#endif /* LINE_RANGE_H */
Commit	Line	Data
25ed3412 BY	1	#ifndef LINE_RANGE_H
	2	#define LINE_RANGE_H
	3
	4	/*
	5	* Parse one item in an -L begin,end option w.r.t. the notional file
	6	* object 'cb_data' consisting of 'lines' lines.
	7	*
	8	* The 'nth_line_cb' callback is used to determine the start of the
	9	* line 'lno' inside the 'cb_data'. The caller is expected to already
	10	* have a suitable map at hand to make this a constant-time lookup.
	11	*
	12	* Returns 0 in case of success and -1 if there was an error. The
	13	* actual range is stored in begin and end. The counting starts
	14	* at 1! In case of error, the caller should show usage message.
	15	*/
	16
	17	typedef const char (nth_line_fn_t)(void *data, long lno);
	18
	19	extern int parse_range_arg(const char *arg,
	20	nth_line_fn_t nth_line_cb,
	21	void *cb_data, long lines,
13b8f68c TR	22	long begin, long end,
13b8f68c TR	23	const char *path);
25ed3412	24
12da1d1f TR	25	/*
	26	* Scan past a range argument that could be parsed by
	27	* 'parse_range_arg', to help the caller determine the start of the
	28	* filename in '-L n,m:file' syntax.
	29	*
	30	* Returns a pointer to the first character after the 'n,m' part, or
	31	* NULL in case the argument is obviously malformed.
	32	*/
	33
	34	extern const char skip_range_arg(const char arg);
	35
25ed3412	36	#endif /* LINE_RANGE_H */