Column

Column — defines output columns formats, headers, etc.

Functions

Types and Values

Description

An API to access and modify per-column data and information.

Functions

scols_column_get_color ()

const char *
scols_column_get_color (struct libscols_column *cl);

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

The current color setting of the column cl .


scols_column_get_flags ()

int
scols_column_get_flags (struct libscols_column *cl);

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

The flag mask of cl , a negative value in case of an error.


scols_column_get_header ()

struct libscols_cell *
scols_column_get_header (struct libscols_column *cl);

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

A pointer to a struct libscols_cell instance, representing the header info of column cl or NULL in case of an error.


scols_column_get_whint ()

double
scols_column_get_whint (struct libscols_column *cl);

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

The width hint of column cl , a negative value in case of an error.


scols_column_is_hidden ()

int
scols_column_is_hidden (struct libscols_column *cl);

Gets the value of cl 's flag hidden.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

hidden flag value, negative value in case of an error.

Since: 2.27


scols_column_is_noextremes ()

int
scols_column_is_noextremes (struct libscols_column *cl);

Gets the value of cl 's flag no_extremes.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

no_extremes flag value, negative value in case of an error.


scols_column_is_right ()

int
scols_column_is_right (struct libscols_column *cl);

Gets the value of cl 's flag right.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

right flag value, negative value in case of an error.


scols_column_is_strict_width ()

int
scols_column_is_strict_width (struct libscols_column *cl);

Gets the value of cl 's flag strict_width.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

strict_width flag value, negative value in case of an error.


scols_column_is_tree ()

int
scols_column_is_tree (struct libscols_column *cl);

Gets the value of cl 's flag tree.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

tree flag value, negative value in case of an error.


scols_column_is_trunc ()

int
scols_column_is_trunc (struct libscols_column *cl);

Gets the value of cl 's flag trunc.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

trunc flag value, negative value in case of an error.


scols_column_is_wrap ()

int
scols_column_is_wrap (struct libscols_column *cl);

Gets the value of cl 's flag wrap.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

wrap flag value, negative value in case of an error.

Since: 2.28


scols_column_set_cmpfunc ()

int
scols_column_set_cmpfunc (struct libscols_column *cl,
                          int (*cmp) (struct libscols_cell *a, struct libscols_cell *b, void *),
                          void *data);

Parameters

cl

column

 

cmp

pointer to compare function

 

data

private data for cmp function

 

Returns

0, a negative value in case of an error.


scols_column_set_color ()

int
scols_column_set_color (struct libscols_column *cl,
                        const char *color);

The default color for data cells and column header.

If you want to set header specific color then use scols_column_get_header() and scols_cell_set_color().

If you want to set data cell specific color the use scols_line_get_cell() + scols_cell_set_color().

Parameters

cl

a pointer to a struct libscols_column instance

 

color

color name or ESC sequence

 

Returns

0, a negative value in case of an error.


scols_column_set_flags ()

int
scols_column_set_flags (struct libscols_column *cl,
                        int flags);

Sets the flags of cl to flags .

Parameters

cl

a pointer to a struct libscols_column instance

 

flags

a flag mask

 

Returns

0, a negative value in case of an error.


scols_column_set_whint ()

int
scols_column_set_whint (struct libscols_column *cl,
                        double whint);

Sets the width hint of column cl to whint . See scols_table_new_column().

Parameters

cl

a pointer to a struct libscols_column instance

 

whint

a width hint

 

Returns

0, a negative value in case of an error.


scols_copy_column ()

struct libscols_column *
scols_copy_column (const struct libscols_column *cl);

Creates a new column and copies cl 's data over to it.

Parameters

cl

a pointer to a struct libscols_column instance

 

Returns

a pointer to a new struct libscols_column instance.


scols_new_column ()

struct libscols_column *
scols_new_column (void);

Allocates space for a new column.

Returns

a pointer to a new struct libscols_cell instance, NULL in case of an ENOMEM error.


scols_ref_column ()

void
scols_ref_column (struct libscols_column *cl);

Increases the refcount of cl .

Parameters

cl

a pointer to a struct libscols_column instance

 

scols_unref_column ()

void
scols_unref_column (struct libscols_column *cl);

Decreases the refcount of cl . When the count falls to zero, the instance is automatically deallocated.

Parameters

cl

a pointer to a struct libscols_column instance

 

Types and Values

struct libscols_column

struct libscols_column;

A column - defines the number of columns and column names