gri3-wm/src/match.c

/*
 * vim:ts=4:sw=4:expandtab
 *
 * i3 - an improved dynamic tiling window manager
 * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
 *
 * A "match" is a data structure which acts like a mask or expression to match
 * certain windows or not. For example, when using commands, you can specify a
 * command like this: [title="*Firefox*"] kill. The title member of the match
 * data structure will then be filled and i3 will check each window using
 * match_matches_window() to find the windows affected by this command.
 *
 */

#include "all.h"

/*
 * Initializes the Match data structure. This function is necessary because the
 * members representing boolean values (like dock) need to be initialized with
 * -1 instead of 0.
 *
 */
void match_init(Match *match) {
    memset(match, 0, sizeof(Match));
    match->dock = -1;
}

/*
 * Check if a match is empty. This is necessary while parsing commands to see
 * whether the user specified a match at all.
 *
 */
bool match_is_empty(Match *match) {
    /* we cannot simply use memcmp() because the structure is part of a
     * TAILQ and I don’t want to start with things like assuming that the
     * last member of a struct really is at the end in memory… */
    return (match->title == NULL &&
            match->mark == NULL &&
            match->application == NULL &&
            match->class == NULL &&
            match->instance == NULL &&
            match->id == XCB_NONE &&
            match->con_id == NULL &&
            match->dock == -1 &&
            match->floating == M_ANY);
}

/*
 * Copies the data of a match from src to dest.
 *
 */
void match_copy(Match *dest, Match *src) {
    memcpy(dest, src, sizeof(Match));

#define STRDUP(field) do { \
    if (src->field != NULL) \
        dest->field = sstrdup(src->field); \
} while (0)

    STRDUP(title);
    STRDUP(mark);
    STRDUP(application);
    STRDUP(class);
    STRDUP(instance);
}

/*
 * Check if a match data structure matches the given window.
 *
 */
bool match_matches_window(Match *match, i3Window *window) {
    LOG("checking window %d (%s)\n", window->id, window->class_class);

    /* TODO: pcre, full matching, … */
    if (match->class != NULL) {
        if (window->class_class != NULL && strcasecmp(match->class, window->class_class) == 0) {
            LOG("window class matches (%s)\n", window->class_class);
        } else {
            LOG("window class does not match\n");
            return false;
        }
    }

    if (match->instance != NULL) {
        if (window->class_instance != NULL && strcasecmp(match->instance, window->class_instance) == 0) {
            LOG("window instance matches (%s)\n", window->class_instance);
        } else {
            LOG("window instance does not match\n");
            return false;
        }
    }

    if (match->id != XCB_NONE) {
        if (window->id == match->id) {
            LOG("match made by window id (%d)\n", window->id);
        } else {
            LOG("window id does not match\n");
            return false;
        }
    }

    /* TODO: pcre match */
    if (match->title != NULL) {
        if (window->name_json != NULL && strcasecmp(match->title, window->name_json) == 0) {
            LOG("title matches (%s)\n", window->name_json);
        } else {
            LOG("title does not match\n");
            return false;
        }
    }

    if (match->dock != -1) {
        LOG("match->dock = %d, window->dock = %d\n", match->dock, window->dock);
        if ((window->dock == W_DOCK_TOP && match->dock == M_DOCK_TOP) ||
         (window->dock == W_DOCK_BOTTOM && match->dock == M_DOCK_BOTTOM) ||
         ((window->dock == W_DOCK_TOP || window->dock == W_DOCK_BOTTOM) &&
          match->dock == M_DOCK_ANY) ||
         (window->dock == W_NODOCK && match->dock == M_NODOCK)) {
            LOG("dock status matches\n");
        } else {
            LOG("dock status does not match\n");
            return false;
        }
    }

    /* We don’t check the mark because this function is not even called when
     * the mark would have matched - it is checked in cmdparse.y itself */
    if (match->mark != NULL) {
        LOG("mark does not match\n");
        return false;
    }

    return true;
}