ग्राफविज़ और सी / सी ++ प्रीप्रोसेसर की सहक्रिया

यह आलेख सी / सी ++ प्रीप्रोसेसर (इसके बाद केवल प्रीप्रोसेसर के रूप में संदर्भित) के साथ सहयोग में लोकप्रिय ग्रेविज़ ग्राफिंग टूल का उपयोग करने का तरीका है ।

मुख्य बिंदु यह है कि ग्राफविज़ द्वारा उपयोग की जाने वाली डॉट ग्राफ भाषा प्रीप्रोसेसर द्वारा प्रसंस्करण के लिए वाक्यविन्यास रूप से उपयुक्त है। तो डेवलपर्स द्वारा कल्पना की गई। उनकी अंतर्दृष्टि के लिए धन्यवाद, हम रेखांकन का वर्णन करते समय निम्नलिखित विशेषताओं का उपयोग कर सकते हैं (मैं मेमोरी से विकिपीडिया से उद्धरण):

• संबंधित डिग्राफ को बदलना और समकक्ष वर्ण "#" और "\" के साथ ट्रिगर करना;
• बची हुई पंक्ति फ़ीड वर्णों को हटाना;
• खाली लाइनों के साथ लाइन और ब्लॉक टिप्पणियों की जगह (आसपास के रिक्त स्थान और टैब को हटाने के साथ);
• एक मनमाना फ़ाइल ( #include ) की सामग्री का सम्मिलन (समावेश );
• स्थूल प्रतिस्थापन ( # अल्पाइन );
• सशर्त संकलन ( #if, #ifdef, #elif, #else, #endif );

अब हम अभ्यास में खोले गए अवसरों का प्रदर्शन करेंगे। एक उदाहरण के रूप में, MediaStrimer2 पर मेरे लेख से ग्राफ लें , यह नीचे दिए गए आंकड़े में है।

ग्राफ काफी बड़ा है और यदि आप "माथे पर" इसका वर्णन करते हैं, तो बहुत सारे मैनुअल त्रुटि मुक्त काम की आवश्यकता होगी। यदि आप बारीकी से देखते हैं, तो आप केवल कुछ क्षेत्रों की सामग्री में अंतर के साथ दोहराए जाने वाले तत्वों को अलग कर सकते हैं। यह कैसे ग्राफ 1, m2, m2_1, m2_2, m3, m4 की तरह दिखता है । मैक्रोज़ का उपयोग करते हुए छोटे मशीनीकरण के उपयोग के लिए ये पहले उम्मीदवार हैं। हमारे मुख्य डॉट फ़ाइल के लिए एक हेडर फ़ाइल बनाएँ। इसे कहते हैं common.dot :

//  common.dot       .

#define Q(x) #x         //    ""   .

#define QUOTE(x) Q(x)   //   ""    .

//         mblk_t.
//       . 
#define msg_staff \
   <p> *prev \
  |<n> *next \
  |<c> *cont  \
  |<d> *data \
  | other\nstuff

//        mblk_t.
#define msg(name, ... ) \
name[xlabel=mblk_t label=QUOTE(<h> name | msg_staff) \
];

//        dblk_t.
#define dbuf(name ...) \
name[label=QUOTE(<h> name) xlabel="dblk_t"];

//       queue_t.
//         mblk_t, 
//      msg_staff.
#define queue(name, ...) \
name[ xlabel="queue_t" label=QUOTE(<h> name | \
msg_staff)];

अब मुख्य ग्राफ़ फ़ाइल लिखने का समय है। चलो इसे my_graph.dot कहते हैं :

//  my_graph.dot

//      .
#include "common.dot"

digraph queue_demo
{
    rankdir=LR;
    node[shape=Mrecord];

    //     ,
    //  ,       .
    dbuf(d1);
    dbuf(d2);
    dbuf(d2_1);
    dbuf(d2_2);
    dbuf(d3);
    dbuf(d4);

    //  ,      ,
    //     .
    msg(m1);
    msg(m2);
    msg(m2_1);
    msg(m2_2);
    msg(m3);
    msg(m4);

    //     .
    //     q1.
    queue(q1);

    //       .
    m1:d->d1;
    m2:d->d2;
    m2_1:d->d2_1;
    m2_2:d->d2_2;
    m3:d->d3;
    m4:d->d4;

    //     .
    m1:n -> m2:h;
    m1:p -> q1:h;
    m2:n -> m3:h;
    m2:c->m2_1:h;
    m2_1:c->m2_2:h;
    m3:n -> m4:h;

    m2:p -> m1:h;
    m3:p -> m2:h;
    m4:p -> m3:h;

    //      .
    q1:n->m1:h;  
    q1:p->m4:h;
    m4:n -> q1:h[color=blue]; //    .
}

हम फ़ाइल को प्रीप्रोसेसर के साथ संसाधित करते हैं:

cpp my_graph.dot -o my_graph_res.dot

my_graph_res.dot. :

# 1 "<built-in>"
# 1 "<command-line>"
# 1 "my_graph.dot"

# 1 "common.dot" 1
# 3 "my_graph.dot" 2

digraph queue_demo
{
    rankdir=LR;
    node[shape=Mrecord];

    d1[label="<h> d1" xlabel="dblk_t"];;
    d2[label="<h> d2" xlabel="dblk_t"];;
    d2_1[label="<h> d2_1" xlabel="dblk_t"];;
    d2_2[label="<h> d2_2" xlabel="dblk_t"];;
    d3[label="<h> d3" xlabel="dblk_t"];;
    d4[label="<h> d4" xlabel="dblk_t"];;

    m1[xlabel=mblk_t label="<h> m1 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;
    m2[xlabel=mblk_t label="<h> m2 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;
    m2_1[xlabel=mblk_t label="<h> m2_1 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;
    m2_2[xlabel=mblk_t label="<h> m2_2 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;
    m3[xlabel=mblk_t label="<h> m3 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;
    m4[xlabel=mblk_t label="<h> m4 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff" ];;

    q1[ xlabel="queue_t" label="<h> q1 | <p> *prev |<n> *next |<c> *cont |<d> *data | other\nstuff"];;

    m1:d->d1;
    m2:d->d2;
    m2_1:d->d2_1;
    m2_2:d->d2_2;
    m3:d->d3;
    m4:d->d4;

    m1:n -> m2:h;
    m1:p -> q1:h;
    m2:n -> m3:h;
    m2:c->m2_1:h;
    m2_1:c->m2_2:h;
    m3:n -> m4:h;

    m2:p -> m1:h;
    m3:p -> m2:h;
    m4:p -> m3:h;

    q1:n->m1:h;
    q1:p->m4:h;
    m4:n -> q1:h[color=blue];
}

, . . Graphviz ( dot) : https://sketchviz.com/new

:

, , .

.