/*
版權說明
*/

#include <stdlib.h>//------------系統標頭檔案
#include <stdio.h>

#include <osipparser2/osip_port.h>//---------自定義標頭檔案

/* returns the content_type header as a string.  *///------------函式功能
/* INPUT : osip_content_type_t *content_type | content_type header.   */
//------------------------------應該輸入那些引數
 

/* returns null on error. *///-------- - 返回值含義
int osip_accept_to_str(const osip_accept_t * accept, char **dest)
{
    //---------------------------- - 對於所有不需要或不能改變的變數都應該使用const標識
        char *buf; //------------------臨時變數
        char *tmp;
    size_t len;

    *dest = NULL;
    if (accept == NULL)//--------------任何引數傳入後都應該檢查它的有效性
 

        return -1;// -------------------- - 根據傳入引數的有效性區別對待

    if ((accept->type == NULL) && (accept->subtype == NULL))
    {
        /* Empty header ! */
        buf = (char *)osip_malloc(2);
        buf[0] = ' ';
        buf[1] = '\0';
        *dest = buf;
        return 0;
    }

    /* try to guess a long enough length 
 
*///----------- 段落註釋
        len = strlen(accept->type) + strlen(accept->subtype) + 4    /* for '/', ' ', ';' and '\0' *///------------------行註釋
        + 10 * osip_list_size(accept->gen_params);

    buf = (char *)osip_malloc(len); //----------------所有的指標必須有其空間
        tmp = buf;

    sprintf(tmp, "%s/%s", accept->type, accept->subtype);

    tmp = tmp + strlen(tmp);
    {
        int pos = 0;
        osip_generic_param_t *u_param;

#if 0//---------------------------對於不再使用但是又有必有保留以後使用的
        if (!osip_list_eol(accept->gen_params, pos))
        {
            /* needed for cannonical form! (authentication issue of rfc2543) */
            sprintf(tmp, " ");
            tmp++;
        }
#endif
        while (!osip_list_eol(accept->gen_params, pos))
        {
            size_t tmp_len;

            u_param = (osip_generic_param_t *)osip_list_get(accept->gen_params, pos);
            if (u_param->gvalue == NULL)//------------要為所有的函式呼叫判斷是否成功
            {
                osip_free(buf);
                return -1;
            }
            tmp_len = strlen(buf) + 4 + strlen(u_param->gname)
                + strlen(u_param->gvalue) + 1;
            if (len < tmp_len)
            {
                buf = osip_realloc(buf, tmp_len);
                len = tmp_len;
                tmp = buf + strlen(buf);
            }
            sprintf(tmp, "; %s=%s", u_param->gname, u_param->gvalue);
            tmp = tmp + strlen(tmp);
            pos++;
        }
    }
    *dest = buf;
    return 0;
}