xml_comment.c

Go to the documentation of this file.

/*
 * Copyright 2024-2025 the Pacemaker project contributors
 *
 * The version control history for this file may have further details.
 *
 * This source code is licensed under the GNU Lesser General Public License
 * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
 */
 
#include <crm_internal.h>
 
#include <stdbool.h>                    // bool, false
#include <stdio.h>                      // NULL
 
#include <libxml/tree.h>                // xmlDoc, xmlNode, etc.
#include <libxml/xmlstring.h>           // xmlChar
 
#include "crmcommon_private.h"
 
xmlNode *
pcmk__xc_create(xmlDoc *doc, const char *content)
{
    xmlNode *node = NULL;
 
    // Pacemaker typically assumes every xmlNode has a doc
    pcmk__assert(doc != NULL);
 
    node = xmlNewDocComment(doc, (const xmlChar *) content);
    pcmk__mem_assert(node);
    pcmk__xml_new_private_data(node);
    return node;
}
 
bool
pcmk__xc_matches(const xmlNode *comment1, const xmlNode *comment2)
{
    pcmk__assert((comment1 != NULL) && (comment1->type == XML_COMMENT_NODE)
                 && (comment2 != NULL) && (comment2->type == XML_COMMENT_NODE));
 
    return pcmk__str_eq((const char *) comment1->content,
                        (const char *) comment2->content, pcmk__str_casei);
}
 
static xmlNode *
match_xc_child(const xmlNode *parent, const xmlNode *search)
{
    pcmk__assert((search != NULL) && (search->type == XML_COMMENT_NODE));
 
    for (xmlNode *child = pcmk__xml_first_child(parent); child != NULL;
         child = pcmk__xml_next(child)) {
 
        if (child->type != XML_COMMENT_NODE) {
            continue;
        }
 
        if (pcmk__xc_matches(child, search)) {
            return child;
        }
    }
 
    return NULL;
}
 
void
pcmk__xc_update(xmlNode *parent, xmlNode *target, xmlNode *update)
{
    CRM_CHECK(update != NULL, return);
    CRM_CHECK(update->type == XML_COMMENT_NODE, return);
 
    if (target == NULL) {
        target = match_xc_child(parent, update);
    }
 
    if (target == NULL) {
        pcmk__xml_copy(parent, update);
 
    } else if (!pcmk__str_eq((const char *)target->content, (const char *)update->content, pcmk__str_casei)) {
        xmlFree(target->content);
        target->content = xmlStrdup(update->content);
    }
}