root/usr/src/cmd/mail/getcomment.c
/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*
 * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

/*      Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
/*        All Rights Reserved   */

#include "mail.h"
/*
 * Get comment field, if any, from line.
 *      1 ==> found comment.
 *      0 ==> no comment found.
 *     -1 ==> no closing (terminating) paren found for comment.
 */

int
getcomment(char *s, char *q)
        /* Copy comment, if found, to q */
{
        char    *p, *sav_q;
        int     depth = 0;

        if ((p = strchr(s, '(')) == (char *)NULL) {
                /* no comment found */
                return (0);
        }
        sav_q = q;
        while (*p) {
                *q++ = *p;
                if (*p == ')') {
                        /* account for nested parens within comment */
                        depth--;
                        if (depth == 0) {
                                break;
                        }
                } else if (*p == '(') {
                        depth++;
                }
                p++;
        }
        *q = '\0';
        if (*p != ')') {
                /* closing paren not found */
                *sav_q = '\0';
                return (-1);
        }
        /* found comment */
        return (1);
}