UNSETBDDREFEXT(3)

💅 unsetbddrefext — BDD FUNCTIONS, section 3, bestie edition 💅

🎀 NAME 🎀

Okay so this is unsetbddrefext from the BDD FUNCTIONS manual, section 3 — aka UNSETBDDREFEXT(3). It’s the function that increments the internal reference and decrements the external reference of a bdd node. Slay. 💖

🦋 ORIGIN 🦋

This software belongs to the ALLIANCE CAD SYSTEM developed by the ASIM team at the LIP6 laboratory of Université Pierre and Marie CURIE, in Paris, France. Ooh la la. 🇫🇷✨

• Web : http://asim.lip6.fr/recherche/alliance/
• E-mail : alliance-users@asim.lip6.fr

✨ SYNOPSIS ✨

#include "bdd101.h"
bddnode ∗unsetbddrefext( BddNode )
  bddnode ∗BddNode;

🫶 PARAMETERS 🫶

• BddNode — the bdd node, bestie. That’s the node whose ref counts are getting adjusted.

💖 DESCRIPTION 💖

unsetbddrefext increments the number of internal reference of the bdd node BddNode and decrements its number of external reference. That’s the whole move: internal goes up, external goes down. Iconic. 💅

🎀 RETURN VALUE 🎀

unsetbddrefext returns the BddNode pointer. Yup, it hands you back the same pointer. 🫶

💀 ERRORS 💀

Error alert, bestie: you can get this exact message:

"negative reference, index xxx error !"

The BddNode must have a positive number of external reference. So keep that external ref count positive, okay? 😭

🌸 EXAMPLE 🌸

Here’s the example in all its glory — copy it exactly, no cap:

#include "bdd101.h"
   bddsystem  ∗BddSystem;
   bddcircuit ∗BddCircuit;
   bddnode    ∗BddNode;
   chain_list ∗Expr;
   BddSystem  = createbddsystem( 100, 1000, 100, 50000 );
   BddCircuit = createbddcircuit( "hello_world", 10, 10, BddSystem );
   BddNode = addbddcircuitin( (bddcircuit ∗)0, "i0", 0, BDD_IN_MODE_FIRST );
   BddNode = addbddnode( (bddsystem ∗)0, BddNode->INDEX, BddNode->LOW, BddNode->HIGH );
   Expr = convertbddcircuitabl( (bddcircuit ∗)0, BddNode );
   incbddrefext( BddNode );
   unsetbddrefext( BddNode );
   /* displays Node VAR: 0  INDEX: 2  MARK: 0  REF_EXT: 0  REF_INT: 1 */
   viewbddnode( (bddsystem ∗)0, BddNode );
   /* displays (not i0) */
   viewablexpr( Expr, ABL_VIEW_VHDL );
   freeablexpr( Expr );
   destroybddsystem( (bddsystem ∗)0 );
   destroybddcircuit( (bddcircuit ∗)0 );

And that’s the example, periodt. 🍓

👑 SEE ALSO 👑

• bdd(1) — go see that page too, bestie.

🧚 BUG REPORT 🧚

This tool is under development at the ASIM department of the LIP6 laboratory. We need your feedback to improve documentation and tools. So if you’ve got notes, send them — they literally need your feedback. 🫶

Sign-off cuteness: this page is from ASIM/LIP6, dated October 1, 1997, and it’s the UNSETBDDREFEXT(3) page. Periodt. 💅✨