]>
Commit | Line | Data |
---|---|---|
d9ea73e0 JH |
1 | #ifndef XDIFF_INTERFACE_H |
2 | #define XDIFF_INTERFACE_H | |
3 | ||
d1cbe1e6 | 4 | #include "hash-ll.h" |
d9ea73e0 | 5 | #include "xdiff/xdiff.h" |
d9ea73e0 | 6 | |
dcd1742e JK |
7 | /* |
8 | * xdiff isn't equipped to handle content over a gigabyte; | |
9 | * we make the cutoff 1GB - 1MB to give some breathing | |
10 | * room for constant-sized additions (e.g., merge markers) | |
11 | */ | |
12 | #define MAX_XDIFF_SIZE (1024UL * 1024 * 1023) | |
13 | ||
9e204422 ÆAB |
14 | /** |
15 | * The `xdiff_emit_line_fn` function can return 1 to abort early, or 0 | |
16 | * to continue processing. Note that doing so is an all-or-nothing | |
17 | * affair, as returning 1 will return all the way to the top-level, | |
18 | * e.g. the xdi_diff_outf() call to generate the diff. | |
19 | * | |
20 | * Thus returning 1 means you won't be getting any more diff lines. If | |
21 | * you need something in-between those two options you'll to use | |
22 | * `xdl_emit_hunk_consume_func_t` and implement your own version of | |
23 | * xdl_emit_diff(). | |
24 | * | |
25 | * We may extend the interface in the future to understand other more | |
26 | * granular return values. While you should return 1 to exit early, | |
27 | * doing so will currently make your early return indistinguishable | |
28 | * from an error internal to xdiff, xdiff itself will see that | |
29 | * non-zero return and translate it to -1. | |
fa59e7be ÆAB |
30 | * |
31 | * See "diff_grep" in diffcore-pickaxe.c for a trick to work around | |
32 | * this, i.e. using the "consume_callback_data" to note the desired | |
33 | * early return. | |
9e204422 | 34 | */ |
a8d5eb6d | 35 | typedef int (*xdiff_emit_line_fn)(void *, char *, unsigned long); |
9346d6d1 JK |
36 | typedef void (*xdiff_emit_hunk_fn)(void *data, |
37 | long old_begin, long old_nr, | |
38 | long new_begin, long new_nr, | |
39 | const char *func, long funclen); | |
d9ea73e0 | 40 | |
c279d7e9 | 41 | int xdi_diff(mmfile_t *mf1, mmfile_t *mf2, xpparam_t const *xpp, xdemitconf_t const *xecfg, xdemitcb_t *ecb); |
c99db9d2 | 42 | int xdi_diff_outf(mmfile_t *mf1, mmfile_t *mf2, |
9346d6d1 JK |
43 | xdiff_emit_hunk_fn hunk_fn, |
44 | xdiff_emit_line_fn line_fn, | |
45 | void *consume_callback_data, | |
dfea7900 | 46 | xpparam_t const *xpp, xdemitconf_t const *xecfg); |
7cab5883 | 47 | int read_mmfile(mmfile_t *ptr, const char *filename); |
d449347d | 48 | void read_mmblob(mmfile_t *ptr, const struct object_id *oid); |
6bfce93e | 49 | int buffer_is_binary(const char *ptr, unsigned long size); |
d9ea73e0 | 50 | |
55454427 DL |
51 | void xdiff_set_find_func(xdemitconf_t *xecfg, const char *line, int cflags); |
52 | void xdiff_clear_find_func(xdemitconf_t *xecfg); | |
a4e7e317 GC |
53 | struct config_context; |
54 | int git_xmerge_config(const char *var, const char *value, | |
55 | const struct config_context *ctx, void *cb); | |
b5412484 | 56 | extern int git_xmerge_style; |
f258475a | 57 | |
5ec8274b SB |
58 | /* |
59 | * Compare the strings l1 with l2 which are of size s1 and s2 respectively. | |
60 | * Returns 1 if the strings are deemed equal, 0 otherwise. | |
61 | * The `flags` given as XDF_WHITESPACE_FLAGS determine how white spaces | |
15beaaa3 | 62 | * are treated for the comparison. |
5ec8274b | 63 | */ |
55454427 | 64 | int xdiff_compare_lines(const char *l1, long s1, |
ad6dad09 | 65 | const char *l2, long s2, long flags); |
5ec8274b SB |
66 | |
67 | /* | |
68 | * Returns a hash of the string s of length len. | |
69 | * The `flags` given as XDF_WHITESPACE_FLAGS determine how white spaces | |
70 | * are treated for the hash. | |
71 | */ | |
55454427 | 72 | unsigned long xdiff_hash_string(const char *s, size_t len, long flags); |
5ec8274b | 73 | |
d9ea73e0 | 74 | #endif |