describe.c

Go to the documentation of this file.

/*
 * Crossfire -- cooperative multi-player graphical RPG and adventure game
 *
 * Copyright (c) 1999-2014 Mark Wedel and the Crossfire Development Team
 * Copyright (c) 1992 Frank Tore Johansen
 *
 * Crossfire is free software and comes with ABSOLUTELY NO WARRANTY. You are
 * welcome to redistribute it under certain conditions. For details, please
 * see COPYING and LICENSE.
 *
 * The authors can be reached via e-mail at <crossfire@metalforge.org>.
 */
 
#include "global.h"
 
#include <stdlib.h>
#include <string.h>
 
#include "ob_methods.h"
#include "ob_types.h"
 
void common_ob_describe(const object *op, const object *observer, int use_media_tags, char *buf, size_t size) {
    char *desc;
 
    buf[0] = '\0';
 
    if (op == NULL)
        return;
 
    desc = stringbuffer_finish(describe_item(op, observer, use_media_tags, NULL));
    if (desc[0] != '\0') {
        size_t len;
 
        query_name(op, buf, size-1);
        buf[size-1] = 0;
        len = strlen(buf);
        if ((len+5) < size) {
            /* Since we know the length, we save a few cpu cycles by using
             * it instead of calling strcat */
            strcpy(buf+len, " ");
            len++;
            strncpy(buf+len, desc, size-len-1);
            buf[size-1] = 0;
        }
    }
    free(desc);
    if (buf[0] == '\0') {
        query_name(op, buf, size-1);
        buf[size-1] = 0;
    }
}