Definition at line 2212 of file OptionParser.h.

Public Member Functions
	LineWrapper (int x1, int x2)
	Constructs a LineWrapper that wraps its output to fit into screen columns `x1` (incl.) to `x2` (excl.).

void	flush (IStringWriter &write)
	Writes out all remaining data from the LineWrapper using `write`.

void	process (IStringWriter &write, const char *data, int len)
	Process, wrap and output the next piece of data.

Private Member Functions
bool	buf_empty ()

bool	buf_full ()

void	buf_next ()
	Call BEFORE reading ...buf[tail].

void	buf_store (const char *data, int len)

void	output (IStringWriter &write, const char *data, int len)
	Writes (data,len) into the ring buffer.

void	write_one_line (IStringWriter &write)
	Writes a single line of output from the buffer to `write`.

Private Attributes
const char *	datbuf [bufmask+1]
	Ring buffer for data component of pair (data, length).

int	head
	index for next write

int	lenbuf [bufmask+1]
	Ring buffer for length component of pair (data, length).

int	tail
	index for next read - 1 (i.e.

int	width
	The width of the column to line wrap.

bool	wrote_something
	Multiple methods of LineWrapper may decide to flush part of the buffer to free up space.

int	x
	The indentation of the column to which the LineBuffer outputs.

Static Private Attributes
static const int	bufmask = 15
	Must be a power of 2 minus 1.

#include </home/sftnight/build/workspace/root-makedoc-v624/rootspi/rdoc/src/v6-24-00-patches/core/dictgen/res/OptionParser.h>

Constructor & Destructor Documentation

◆ LineWrapper()

ROOT::option::PrintUsageImplementation::LineWrapper::LineWrapper	(	int	x1,
		int	x2
	)

inline

Constructs a LineWrapper that wraps its output to fit into screen columns x1 (incl.) to x2 (excl.).

x1 gives the indentation LineWrapper uses if it needs to indent.

Definition at line 2421 of file OptionParser.h.

Member Function Documentation

◆ buf_empty()

bool ROOT::option::PrintUsageImplementation::LineWrapper::buf_empty ( )

inlineprivate

Definition at line 2246 of file OptionParser.h.

◆ buf_full()

bool ROOT::option::PrintUsageImplementation::LineWrapper::buf_full ( )

inlineprivate

Definition at line 2251 of file OptionParser.h.

◆ buf_next()

void ROOT::option::PrintUsageImplementation::LineWrapper::buf_next ( )

inlineprivate

Call BEFORE reading ...buf[tail].

Definition at line 2264 of file OptionParser.h.

◆ buf_store()

void ROOT::option::PrintUsageImplementation::LineWrapper::buf_store	(	const char *	data,
		int	len
	)

inlineprivate

Definition at line 2256 of file OptionParser.h.

◆ flush()

void ROOT::option::PrintUsageImplementation::LineWrapper::flush ( IStringWriter & write )

inline

Writes out all remaining data from the LineWrapper using write.

Unlike process() this method indents all lines including the first and will output a \n at the end (but only if something has been written).

Definition at line 2308 of file OptionParser.h.

◆ output()

void ROOT::option::PrintUsageImplementation::LineWrapper::output	(	IStringWriter &	write,
		const char *	data,
		int	len
	)

inlineprivate

Writes (data,len) into the ring buffer.

If the buffer is full, a single line is flushed out of the buffer into write.

Definition at line 2273 of file OptionParser.h.

◆ process()

void ROOT::option::PrintUsageImplementation::LineWrapper::process	(	IStringWriter &	write,
		const char *	data,
		int	len
	)

inline

Process, wrap and output the next piece of data.

process() will output at least one line of output. This is not necessarily the data passed in. It may be data queued from a prior call to process(). If the internal buffer is full, more than 1 line will be output.

process() assumes that the a proper amount of indentation has already been output. It won't write any further indentation before the 1st line. If more than 1 line is written due to buffer constraints, the lines following the first will be indented by this method, though.

No \n is written by this method after the last line that is written.

Parameters

write	where to write the data.
data	the new chunk of data to write.
len	the length of the chunk of data to write.

Definition at line 2338 of file OptionParser.h.

◆ write_one_line()

void ROOT::option::PrintUsageImplementation::LineWrapper::write_one_line ( IStringWriter & write )

inlineprivate

Writes a single line of output from the buffer to write.

Definition at line 2284 of file OptionParser.h.

Member Data Documentation

◆ bufmask

const int ROOT::option::PrintUsageImplementation::LineWrapper::bufmask = 15

staticprivate

Must be a power of 2 minus 1.

Definition at line 2214 of file OptionParser.h.

◆ datbuf

const char* ROOT::option::PrintUsageImplementation::LineWrapper::datbuf[bufmask+1]

private

Ring buffer for data component of pair (data, length).

Definition at line 2222 of file OptionParser.h.

◆ head

int ROOT::option::PrintUsageImplementation::LineWrapper::head

private

index for next write

Definition at line 2234 of file OptionParser.h.

◆ lenbuf

int ROOT::option::PrintUsageImplementation::LineWrapper::lenbuf[bufmask+1]

private

Ring buffer for length component of pair (data, length).

Definition at line 2218 of file OptionParser.h.

◆ tail

int ROOT::option::PrintUsageImplementation::LineWrapper::tail

private

index for next read - 1 (i.e.

increment tail BEFORE read)

Definition at line 2235 of file OptionParser.h.

◆ width

int ROOT::option::PrintUsageImplementation::LineWrapper::width

private

The width of the column to line wrap.

Definition at line 2233 of file OptionParser.h.

◆ wrote_something

bool ROOT::option::PrintUsageImplementation::LineWrapper::wrote_something

private

Multiple methods of LineWrapper may decide to flush part of the buffer to free up space.

The contract of process() says that only 1 line is output. So this variable is used to track whether something has output a line. It is reset at the beginning of process() and checked at the end to decide if output has already occurred or is still needed.

Definition at line 2244 of file OptionParser.h.

◆ x

int ROOT::option::PrintUsageImplementation::LineWrapper::x

private

The indentation of the column to which the LineBuffer outputs.

LineBuffer assumes that the indentation has already been written when process() is called, so this value is only used when a buffer flush requires writing additional lines of output.

Definition at line 2229 of file OptionParser.h.

core/dictgen/res/OptionParser.h

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Constructor & Destructor Documentation

◆ LineWrapper()

Member Function Documentation

◆ buf_empty()

◆ buf_full()

◆ buf_next()

◆ buf_store()

◆ flush()

◆ output()

◆ process()

◆ write_one_line()

Member Data Documentation

◆ bufmask

◆ datbuf

◆ head

◆ lenbuf

◆ tail

◆ width

◆ wrote_something

◆ x