Annotation of embedaddon/curl/lib/slist.c, revision 1.1

1.1     ! misho       1: /***************************************************************************
        !             2:  *                                  _   _ ____  _
        !             3:  *  Project                     ___| | | |  _ \| |
        !             4:  *                             / __| | | | |_) | |
        !             5:  *                            | (__| |_| |  _ <| |___
        !             6:  *                             \___|\___/|_| \_\_____|
        !             7:  *
        !             8:  * Copyright (C) 1998 - 2019, Daniel Stenberg, <daniel@haxx.se>, et al.
        !             9:  *
        !            10:  * This software is licensed as described in the file COPYING, which
        !            11:  * you should have received as part of this distribution. The terms
        !            12:  * are also available at https://curl.haxx.se/docs/copyright.html.
        !            13:  *
        !            14:  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
        !            15:  * copies of the Software, and permit persons to whom the Software is
        !            16:  * furnished to do so, under the terms of the COPYING file.
        !            17:  *
        !            18:  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
        !            19:  * KIND, either express or implied.
        !            20:  *
        !            21:  ***************************************************************************/
        !            22: 
        !            23: #include "curl_setup.h"
        !            24: 
        !            25: #include <curl/curl.h>
        !            26: 
        !            27: #include "slist.h"
        !            28: 
        !            29: /* The last #include files should be: */
        !            30: #include "curl_memory.h"
        !            31: #include "memdebug.h"
        !            32: 
        !            33: /* returns last node in linked list */
        !            34: static struct curl_slist *slist_get_last(struct curl_slist *list)
        !            35: {
        !            36:   struct curl_slist     *item;
        !            37: 
        !            38:   /* if caller passed us a NULL, return now */
        !            39:   if(!list)
        !            40:     return NULL;
        !            41: 
        !            42:   /* loop through to find the last item */
        !            43:   item = list;
        !            44:   while(item->next) {
        !            45:     item = item->next;
        !            46:   }
        !            47:   return item;
        !            48: }
        !            49: 
        !            50: /*
        !            51:  * Curl_slist_append_nodup() appends a string to the linked list. Rather than
        !            52:  * copying the string in dynamic storage, it takes its ownership. The string
        !            53:  * should have been malloc()ated. Curl_slist_append_nodup always returns
        !            54:  * the address of the first record, so that you can use this function as an
        !            55:  * initialization function as well as an append function.
        !            56:  * If an error occurs, NULL is returned and the string argument is NOT
        !            57:  * released.
        !            58:  */
        !            59: struct curl_slist *Curl_slist_append_nodup(struct curl_slist *list, char *data)
        !            60: {
        !            61:   struct curl_slist     *last;
        !            62:   struct curl_slist     *new_item;
        !            63: 
        !            64:   DEBUGASSERT(data);
        !            65: 
        !            66:   new_item = malloc(sizeof(struct curl_slist));
        !            67:   if(!new_item)
        !            68:     return NULL;
        !            69: 
        !            70:   new_item->next = NULL;
        !            71:   new_item->data = data;
        !            72: 
        !            73:   /* if this is the first item, then new_item *is* the list */
        !            74:   if(!list)
        !            75:     return new_item;
        !            76: 
        !            77:   last = slist_get_last(list);
        !            78:   last->next = new_item;
        !            79:   return list;
        !            80: }
        !            81: 
        !            82: /*
        !            83:  * curl_slist_append() appends a string to the linked list. It always returns
        !            84:  * the address of the first record, so that you can use this function as an
        !            85:  * initialization function as well as an append function. If you find this
        !            86:  * bothersome, then simply create a separate _init function and call it
        !            87:  * appropriately from within the program.
        !            88:  */
        !            89: struct curl_slist *curl_slist_append(struct curl_slist *list,
        !            90:                                      const char *data)
        !            91: {
        !            92:   char *dupdata = strdup(data);
        !            93: 
        !            94:   if(!dupdata)
        !            95:     return NULL;
        !            96: 
        !            97:   list = Curl_slist_append_nodup(list, dupdata);
        !            98:   if(!list)
        !            99:     free(dupdata);
        !           100: 
        !           101:   return list;
        !           102: }
        !           103: 
        !           104: /*
        !           105:  * Curl_slist_duplicate() duplicates a linked list. It always returns the
        !           106:  * address of the first record of the cloned list or NULL in case of an
        !           107:  * error (or if the input list was NULL).
        !           108:  */
        !           109: struct curl_slist *Curl_slist_duplicate(struct curl_slist *inlist)
        !           110: {
        !           111:   struct curl_slist *outlist = NULL;
        !           112:   struct curl_slist *tmp;
        !           113: 
        !           114:   while(inlist) {
        !           115:     tmp = curl_slist_append(outlist, inlist->data);
        !           116: 
        !           117:     if(!tmp) {
        !           118:       curl_slist_free_all(outlist);
        !           119:       return NULL;
        !           120:     }
        !           121: 
        !           122:     outlist = tmp;
        !           123:     inlist = inlist->next;
        !           124:   }
        !           125:   return outlist;
        !           126: }
        !           127: 
        !           128: /* be nice and clean up resources */
        !           129: void curl_slist_free_all(struct curl_slist *list)
        !           130: {
        !           131:   struct curl_slist     *next;
        !           132:   struct curl_slist     *item;
        !           133: 
        !           134:   if(!list)
        !           135:     return;
        !           136: 
        !           137:   item = list;
        !           138:   do {
        !           139:     next = item->next;
        !           140:     Curl_safefree(item->data);
        !           141:     free(item);
        !           142:     item = next;
        !           143:   } while(next);
        !           144: }

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>