git.oblomov.eu Git - git/blob - line-range.h

   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,
  22                            long *begin, long *end);
  23
  24 #endif /* LINE_RANGE_H */