A TGText is a multi line text buffer.

It allows the text to be loaded from file, saved to file and edited. It is used in the TGTextEdit widget. Single line text is handled by TGTextBuffer and the TGTextEntry widget.

Definition at line 57 of file TGText.h.

Public Member Functions
	TGText ()
	Create default (empty) text buffer.

	TGText (const char *string)
	Create text buffer and initialize with single line string.

	TGText (TGText *text)
	Create text buffer and initialize with other text buffer.

virtual	~TGText ()
	Destroy text buffer.

Bool_t	AddText (TGText *text)
	Add another text buffer to this buffer.

Bool_t	Append (const char *fn)
	Append buffer to file fn.

TString	AsString ()
	Returns content as ROOT string.

Bool_t	BreakLine (TGLongPosition pos)
	Break line at position pos. Returns false if pos is not valid.

void	Clear ()
	Clear text buffer.

Long_t	ColCount () const

Bool_t	DelChar (TGLongPosition pos)
	Delete character at specified position pos.

Bool_t	DelLine (ULong_t pos)
	Delete specified row. Returns false if row does not exist.

Bool_t	DelText (TGLongPosition start, TGLongPosition end)
	Delete text between start and end positions.

char	GetChar (TGLongPosition pos)
	Get character a position pos. If character not valid return -1.

TGTextLine *	GetCurrentLine () const

const char *	GetFileName () const

char *	GetLine (TGLongPosition pos, ULong_t length)
	Return string at position pos.

Long_t	GetLineLength (Long_t row)
	Get length of specified line. Returns -1 if row does not exist.

Long_t	GetLongestLine () const

Bool_t	InsChar (TGLongPosition pos, char c)
	Insert character c at the specified position pos.

Bool_t	InsLine (ULong_t row, const char *string)
	Insert string before specified position.

Bool_t	InsText (TGLongPosition ins_pos, TGText *src, TGLongPosition start_src, TGLongPosition end_src)
	Insert src text from start_src to end_src into text at position ins_pos.

Bool_t	InsText (TGLongPosition pos, const char *buf)
	Insert single line at specified position.

virtual TClass *	IsA () const

Bool_t	IsSaved () const

Bool_t	Load (const char *fn, Long_t startpos=0, Long_t length=-1)
	Load text from file fn.

Bool_t	LoadBuffer (const char *txtbuf)
	Load a 0 terminated buffer. Lines will be split at ' '.

Bool_t	Replace (TGLongPosition start, const char oldText, const char newText, Bool_t direction, Bool_t caseSensitive)
	Replace oldText by newText. Returns false if nothing replaced.

void	ReTab (Long_t row)
	Redo all tabs in a line. Needed after a new tab is inserted.

Long_t	RowCount () const

Bool_t	Save (const char *fn)
	Save text buffer to file fn.

Bool_t	Search (TGLongPosition foundPos, TGLongPosition start, const char searchString, Bool_t direction, Bool_t caseSensitive)
	Search for string searchString starting at the specified position going in forward (direction = true) or backward direction.

virtual void	Streamer (TBuffer &)

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

Static Public Member Functions
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

Protected Member Functions
	TGText (const TGText &)
	copy constructor

void	Init ()
	Common initialization method.

void	LongestLine ()
	Set fLongestLine.

TGText &	operator= (const TGText &)
	assignment operator

Bool_t	SetCurrentRow (Long_t row)
	Make specified row the current row.

Protected Attributes
Long_t	fColCount
	number of columns in current line

TGTextLine *	fCurrent
	current line

Long_t	fCurrentRow
	current row number

TString	fFilename
	name of opened file ("" if open buffer)

TGTextLine *	fFirst
	first line of text

Bool_t	fIsSaved
	false if text needs to be saved

Long_t	fLongestLine
	length of longest line

Long_t	fRowCount
	number of rows

#include <TGText.h>

Constructor & Destructor Documentation

◆ TGText() [1/4]

TGText::TGText ( const TGText & gt )

protected

copy constructor

Definition at line 316 of file TGText.cxx.

◆ TGText() [2/4]

TGText::TGText ( )

Create default (empty) text buffer.

Definition at line 363 of file TGText.cxx.

◆ TGText() [3/4]

TGText::TGText ( TGText * text )

Create text buffer and initialize with other text buffer.

Definition at line 371 of file TGText.cxx.

◆ TGText() [4/4]

TGText::TGText ( const char * string )

Create text buffer and initialize with single line string.

Definition at line 385 of file TGText.cxx.

◆ ~TGText()

TGText::~TGText ( )

virtual

Destroy text buffer.

Definition at line 397 of file TGText.cxx.

Member Function Documentation

◆ AddText()

Bool_t TGText::AddText ( TGText * text )

Add another text buffer to this buffer.

Definition at line 911 of file TGText.cxx.

◆ Append()

Bool_t TGText::Append ( const char * fn )

Append buffer to file fn.

Definition at line 651 of file TGText.cxx.

◆ AsString()

TString TGText::AsString ( )

Returns content as ROOT string.

Definition at line 1238 of file TGText.cxx.

◆ BreakLine()

Bool_t TGText::BreakLine ( TGLongPosition pos )

Break line at position pos. Returns false if pos is not valid.

Definition at line 1008 of file TGText.cxx.

◆ Class()

static TClass * TGText::Class ( )

static

Returns: TClass describing this class

◆ Class_Name()

static const char * TGText::Class_Name ( )

static

Returns: Name of this class

◆ Class_Version()

static constexpr Version_t TGText::Class_Version ( )

inlinestaticconstexpr

Returns: Version of this class

Definition at line 119 of file TGText.h.

◆ Clear()

void TGText::Clear ( )

Clear text buffer.

Definition at line 406 of file TGText.cxx.

◆ ColCount()

Long_t TGText::ColCount ( ) const

inline

Definition at line 107 of file TGText.h.

◆ DeclFileName()

static const char * TGText::DeclFileName ( )

inlinestatic

Returns: Name of the file containing the class declaration

Definition at line 119 of file TGText.h.

◆ DelChar()

Bool_t TGText::DelChar ( TGLongPosition pos )

Delete character at specified position pos.

Definition at line 691 of file TGText.cxx.

◆ DelLine()

Bool_t TGText::DelLine ( ULong_t pos )

Delete specified row. Returns false if row does not exist.

Definition at line 964 of file TGText.cxx.

◆ DelText()

Bool_t TGText::DelText	(	TGLongPosition	start,
		TGLongPosition	end
	)

Delete text between start and end positions.

Returns false in case of failure (start and end not being within bounds).

Definition at line 736 of file TGText.cxx.

◆ GetChar()

char TGText::GetChar ( TGLongPosition pos )

Get character a position pos. If character not valid return -1.

Definition at line 723 of file TGText.cxx.

◆ GetCurrentLine()

TGTextLine * TGText::GetCurrentLine ( ) const

inline

Definition at line 102 of file TGText.h.

◆ GetFileName()

const char * TGText::GetFileName ( ) const

inline

Definition at line 88 of file TGText.h.

◆ GetLine()

char * TGText::GetLine	(	TGLongPosition	pos,
		ULong_t	length
	)

Return string at position pos.

Returns 0 in case pos is not valid. The returned string must be deleted by the user.

Definition at line 997 of file TGText.cxx.

◆ GetLineLength()

Long_t TGText::GetLineLength ( Long_t row )

Get length of specified line. Returns -1 if row does not exist.

Definition at line 1043 of file TGText.cxx.

◆ GetLongestLine()

Long_t TGText::GetLongestLine ( ) const

inline

Definition at line 110 of file TGText.h.

◆ Init()

void TGText::Init ( )

protected

Common initialization method.

Definition at line 349 of file TGText.cxx.

◆ InsChar()

Bool_t TGText::InsChar	(	TGLongPosition	pos,
		char	c
	)

Insert character c at the specified position pos.

Definition at line 707 of file TGText.cxx.

◆ InsLine()

Bool_t TGText::InsLine	(	ULong_t	pos,
		const char *	string
	)

Insert string before specified position.

Returns false if insertion failed.

Definition at line 928 of file TGText.cxx.

◆ InsText() [1/2]

Bool_t TGText::InsText	(	TGLongPosition	ins_pos,
		TGText *	src,
		TGLongPosition	start_src,
		TGLongPosition	end_src
	)

Insert src text from start_src to end_src into text at position ins_pos.

Returns false in case of failure (start_src, end_src out of range for src, and ins_pos out of range for this).

Definition at line 785 of file TGText.cxx.

◆ InsText() [2/2]

Bool_t TGText::InsText	(	TGLongPosition	pos,
		const char *	buffer
	)

Insert single line at specified position.

Return false in case position is out of bounds.

Definition at line 888 of file TGText.cxx.

◆ IsA()

virtual TClass * TGText::IsA ( ) const

inlinevirtual

Returns: TClass describing current object

Definition at line 119 of file TGText.h.

◆ IsSaved()

Bool_t TGText::IsSaved ( ) const

inline

Definition at line 87 of file TGText.h.

◆ Load()

Bool_t TGText::Load	(	const char *	fn,
		Long_t	startpos = `0`,
		Long_t	length = `-1`
	)

Load text from file fn.

Startpos is the begin from where to load the file and length is the number of characters to read from the file.

Definition at line 431 of file TGText.cxx.

◆ LoadBuffer()

Bool_t TGText::LoadBuffer ( const char * txtbuf )

Load a 0 terminated buffer. Lines will be split at '
'.

Definition at line 513 of file TGText.cxx.

◆ LongestLine()

void TGText::LongestLine ( )

protected

Set fLongestLine.

Definition at line 1220 of file TGText.cxx.

◆ operator=()

TGText & TGText::operator= ( const TGText & gt )

protected

assignment operator

Definition at line 331 of file TGText.cxx.

◆ Replace()

Bool_t TGText::Replace	(	TGLongPosition	start,
		const char *	oldText,
		const char *	newText,
		Bool_t	direction,
		Bool_t	caseSensitive
	)

Replace oldText by newText. Returns false if nothing replaced.

Definition at line 1197 of file TGText.cxx.

◆ ReTab()

void TGText::ReTab ( Long_t row )

Redo all tabs in a line. Needed after a new tab is inserted.

Definition at line 1087 of file TGText.cxx.

◆ RowCount()

Long_t TGText::RowCount ( ) const

inline

Definition at line 106 of file TGText.h.

◆ Save()

Bool_t TGText::Save ( const char * fn )

Save text buffer to file fn.

Definition at line 610 of file TGText.cxx.

◆ Search()

Bool_t TGText::Search	(	TGLongPosition *	foundPos,
		TGLongPosition	start,
		const char *	searchString,
		Bool_t	direction,
		Bool_t	caseSensitive
	)

Search for string searchString starting at the specified position going in forward (direction = true) or backward direction.

Returns true if found and foundPos is set accordingly.

Definition at line 1143 of file TGText.cxx.

◆ SetCurrentRow()

Bool_t TGText::SetCurrentRow ( Long_t row )

protected

Make specified row the current row.

Returns false if row does not exist. In which case fCurrent is not changed or set to the last valid line.

Definition at line 1055 of file TGText.cxx.

◆ Streamer()

virtual void TGText::Streamer ( TBuffer & )

virtual

◆ StreamerNVirtual()

void TGText::StreamerNVirtual ( TBuffer & ClassDef_StreamerNVirtual_b )

inline

Definition at line 119 of file TGText.h.

Member Data Documentation

◆ fColCount

Long_t TGText::fColCount

protected

number of columns in current line

Definition at line 66 of file TGText.h.

◆ fCurrent

TGTextLine* TGText::fCurrent

protected

current line

Definition at line 63 of file TGText.h.

◆ fCurrentRow

Long_t TGText::fCurrentRow

protected

current row number

Definition at line 64 of file TGText.h.

◆ fFilename

TString TGText::fFilename

protected

name of opened file ("" if open buffer)

Definition at line 60 of file TGText.h.

◆ fFirst

TGTextLine* TGText::fFirst

protected

first line of text

Definition at line 62 of file TGText.h.

◆ fIsSaved

Bool_t TGText::fIsSaved

protected

false if text needs to be saved

Definition at line 61 of file TGText.h.

◆ fLongestLine

Long_t TGText::fLongestLine

protected

length of longest line

Definition at line 67 of file TGText.h.

◆ fRowCount

Long_t TGText::fRowCount

protected

number of rows

Definition at line 65 of file TGText.h.

Libraries for TGText:

[legend]

The documentation for this class was generated from the following files:

gui/gui/inc/TGText.h
gui/gui/src/TGText.cxx

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

◆ TGText() [1/4]

◆ TGText() [2/4]

◆ TGText() [3/4]

◆ TGText() [4/4]

◆ ~TGText()

Member Function Documentation

◆ AddText()

◆ Append()

◆ AsString()

◆ BreakLine()

◆ Class()

◆ Class_Name()

◆ Class_Version()

◆ Clear()

◆ ColCount()

◆ DeclFileName()

◆ DelChar()

◆ DelLine()

◆ DelText()

◆ GetChar()

◆ GetCurrentLine()

◆ GetFileName()

◆ GetLine()

◆ GetLineLength()

◆ GetLongestLine()

◆ Init()

◆ InsChar()

◆ InsLine()

◆ InsText() [1/2]

◆ InsText() [2/2]

◆ IsA()

◆ IsSaved()

◆ Load()

◆ LoadBuffer()

◆ LongestLine()

◆ operator=()

◆ Replace()

◆ ReTab()

◆ RowCount()

◆ Save()

◆ Search()

◆ SetCurrentRow()

◆ Streamer()

◆ StreamerNVirtual()

Member Data Documentation

◆ fColCount

◆ fCurrent

◆ fCurrentRow

◆ fFilename

◆ fFirst

◆ fIsSaved

◆ fLongestLine

◆ fRowCount