#ifndef LINE_RANGE_H #define LINE_RANGE_H struct index_state; /* * 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. * * 'anchor' is the 1-based line at which relative range specifications * should be anchored. Absolute ranges are unaffected by this value. * * 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); int parse_range_arg(const char *arg, nth_line_fn_t nth_line_cb, void *cb_data, long lines, long anchor, long *begin, long *end, const char *path, struct index_state *istate); /* * 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. */ const char *skip_range_arg(const char *arg, struct index_state *istate); #endif /* LINE_RANGE_H */