7bd18054d2
The traditional API to check attributes is to prepare an N-element array of "struct git_attr_check" and pass N and the array to the function "git_check_attr()" as arguments. In preparation to revamp the API to pass a single structure, in which these N elements are held, rename the type used for these individual array elements to "struct attr_check_item" and rename the function to "git_check_attrs()". Signed-off-by: Junio C Hamano <gitster@pobox.com> Signed-off-by: Stefan Beller <sbeller@google.com> Signed-off-by: Brandon Williams <bmwill@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
58 lines
1.6 KiB
C
58 lines
1.6 KiB
C
#ifndef ATTR_H
|
|
#define ATTR_H
|
|
|
|
/* An attribute is a pointer to this opaque structure */
|
|
struct git_attr;
|
|
|
|
/*
|
|
* Given a string, return the gitattribute object that
|
|
* corresponds to it.
|
|
*/
|
|
struct git_attr *git_attr(const char *);
|
|
|
|
/* Internal use */
|
|
extern const char git_attr__true[];
|
|
extern const char git_attr__false[];
|
|
|
|
/* For public to check git_attr_check results */
|
|
#define ATTR_TRUE(v) ((v) == git_attr__true)
|
|
#define ATTR_FALSE(v) ((v) == git_attr__false)
|
|
#define ATTR_UNSET(v) ((v) == NULL)
|
|
|
|
/*
|
|
* Send one or more git_attr_check to git_check_attrs(), and
|
|
* each 'value' member tells what its value is.
|
|
* Unset one is returned as NULL.
|
|
*/
|
|
struct attr_check_item {
|
|
const struct git_attr *attr;
|
|
const char *value;
|
|
};
|
|
|
|
/*
|
|
* Return the name of the attribute represented by the argument. The
|
|
* return value is a pointer to a null-delimited string that is part
|
|
* of the internal data structure; it should not be modified or freed.
|
|
*/
|
|
extern const char *git_attr_name(const struct git_attr *);
|
|
|
|
int git_check_attrs(const char *path, int, struct attr_check_item *);
|
|
|
|
/*
|
|
* Retrieve all attributes that apply to the specified path. *num
|
|
* will be set to the number of attributes on the path; **check will
|
|
* be set to point at a newly-allocated array of git_attr_check
|
|
* objects describing the attributes and their values. *check must be
|
|
* free()ed by the caller.
|
|
*/
|
|
int git_all_attrs(const char *path, int *num, struct attr_check_item **check);
|
|
|
|
enum git_attr_direction {
|
|
GIT_ATTR_CHECKIN,
|
|
GIT_ATTR_CHECKOUT,
|
|
GIT_ATTR_INDEX
|
|
};
|
|
void git_attr_set_direction(enum git_attr_direction, struct index_state *);
|
|
|
|
#endif /* ATTR_H */
|