travis-ci: switch to Xcode 10.1 macOS image
[gitweb.git] / line-range.h
index 830f25b501df5aa5960d1c654aa767335f7f506b..e69bf7c01765bba0b54a7a4174706f1258e0fdb0 100644 (file)
@@ -1,6 +1,8 @@
 #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.
@@ -9,6 +11,9 @@
  * 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);
 
-extern int parse_range_arg(const char *arg,
-                          nth_line_fn_t nth_line_cb,
-                          void *cb_data, long lines,
-                          long *begin, long *end);
+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 */