Guide API
Skip to main content

create_graph

Function create_graph 

Source
pub fn create_graph(
    level: i32,
    lines: i64,
    flags: u16,
    lev_width: i32,
    end_width: i32,
    chars: &[char; 8],
) -> String
Expand description

Build the box-drawing prefix string for one outline row.

Returns the indent and connector graphic that appears to the left of each node’s text label. level is the nesting depth (0 = root); lines is the continuation-bar bitmask (bit k set means level k draws a vertical bar through this row); flags combines OV_EXPANDED, OV_CHILDREN, and OV_LAST; lev_width and end_width are the column widths of the per-level indent and the connector end-graphic (both 3 in the default style).

chars maps symbol roles to characters: [0] = level filler (space), [1] = level continuation bar (│), [2] = end connector for a non-last child (├), [3] = end connector for the last child (└), [4] = end filler / straight run (─), [5] = end child-link indicator (─ or a custom char), [6] = retracted (collapsed, +), [7] = expanded (─ or space).

Use ov_get_graph for the default style. Call create_graph directly only when you need a custom character set or different column widths.

§Turbo Vision heritage

Ports TOutlineViewer::createGraph (toutline.cpp). The C++ const char* byte string becomes a &[char; 8] typed array.