Logo ROOT  
Reference Guide
Loading...
Searching...
No Matches
TSQLiteStatement Class Reference

Definition at line 25 of file TSQLiteStatement.h.

Public Types

enum  { kSingleKey = (1ULL << (0)) , kOverwrite = (1ULL << (1)) , kWriteDelete = (1ULL << (2)) }
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << (3)) }
enum  EStatusBits {
  kCanDelete = (1ULL << (0)) , kMustCleanup = (1ULL << (3)) , kIsReferenced = (1ULL << (4)) , kHasUUID = (1ULL << (5)) ,
  kCannotPick = (1ULL << (6)) , kNoContextMenu = (1ULL << (8)) , kInvalidObject = (1ULL << (13))
}

Public Member Functions

 TSQLiteStatement (SQLite3_Stmt_t *stmt, Bool_t errout=kTRUE)
 Normal constructor.
virtual ~TSQLiteStatement ()
 Destructor.
void AbstractMethod (const char *method) const
 Call this function within a function that you don't want to define as purely virtual, in order not to force all users deriving from that class to implement that maybe (on their side) unused function; but at the same time, emit a run-time warning if they try to call it, telling that it is not implemented in the derived class: action must thus be taken on the user side to override it.
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action.
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
 ClassDefOverride (TSQLiteStatement, 0)
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
virtual void Clear (Option_t *="")
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility.
void Close (Option_t *="") final
 Close statement.
virtual Int_t Compare (const TObject *obj) const
 Compare abstract method.
virtual void Copy (TObject &object) const
 Copy this to obj.
virtual void Delete (Option_t *option="")
 Delete this object.
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object.
virtual void Draw (Option_t *option="")
 Default Draw method for all objects.
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
virtual void Dump () const
 Dump contents of object on stdout.
virtual void EnableErrorOutput (Bool_t on=kTRUE)
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
virtual void Execute (const char *method, const char *params, Int_t *error=nullptr)
 Execute method on this object with the given parameter string, e.g.
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr)
 Execute method on this object with parameters stored in the TObjArray.
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py).
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
Bool_t GetBinary (Int_t npar, void *&mem, Long_t &size) final
 Return field value as binary array.
Int_t GetBufferLength () const final
Bool_t GetDate (Int_t npar, Int_t &year, Int_t &month, Int_t &day) final
 Return field value as date.
Bool_t GetDatime (Int_t npar, Int_t &year, Int_t &month, Int_t &day, Int_t &hour, Int_t &min, Int_t &sec) final
 Return field value as date & time.
TDatime GetDatime (Int_t)
 return value of parameter in form of TDatime Be aware, that TDatime does not allow dates before 1995-01-01
Int_t GetDay (Int_t)
 return day value for parameter (if applicable)
Double_t GetDouble (Int_t npar) final
 Return field value as double.
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
virtual Int_t GetErrorCode () const
 Abstract base class defining SQL statements, which can be submitted in bulk to DB server.
virtual const char * GetErrorMsg () const
 returns error message of last operation if no errors, return 0 Each specific implementation of TSQLStatement provides its own error messages
const char * GetFieldName (Int_t nfield) final
 Returns field name in result set.
Int_t GetHour (Int_t)
 return hours value for parameter (if applicable)
virtual const char * GetIconName () const
 Returns mime type name of object.
Int_t GetInt (Int_t npar) final
 Get integer.
virtual Bool_t GetLargeObject (Int_t col, void *&mem, Long_t &size)
Long_t GetLong (Int_t npar) final
 Get long.
Long64_t GetLong64 (Int_t npar) final
 Get long64.
Int_t GetMinute (Int_t)
 return minutes value for parameter (if applicable)
Int_t GetMonth (Int_t)
 return month value for parameter (if applicable)
virtual const char * GetName () const
 Returns name of object.
Int_t GetNumAffectedRows () final
 Return number of affected rows after statement is processed.
Int_t GetNumFields () final
 Return number of fields in result set.
Int_t GetNumParameters () final
 Return number of statement parameters.
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py).
virtual Option_tGetOption () const
Int_t GetSecond (Int_t)
 return seconds value for parameter (if applicable)
Int_t GetSecondsFraction (Int_t)
 return seconds fraction value for parameter (if applicable)
const char * GetString (Int_t npar) final
 Return field value as string.
Bool_t GetTime (Int_t npar, Int_t &hour, Int_t &min, Int_t &sec) final
 Return field as time.
Bool_t GetTimestamp (Int_t npar, Int_t &year, Int_t &month, Int_t &day, Int_t &hour, Int_t &min, Int_t &sec, Int_t &) final
 Return field as timestamp.
TDatime GetTimestamp (Int_t)
 return value of parameter in form of TDatime Be aware, that TDatime does not allow dates before 1995-01-01
virtual Bool_t GetTimestamp (Int_t, TTimeStamp &)
 Get parameter as TTimeStamp.
virtual const char * GetTitle () const
 Returns title of object.
UInt_t GetUInt (Int_t npar) final
 Get unsigned integer.
ULong64_t GetULong64 (Int_t npar) final
 Return field value as unsigned 64-bit integer.
virtual UInt_t GetUniqueID () const
 Return the unique object id.
virtual Bool_t GetVDouble (Int_t, std::vector< Double_t > &)
virtual Bool_t GetVInt (Int_t, std::vector< Int_t > &)
virtual Bool_t GetVLong (Int_t, std::vector< Long_t > &)
virtual Bool_t GetVLong64 (Int_t, std::vector< Long64_t > &)
virtual Bool_t GetVUInt (Int_t, std::vector< UInt_t > &)
virtual Bool_t GetVULong64 (Int_t, std::vector< ULong64_t > &)
Int_t GetYear (Int_t)
 return year value for parameter (if applicable)
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
virtual ULong_t Hash () const
 Return hash value for this object.
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
void InvertBit (UInt_t f)
TClassIsA () const override
Bool_t IsDestructed () const
 IsDestructed.
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
virtual Bool_t IsError () const
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
Bool_t IsNull (Int_t npar) final
 Checks if field value is null.
Bool_t IsOnHeap () const
virtual Bool_t IsSortable () const
Bool_t IsZombie () const
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout.
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).
Bool_t NextIteration () final
 Increment iteration counter for statement, where parameter can be set.
Bool_t NextResultRow () final
 Shift cursor to next row in result set.
virtual Bool_t Notify ()
 This method must be overridden to handle object notification (the base implementation is no-op).
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
void operator delete (void *, size_t)
 Operator delete for sized deallocation.
void operator delete (void *ptr)
 Operator delete.
void operator delete (void *ptr, void *vp)
 Only called by placement new when throwing an exception.
void operator delete[] (void *, size_t)
 Operator delete [] for sized deallocation.
void operator delete[] (void *ptr)
 Operator delete [].
void operator delete[] (void *ptr, void *vp)
 Only called by placement new[] when throwing an exception.
void * operator new (size_t sz)
void * operator new (size_t sz, void *vp)
void * operator new[] (size_t sz)
void * operator new[] (size_t sz, void *vp)
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself.
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
virtual void Print (Option_t *option="") const
 This method must be overridden when a class wants to print itself.
Bool_t Process () final
 Process statement.
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
void ResetBit (UInt_t f)
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out".
Bool_t SetBinary (Int_t npar, void *mem, Long_t size, Long_t maxsize=0x1000) final
 Set parameter value as binary data.
void SetBit (UInt_t f)
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
Bool_t SetDate (Int_t npar, Int_t year, Int_t month, Int_t day) final
 Set parameter value as date.
Bool_t SetDate (Int_t, const TDatime &)
 set only date value for specified parameter from TDatime object
Bool_t SetDatime (Int_t npar, Int_t year, Int_t month, Int_t day, Int_t hour, Int_t min, Int_t sec) final
 Set parameter value as date & time.
Bool_t SetDatime (Int_t, const TDatime &)
 set date & time value for specified parameter from TDatime object
Bool_t SetDouble (Int_t npar, Double_t value) final
 Set parameter value as double value.
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
Bool_t SetInt (Int_t npar, Int_t value) final
 Set parameter value as integer.
virtual Bool_t SetLargeObject (Int_t col, void *mem, Long_t size, Long_t maxsize=0x1000)
Bool_t SetLong (Int_t npar, Long_t value) final
 Set parameter value as long.
Bool_t SetLong64 (Int_t npar, Long64_t value) final
 Set parameter value as 64-bit integer.
virtual Bool_t SetMaxFieldSize (Int_t, Long_t)
Bool_t SetNull (Int_t npar) final
 Set NULL as parameter value.
Bool_t SetString (Int_t npar, const char *value, Int_t maxsize=256) final
 Set parameter value as string.
Bool_t SetTime (Int_t npar, Int_t hour, Int_t min, Int_t sec) final
 Set parameter value as time.
Bool_t SetTime (Int_t, const TDatime &)
 set only time value for specified parameter from TDatime object
virtual void SetTimeFormating (const char *)
Bool_t SetTimestamp (Int_t npar, Int_t year, Int_t month, Int_t day, Int_t hour, Int_t min, Int_t sec, Int_t frac=0) final
 Set parameter value as timestamp.
Bool_t SetTimestamp (Int_t, const TDatime &)
 set timestamp value for specified parameter from TDatime object
virtual Bool_t SetTimestamp (Int_t, const TTimeStamp &)
 Set parameter as TTimeStamp.
Bool_t SetUInt (Int_t npar, UInt_t value) final
 Set parameter value as unsigned integer.
Bool_t SetULong64 (Int_t npar, ULong64_t value) final
 Set parameter value as unsigned 64-bit integer.
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
virtual Bool_t SetVDouble (Int_t, const std::vector< Double_t >, const char *, const char *)
virtual Bool_t SetVInt (Int_t, const std::vector< Int_t >, const char *, const char *)
virtual Bool_t SetVLong (Int_t, const std::vector< Long_t >, const char *, const char *)
virtual Bool_t SetVLong64 (Int_t, const std::vector< Long64_t >, const char *, const char *)
virtual Bool_t SetVUInt (Int_t, const std::vector< UInt_t >, const char *, const char *)
virtual Bool_t SetVULong64 (Int_t, const std::vector< ULong64_t >, const char *, const char *)
Bool_t StoreResult () final
 Store result of statement processing to access them via GetInt(), GetDouble() and so on methods.
void Streamer (TBuffer &) override
 Stream an object of class TObject.
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
Bool_t TestBit (UInt_t f) const
Int_t TestBits (UInt_t f) const
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.

Static Public Member Functions

static TClassClass ()
static const char * Class_Name ()
static constexpr Version_t Class_Version ()
static const char * DeclFileName ()
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
static Bool_t GetObjectStat ()
 Get status of object stat flag.
static void SetDtorOnly (void *obj)
 Set destructor only flag.
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.

Protected Types

enum  { kOnlyPrepStep = (1ULL << (3)) }

Protected Member Functions

void ClearError ()
 reset error fields
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected).
void MakeZombie ()
void SetError (Int_t code, const char *msg, const char *method=nullptr)
 set new values for error fields if method specified, displays error message

Static Protected Member Functions

static void SavePrimitiveConstructor (std::ostream &out, TClass *cl, const char *variable_name, const char *constructor_agrs="", Bool_t empty_line=kTRUE)
 Save object constructor in the output stream "out".
static void SavePrimitiveDraw (std::ostream &out, const char *variable_name, Option_t *option=nullptr)
 Save invocation of primitive Draw() method Skipped if option contains "nodraw" string.
static TString SavePrimitiveVector (std::ostream &out, const char *prefix, Int_t len, Double_t *arr, Int_t flag=0)
 Save array in the output stream "out" as vector.

Protected Attributes

Int_t fErrorCode {0}
TString fErrorMsg
Bool_t fErrorOut {kFALSE}

Private Member Functions

Bool_t CheckBindError (const char *method, int res)
long double ConvertToNumeric (Int_t npar)
 Convert field to numeric.
const char * ConvertToString (Int_t npar)
 Convert field value to string.
Bool_t IsResultSetMode () const
Bool_t IsSetParsMode () const
Bool_t SetSQLParamType (Int_t npar, int sqltype, bool sig, int sqlsize=0)

Static Private Member Functions

static void AddToTObjectTable (TObject *)
 Private helper function which will dispatch to TObjectTable::AddObj.

Private Attributes

UInt_t fBits
 bit field status word
Int_t fIterationCount {0}
 ! Iteration count
Int_t fNumPars {0}
 ! Number of bindable / gettable parameters
SQLite3_Stmt_tfStmt {nullptr}
 ! executed statement
UInt_t fUniqueID
 object unique identifier
Int_t fWorkingMode {0}
 ! 1 - setting parameters, 2 - retrieving results

Static Private Attributes

static Longptr_t fgDtorOnly = 0
 object for which to call dtor only (i.e. no delete)
static Bool_t fgObjectStat = kTRUE
 if true keep track of objects in TObjectTable

#include <TSQLiteStatement.h>

Inheritance diagram for TSQLiteStatement:
TSQLStatement TObject

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
protectedinherited
Enumerator
kOnlyPrepStep 

Used to request that the class specific implementation of TObject::Write just prepare the objects to be ready to be written but do not actually write them into the TBuffer.

This is just for example by TBufferMerger to request that the TTree inside the file calls TTree::FlushBaskets (outside of the merging lock) and TBufferMerger will later ask for the write (inside the merging lock). To take advantage of this feature the class needs to overload TObject::Write and use this enum value accordingly. (See TTree::Write and TObject::Write) Do not use, this feature will be migrate to the Merge function (See TClass and TTree::Merge)

Definition at line 106 of file TObject.h.

◆ anonymous enum

anonymous enum
inherited
Enumerator
kSingleKey 

write collection with single key

kOverwrite 

overwrite existing object with same name

kWriteDelete 

write object, then delete previous key with same name

Definition at line 99 of file TObject.h.

◆ anonymous enum

anonymous enum
inherited
Enumerator
kIsOnHeap 

object is on heap

kNotDeleted 

object has not been deleted

kZombie 

object ctor failed

kInconsistent 

class overload Hash but does call RecursiveRemove in destructor

kBitMask 

Definition at line 89 of file TObject.h.

◆ EDeprecatedStatusBits

Enumerator
kObjInCanvas 

for backward compatibility only, use kMustCleanup

Definition at line 84 of file TObject.h.

◆ EStatusBits

enum TObject::EStatusBits
inherited
Enumerator
kCanDelete 

if object in a list can be deleted

kMustCleanup 

if object destructor must call RecursiveRemove()

kIsReferenced 

if object is referenced by a TRef or TRefArray

kHasUUID 

if object has a TUUID (its fUniqueID=UUIDNumber)

kCannotPick 

if object in a pad cannot be picked

kNoContextMenu 

if object does not want context menu

kInvalidObject 

if object ctor succeeded but object should not be used

Definition at line 70 of file TObject.h.

Constructor & Destructor Documentation

◆ TSQLiteStatement()

TSQLiteStatement::TSQLiteStatement ( SQLite3_Stmt_t * stmt,
Bool_t errout = kTRUE )

Normal constructor.

Checks if statement contains parameters tags.

Definition at line 35 of file TSQLiteStatement.cxx.

◆ ~TSQLiteStatement()

TSQLiteStatement::~TSQLiteStatement ( )
virtual

Destructor.

Definition at line 56 of file TSQLiteStatement.cxx.

Member Function Documentation

◆ AbstractMethod()

void TObject::AbstractMethod ( const char * method) const
inherited

Call this function within a function that you don't want to define as purely virtual, in order not to force all users deriving from that class to implement that maybe (on their side) unused function; but at the same time, emit a run-time warning if they try to call it, telling that it is not implemented in the derived class: action must thus be taken on the user side to override it.

In other word, this method acts as a "runtime purely virtual" warning instead of a "compiler purely virtual" error.

Warning
This interface is a legacy function that is no longer recommended to be used by new development code.
Note
The name "AbstractMethod" does not imply that it's an abstract method in the strict C++ sense.

Definition at line 1149 of file TObject.cxx.

◆ AddToTObjectTable()

void TObject::AddToTObjectTable ( TObject * op)
staticprivateinherited

Private helper function which will dispatch to TObjectTable::AddObj.

Included here to avoid circular dependency between header files.

Definition at line 195 of file TObject.cxx.

◆ AppendPad()

void TObject::AppendPad ( Option_t * option = "")
virtualinherited

Append graphics object to current pad.

In case no current pad is set yet, create a default canvas with the name "c1".

Definition at line 204 of file TObject.cxx.

◆ Browse()

◆ CheckBindError()

Bool_t TSQLiteStatement::CheckBindError ( const char * method,
int res )
private

Definition at line 111 of file TSQLiteStatement.cxx.

◆ CheckedHash()

ULong_t TObject::CheckedHash ( )
inlineinherited

Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.

The intent is for this routine to be called instead of directly calling the function Hash during "insert" operations. See TObject::HasInconsistenTObjectHash();

(*) The setup is consistent when all classes in the class hierarchy that overload TObject::Hash do call ROOT::CallRecursiveRemoveIfNeeded in their destructor. i.e. it is safe to call the Hash virtual function during the RecursiveRemove operation.

Definition at line 332 of file TObject.h.

◆ Class()

TClass * TSQLStatement::Class ( )
staticinherited
Returns
TClass describing this class

◆ Class_Name()

const char * TSQLStatement::Class_Name ( )
staticinherited
Returns
Name of this class

◆ Class_Version()

constexpr Version_t TSQLStatement::Class_Version ( )
inlinestaticconstexprinherited
Returns
Version of this class

Definition at line 121 of file TSQLStatement.h.

◆ ClassDefOverride()

TSQLiteStatement::ClassDefOverride ( TSQLiteStatement ,
0  )

◆ ClassName()

const char * TObject::ClassName ( ) const
virtualinherited

Returns name of class to which the object belongs.

Definition at line 227 of file TObject.cxx.

◆ Clear()

◆ ClearError()

void TSQLStatement::ClearError ( )
protectedinherited

reset error fields

Definition at line 255 of file TSQLStatement.cxx.

◆ Clone()

TObject * TObject::Clone ( const char * newname = "") const
virtualinherited

Make a clone of an object using the Streamer facility.

If the object derives from TNamed, this function is called by TNamed::Clone. TNamed::Clone uses the optional argument to set a new name to the newly created object.

If the object class has a DirectoryAutoAdd function, it will be called at the end of the function with the parameter gDirectory. This usually means that the object will be appended to the current ROOT directory.

Reimplemented in RooAbsArg, RooAbsBinning, RooAbsCollection, RooAbsStudy, RooCatType, RooCmdArg, RooDataHist, RooDataSet, RooFitResult, RooLinkedList, RooStats::HypoTestResult, RooStats::ModelConfig, RooStudyPackage, RooTemplateProxy< T >, RooTemplateProxy< const RooHistFunc >, RooTemplateProxy< RooAbsCategory >, RooTemplateProxy< RooAbsPdf >, RooTemplateProxy< RooAbsReal >, RooTemplateProxy< RooAbsRealLValue >, RooTemplateProxy< RooMultiCategory >, RooTemplateProxy< RooRealVar >, RooWorkspace, TASImage, TChainIndex, TClass, TCollection, TF1, TFunction, TFunctionTemplate, TH1, TImage, TMethod, TMethodCall, TMinuit, TMVA::MinuitWrapper, TNamed, TStreamerInfo, and TTreeIndex.

Definition at line 243 of file TObject.cxx.

◆ Close()

void TSQLiteStatement::Close ( Option_t * = "")
finalvirtual

Close statement.

Reimplemented from TSQLStatement.

Definition at line 64 of file TSQLiteStatement.cxx.

◆ Compare()

Int_t TObject::Compare ( const TObject * obj) const
virtualinherited

Compare abstract method.

Must be overridden if a class wants to be able to compare itself with other objects. Must return -1 if this is smaller than obj, 0 if objects are equal and 1 if this is larger than obj.

Reimplemented in RooAbsArg, RooDouble, TCollection, TEnvRec, TFileInfo, TGeoBranchArray, TGeoOverlap, TGFSFrameElement, TGLBFrameElement, TNamed, TObjString, TParameter< AParamType >, TParameter< Long64_t >, TStructNode, TStructNodeProperty, and TUrl.

Definition at line 258 of file TObject.cxx.

◆ ConvertToNumeric()

long double TSQLiteStatement::ConvertToNumeric ( Int_t npar)
private

Convert field to numeric.

Definition at line 281 of file TSQLiteStatement.cxx.

◆ ConvertToString()

const char * TSQLiteStatement::ConvertToString ( Int_t npar)
private

Convert field value to string.

Definition at line 271 of file TSQLiteStatement.cxx.

◆ Copy()

◆ DeclFileName()

const char * TSQLStatement::DeclFileName ( )
inlinestaticinherited
Returns
Name of the file containing the class declaration

Definition at line 121 of file TSQLStatement.h.

◆ Delete()

void TObject::Delete ( Option_t * option = "")
virtualinherited

◆ DistancetoPrimitive()

◆ DoError()

void TObject::DoError ( int level,
const char * location,
const char * fmt,
va_list va ) const
protectedvirtualinherited

Interface to ErrorHandler (protected).

Reimplemented in TThread, and TTreeViewer.

Definition at line 1059 of file TObject.cxx.

◆ Draw()

◆ DrawClass()

void TObject::DrawClass ( ) const
virtualinherited

Draw class inheritance tree of the class to which this object belongs.

If a class B inherits from a class A, description of B is drawn on the right side of description of A. Member functions overridden by B are shown in class A with a blue line crossing-out the corresponding member function. The following picture is the class inheritance tree of class TPaveLabel:

Reimplemented in TGFrame, TSystemDirectory, and TSystemFile.

Definition at line 308 of file TObject.cxx.

◆ DrawClone()

TObject * TObject::DrawClone ( Option_t * option = "") const
virtualinherited

Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).

If pad was not selected - gPad will be used.

Note
For histograms, use the more specialised TH1::DrawCopy().

Reimplemented in TAxis, TCanvas, TGFrame, TSystemDirectory, and TSystemFile.

Definition at line 319 of file TObject.cxx.

◆ Dump()

void TObject::Dump ( ) const
virtualinherited

Dump contents of object on stdout.

Using the information in the object dictionary (class TClass) each data member is interpreted. If a data member is a pointer, the pointer value is printed

The following output is the Dump of a TArrow object:

fAngle 0 Arrow opening angle (degrees)
fArrowSize 0.2 Arrow Size
fOption.*fData
fX1 0.1 X of 1st point
fY1 0.15 Y of 1st point
fX2 0.67 X of 2nd point
fY2 0.83 Y of 2nd point
fUniqueID 0 object unique identifier
fBits 50331648 bit field status word
fLineColor 1 line color
fLineStyle 1 line style
fLineWidth 1 line width
fFillColor 19 fill area color
fFillStyle 1001 fill area style
#define X(type, name)
UInt_t fUniqueID
object unique identifier
Definition TObject.h:46
UInt_t fBits
bit field status word
Definition TObject.h:47
TLine * line
TCanvas * style()
Definition style.C:1

Reimplemented in TClass, TCollection, TGFrame, TGPack, and TSystemFile.

Definition at line 367 of file TObject.cxx.

◆ EnableErrorOutput()

virtual void TSQLStatement::EnableErrorOutput ( Bool_t on = kTRUE)
inlinevirtualinherited

Definition at line 119 of file TSQLStatement.h.

◆ Error()

void TObject::Error ( const char * location,
const char * fmt,
... ) const
virtualinherited

Issue error message.

Use "location" to specify the method where the error occurred. Accepts standard printf formatting arguments.

Reimplemented in TFitResult.

Definition at line 1098 of file TObject.cxx.

◆ Execute() [1/2]

void TObject::Execute ( const char * method,
const char * params,
Int_t * error = nullptr )
virtualinherited

Execute method on this object with the given parameter string, e.g.

"3.14,1,\"text\"".

Reimplemented in ROOT::R::TRInterface, TCling, TContextMenu, TInterpreter, and TMethodCall.

Definition at line 378 of file TObject.cxx.

◆ Execute() [2/2]

void TObject::Execute ( TMethod * method,
TObjArray * params,
Int_t * error = nullptr )
virtualinherited

Execute method on this object with parameters stored in the TObjArray.

The TObjArray should contain an argv vector like:

argv[0] ... argv[n] = the list of TObjString parameters
Collectable string class.
Definition TObjString.h:28
const Int_t n
Definition legend1.C:16

Reimplemented in ROOT::R::TRInterface, TCling, TContextMenu, TInterpreter, and TMethodCall.

Definition at line 398 of file TObject.cxx.

◆ ExecuteEvent()

◆ Fatal()

void TObject::Fatal ( const char * location,
const char * fmt,
... ) const
virtualinherited

Issue fatal error message.

Use "location" to specify the method where the fatal error occurred. Accepts standard printf formatting arguments.

Definition at line 1126 of file TObject.cxx.

◆ FindObject() [1/2]

TObject * TObject::FindObject ( const char * name) const
virtualinherited

Must be redefined in derived classes.

This function is typically used with TCollections, but can also be used to find an object by name inside this object.

Reimplemented in RooAbsCollection, RooLinkedList, TBtree, TCollection, TDirectory, TFolder, TGeometry, TGraph2D, TGraph, TH1, THashList, THashTable, THbookFile, TList, TListOfDataMembers, TListOfEnums, TListOfEnumsWithLock, TListOfFunctions, TListOfFunctionTemplates, TListOfTypes, TMap, TObjArray, TPad, TROOT, TViewPubDataMembers, and TViewPubFunctions.

Definition at line 425 of file TObject.cxx.

◆ FindObject() [2/2]

TObject * TObject::FindObject ( const TObject * obj) const
virtualinherited

Must be redefined in derived classes.

This function is typically used with TCollections, but can also be used to find an object inside this object.

Reimplemented in RooAbsCollection, RooLinkedList, TBtree, TCollection, TDirectory, TFolder, TGeometry, TGraph2D, TGraph, TH1, THashList, THashTable, THbookFile, TList, TListOfDataMembers, TListOfEnums, TListOfEnumsWithLock, TListOfFunctions, TListOfFunctionTemplates, TListOfTypes, TMap, TObjArray, TPad, TROOT, TViewPubDataMembers, and TViewPubFunctions.

Definition at line 435 of file TObject.cxx.

◆ GetBinary()

Bool_t TSQLiteStatement::GetBinary ( Int_t npar,
void *& mem,
Long_t & size )
finalvirtual

Return field value as binary array.

Memory at 'mem' will be reallocated and size updated to fit the data if not large enough.

Reimplemented from TSQLStatement.

Definition at line 373 of file TSQLiteStatement.cxx.

◆ GetBufferLength()

Int_t TSQLiteStatement::GetBufferLength ( ) const
inlinefinalvirtual

Implements TSQLStatement.

Definition at line 49 of file TSQLiteStatement.h.

◆ GetDate()

Bool_t TSQLiteStatement::GetDate ( Int_t npar,
Int_t & year,
Int_t & month,
Int_t & day )
finalvirtual

Return field value as date.

Reimplemented from TSQLStatement.

Definition at line 395 of file TSQLiteStatement.cxx.

◆ GetDatime() [1/2]

Bool_t TSQLiteStatement::GetDatime ( Int_t npar,
Int_t & year,
Int_t & month,
Int_t & day,
Int_t & hour,
Int_t & min,
Int_t & sec )
finalvirtual

Return field value as date & time.

Reimplemented from TSQLStatement.

Definition at line 427 of file TSQLiteStatement.cxx.

◆ GetDatime() [2/2]

TDatime TSQLStatement::GetDatime ( Int_t npar)
inherited

return value of parameter in form of TDatime Be aware, that TDatime does not allow dates before 1995-01-01

Definition at line 311 of file TSQLStatement.cxx.

◆ GetDay()

Int_t TSQLStatement::GetDay ( Int_t npar)
inherited

return day value for parameter (if applicable)

Definition at line 351 of file TSQLStatement.cxx.

◆ GetDouble()

Double_t TSQLiteStatement::GetDouble ( Int_t npar)
finalvirtual

Return field value as double.

Reimplemented from TSQLStatement.

Definition at line 351 of file TSQLiteStatement.cxx.

◆ GetDrawOption()

Option_t * TObject::GetDrawOption ( ) const
virtualinherited

Get option used by the graphics system to draw this object.

Note that before calling object.GetDrawOption(), you must have called object.Draw(..) before in the current pad.

Reimplemented in TBrowser, TFitEditor, TGedFrame, TGFileBrowser, TRootBrowser, and TRootBrowserLite.

Definition at line 445 of file TObject.cxx.

◆ GetDtorOnly()

Longptr_t TObject::GetDtorOnly ( )
staticinherited

Return destructor only flag.

Definition at line 1196 of file TObject.cxx.

◆ GetErrorCode()

Int_t TSQLStatement::GetErrorCode ( ) const
virtualinherited

Abstract base class defining SQL statements, which can be submitted in bulk to DB server.

This is alternative to TSQLServer::Query() method, which allows only pure text queries and pure text result in TSQLResult classes. TSQLStatement is designed to support following features:

  • usage of basic data types (like int or double) as parameters in SQL statements
  • bulk operation when inserting/updating/selecting data in database
  • uasge of basic data types when accessing result set of executed query

1. Creation of statement

To create an instance of the TSQLStatement class, the TSQLServer::Statement() method should be used. Depending on the driver used for an ODBC connection, the appropriate object instance will be created. For the moment there are six different implementations of the TSQLStatement class: for MySQL, Oracle, PostgreSQL, SQLite3 and ODBC. Hopefully, support of ODBC will allow usage of statements for most existing RDBMS.

// first, connect to the database TSQLServer* serv = TSQLServer::Connect("mysql://hostname.domain:3306/test", "user", "pass"); // check if connection is ok if ((serv!=0) && serv->IsConnected()) { // create instance of sql-statement TSQLStatement* stmt = serv->Statement("CREATE TABLE TESTTABLE (ID1 INT, ID2 INT, FFIELD VARCHAR(255), FVALUE VARCHAR(255))"; // process statement stmt->Process(); // destroy object delete stmt; } delete serv;

2. Insert data to data base

There is a special syntax of SQL queries which allows to use values provided as parameters. For instance, to insert one row into the TESTTABLE created with the previous example, one can simply execute a query like:

serv->Query("INSERT INTO TESTTABLE VALUES (1, 2, \"name1\", \"value1\"");

However, when many (100-1000) rows should be inserted, each call of TSQLServer::Query() method will cause communication loop with database server, and the statement has to be evaluated each time instead of using a prepared statement. As a result, insertion of data takes too much time.

TSQLStatement provides a mechanism to insert many rows at once. First of all, an appropriate statement should be created:

TSQLStatement* stmt = serv->Statement("INSERT INTO TESTTABLE (ID1, ID2, FFIELD, FVALUE) VALUES (?, ?, ?, ?)", 100);

Here question marks "?" indicate where statement parameters can be inserted. To specify values of parameters, SetInt(), SetDouble(), SetString() and other methods of the TSQLStatement class should be used. Before parameters values can be specified, the NextIteration() method of statement class should be called. For each new row, NextIteration() has to be called first, then parameters values are specified. There is one limitation for most type-aware DBMS - once a parameter is set as integer via SetInt(), all other rows should be specified as integer. At the end, TSQLStatement::Process() should be called. Here a small example:

// first, create statement TSQLStatement* stmt = serv->Statement("INSERT INTO TESTTABLE (ID1, ID2, FFIELD, FVALUE) VALUES (?, ?, ?, ?)", 100);

for (int n=0;n<357;n++) if (stmt->NextIteration()) { stmt->SetInt(0, 123); stmt->SetUInt(1, n+10); stmt->SetString(2, Form("name %d",n), 200); stmt->SetString(3, Form("value %d", n+10), 200); }

stmt->Process(); delete stmt;

The second argument in the TSQLServer::Statement() method specifies the depth of of buffers which are used to keep parameter values (100 in the example). It is not a limitation of the number of rows which can be inserted with the statement. When buffers are filled, they will be submitted to database and can be reused again. This happens transparent to the user in the NextIteration() method.

Oracle and some ODBC drivers support buffering of parameter values and, as a result, bulk insert (update) operation. MySQL (native driver and MyODBC 3) does not support such a mode of operation, therefore adding new rows will result in communication loop to database.

Local databases (SQLite3) do not use any buffering at all in the TSQLStatement implementation (but inside the library). They still profit from the usage of prepared statements. When inserting many rows into a SQLite3 database, consider using a transaction via the methods StartTransaction() and Commit() of the TSQLServer, as autocommit is active by default and causes a sync to disk after each single insert.

One should also mention differences between Oracle and ODBC SQL syntax for parameters. ODBC (and MySQL) use question marks to specify the position where parameters should be inserted (as shown in the example). Oracle uses :1, :2 and so on as marks to specify the position of parameter 0, 1, and so on. Therefore, similar to the example, a query will look like:

TSQLStatement* stmt = serv->Statement("INSERT INTO TESTTABLE (ID1, ID2, FFIELD, FVALUE) VALUES (:1, :2, :3, :4)", 100);

SQLite3 supports both these syntaxes and some more.

There is a possibility to set a parameter value to NULL with the SetNull() method. If this method is to be called for the first iteration, one should first call another Set... method to identify the actual type which will be used for the parameter later.

3. Getting data from database

To request data from a database, the SELECT statement should be used. After a SELECT statement is created, it must be processed with the TSQLStatement::Process() method and the result of statement should be stored in internal buffers with the method TSQLStatement::StoreResult(). Information about selected fields (columns) can be obtained with GetNumFields() and GetFieldName() methods. To receive data for the next result row, NextResultRow() method should be called. Value from each column can be retrieved with the GetInt(), GetDouble(), GetString() and other methods.

There are no strict limitations on which method should be used to get column values. GetString() can be used as a generic method, which should always return correct result, but also conversions between most basic data types are supported. For instance, if a column contains integer values, GetInt(), GetLong64(), GetDouble() and GetString() methods can be used. If column has floating point format, GetDouble() and GetString() methods can be used without loss of precision while GetInt() or GetLong64() will return only the integer part of the value. One also can test whether a value is NULL with the IsNull() method.

The buffer length specified for a statement in the TSQLServer::Statement() call will also be used to allocate buffers for column values. Usage of these buffers is transparent for users and does not limit the number of rows which can be accessed with one statement. Again, local databases do not work with buffers inside TSQLStatement at all and ignore this value. Example of select query:

stmt = serv->Statement("SELECT * FROM TESTTABLE", 100); // process statement if (stmt->Process()) { // store result of statement in buffer stmt->StoreResult();

// display info about selected field std::cout << "NumFields = " << stmt->GetNumFields() << std::endl; for (int n=0;n<stmt->GetNumFields();n++) std::cout << "Field " << n << " = " << stmt->GetFieldName(n) << std::endl;

// extract rows one after another while (stmt->NextResultRow()) { Double_t id1 = stmt->GetDouble(0); UInt_t id2 = stmt->GetUInt(1); const char* name1 = stmt->GetString(2); const char* name2 = stmt->GetString(3); std::cout << id1 << " - " << id2 << " " << name1 << " " << name2 << std::endl; } }

4. Working with date/time parameters

The current implementation supports date, time, date&time and timestamp data (all time intervals are not supported yet). To set or get date/time values, the following methods should be used: SetTime()/GetTime() - only time (hour:min:sec), SetDate()/GetDate() - only date (year-month-day), SetDatime()/GetDatime() - date and time SetTimestamp()/GetTimestamp() - timestamp with seconds fraction For some of these methods TDatime type can be used as parameter / return value. Be aware that TDatime supports only dates after 1995-01-01. There are also methods to get year, month, day, hour, minutes and seconds separately.

Note that different SQL databases treat date/time types differently. For instance, MySQL has all correspondent types (TIME, DATE, DATETIME and TIMESTAMP), Oracle native driver supports only DATE (which is actually date and time) and TIMESTAMP ODBC interface provides access for time, date and timestamps, for PostgreSQL, TIMESTAMP is available and can be retrieved via all methods, the implementation for SQLite interprets the column content as a timestamp with second fraction. Due to these differences, one should use correct methods to access such data. For instance, in MySQL SQL type 'DATE' is only date (one should use GetDate() to access such data), while in Oracle it is date and time. Therefore, to get complete data from a 'DATE' column in Oracle, one should use the GetDatime() method.

The only difference between timestamp and date/time is that timestamp has a fractional seconds part. Be aware that the fractional part has different meanings (actual value) in different SQL plugins. For PostgreSQL, it is given back as microseconds, while for SQLite3, milliseconds correspond to the fraction (similar to the DATETIME-functions implemented in the SQLite3 language).

5. Binary data

Most modern data bases support just binary data, which is typically has SQL type name 'BLOB'. To access data in such columns, GetBinary()/SetBinary() methods should be used. The current implementation implies that the complete content of the column must be retrieved at once. Therefore, very big data of gigabytes size may cause a problem.

In addition, for PostgresSQL, the methods GetLargeObject()/SetLargeObject() are implemented with similar syntax. They retrieve a large object for the OID given in the column of the statement. For non-PostgreSQL databases, calling GetLargeObject()/SetLargeObject() is redirected to GetBinary()/SetBinary().

Since ROOT 6.36, the GetLargeObject/GetBinary(Int_t col, void* &mem, Long_t& size) API is defined strictly to return new memory mem that must be released with delete [] (unsigned char *) mem by the caller. Older uses of this API (such as those of oracle, mysql, odbc) that relied on internal buffer management (owning pointers) were removed in ROOT 6.38. returns error code of last operation if res==0, no error Each specific implementation of TSQLStatement provides its own error coding

Definition at line 237 of file TSQLStatement.cxx.

◆ GetErrorMsg()

const char * TSQLStatement::GetErrorMsg ( ) const
virtualinherited

returns error message of last operation if no errors, return 0 Each specific implementation of TSQLStatement provides its own error messages

Definition at line 247 of file TSQLStatement.cxx.

◆ GetFieldName()

const char * TSQLiteStatement::GetFieldName ( Int_t nfield)
finalvirtual

Returns field name in result set.

Implements TSQLStatement.

Definition at line 212 of file TSQLiteStatement.cxx.

◆ GetHour()

Int_t TSQLStatement::GetHour ( Int_t npar)
inherited

return hours value for parameter (if applicable)

Definition at line 362 of file TSQLStatement.cxx.

◆ GetIconName()

const char * TObject::GetIconName ( ) const
virtualinherited

Returns mime type name of object.

Used by the TBrowser (via TGMimeTypes class). Override for class of which you would like to have different icons for objects of the same class.

Reimplemented in ROOT::Experimental::XRooFit::xRooNode, TASImage, TBranch, TBranchElement, TGeoVolume, TGMainFrame, TKey, TMethodBrowsable, TSystemFile, and TVirtualBranchBrowsable.

Definition at line 472 of file TObject.cxx.

◆ GetInt()

Int_t TSQLiteStatement::GetInt ( Int_t npar)
finalvirtual

Get integer.

Reimplemented from TSQLStatement.

Definition at line 301 of file TSQLiteStatement.cxx.

◆ GetLargeObject()

virtual Bool_t TSQLStatement::GetLargeObject ( Int_t col,
void *& mem,
Long_t & size )
inlinevirtualinherited
Note
Since ROOT 6.36, this API is defined to return new memory that must be released with delete [] (unsigned char *) mem by the caller. Older uses of this API (such as those of oracle, mysql, odbc) that relied on internal buffer management (owning pointers) were removed in ROOT 6.38.

Definition at line 93 of file TSQLStatement.h.

◆ GetLong()

Long_t TSQLiteStatement::GetLong ( Int_t npar)
finalvirtual

Get long.

Reimplemented from TSQLStatement.

Definition at line 321 of file TSQLiteStatement.cxx.

◆ GetLong64()

Long64_t TSQLiteStatement::GetLong64 ( Int_t npar)
finalvirtual

Get long64.

Reimplemented from TSQLStatement.

Definition at line 331 of file TSQLiteStatement.cxx.

◆ GetMinute()

Int_t TSQLStatement::GetMinute ( Int_t npar)
inherited

return minutes value for parameter (if applicable)

Definition at line 373 of file TSQLStatement.cxx.

◆ GetMonth()

Int_t TSQLStatement::GetMonth ( Int_t npar)
inherited

return month value for parameter (if applicable)

Definition at line 340 of file TSQLStatement.cxx.

◆ GetName()

◆ GetNumAffectedRows()

Int_t TSQLiteStatement::GetNumAffectedRows ( )
finalvirtual

Return number of affected rows after statement is processed.

Indirect changes e.g. by triggers are not counted, only direct changes from last completed statement are taken into account.

Reimplemented from TSQLStatement.

Definition at line 166 of file TSQLiteStatement.cxx.

◆ GetNumFields()

Int_t TSQLiteStatement::GetNumFields ( )
finalvirtual

Return number of fields in result set.

Implements TSQLStatement.

Definition at line 204 of file TSQLiteStatement.cxx.

◆ GetNumParameters()

Int_t TSQLiteStatement::GetNumParameters ( )
finalvirtual

Return number of statement parameters.

Implements TSQLStatement.

Definition at line 176 of file TSQLiteStatement.cxx.

◆ GetObjectInfo()

char * TObject::GetObjectInfo ( Int_t px,
Int_t py ) const
virtualinherited

Returns string containing info about the object at position (px,py).

This method is typically overridden by classes of which the objects can report peculiarities for different positions. Returned string will be re-used (lock in MT environment).

Reimplemented in TASImage, TAxis3D, TColorWheel, TF1, TF2, TFileDrawMap, TGeoNode, TGeoTrack, TGeoVolume, TGL5DDataSet, TGLHistPainter, TGLParametricEquation, TGLTH3Composition, TGraph, TH1, THistPainter, TNode, TPaletteAxis, TParallelCoordVar, and TVirtualHistPainter.

Definition at line 491 of file TObject.cxx.

◆ GetObjectStat()

Bool_t TObject::GetObjectStat ( )
staticinherited

Get status of object stat flag.

Definition at line 1181 of file TObject.cxx.

◆ GetOption()

virtual Option_t * TObject::GetOption ( ) const
inlinevirtualinherited

◆ GetSecond()

Int_t TSQLStatement::GetSecond ( Int_t npar)
inherited

return seconds value for parameter (if applicable)

Definition at line 384 of file TSQLStatement.cxx.

◆ GetSecondsFraction()

Int_t TSQLStatement::GetSecondsFraction ( Int_t npar)
inherited

return seconds fraction value for parameter (if applicable)

Definition at line 395 of file TSQLStatement.cxx.

◆ GetString()

const char * TSQLiteStatement::GetString ( Int_t npar)
finalvirtual

Return field value as string.

Reimplemented from TSQLStatement.

Definition at line 361 of file TSQLiteStatement.cxx.

◆ GetTime()

Bool_t TSQLiteStatement::GetTime ( Int_t npar,
Int_t & hour,
Int_t & min,
Int_t & sec )
finalvirtual

Return field as time.

Reimplemented from TSQLStatement.

Definition at line 411 of file TSQLiteStatement.cxx.

◆ GetTimestamp() [1/3]

Bool_t TSQLiteStatement::GetTimestamp ( Int_t npar,
Int_t & year,
Int_t & month,
Int_t & day,
Int_t & hour,
Int_t & min,
Int_t & sec,
Int_t & frac )
finalvirtual

Return field as timestamp.

Second fraction is in milliseconds, which is also the precision all date and time functions of sqlite use.

Reimplemented from TSQLStatement.

Definition at line 447 of file TSQLiteStatement.cxx.

◆ GetTimestamp() [2/3]

return value of parameter in form of TDatime Be aware, that TDatime does not allow dates before 1995-01-01

Definition at line 108 of file TSQLStatement.cxx.

◆ GetTimestamp() [3/3]

Get parameter as TTimeStamp.

Reimplemented from TSQLStatement.

Definition at line 107 of file TSQLStatement.cxx.

◆ GetTitle()

const char * TObject::GetTitle ( ) const
virtualinherited

Returns title of object.

This default method returns the class title (i.e. description). Classes that give objects a title should override this method.

Reimplemented in Axis2, TASImage, TAxis, TBaseClass, TClassMenuItem, TEveGeoNode, TEvePointSet, TGaxis, TGGroupFrame, TGLabel, TGLVEntry, TGTextButton, TGTextEntry, TGTextLBEntry, TKey, TMapFile, TNamed, TPad, TPair, TParallelCoordSelect, TParticle, TPaveLabel, TPrimary, TQCommand, TRootIconList, and TVirtualPad.

Definition at line 507 of file TObject.cxx.

◆ GetUInt()

UInt_t TSQLiteStatement::GetUInt ( Int_t npar)
finalvirtual

Get unsigned integer.

Reimplemented from TSQLStatement.

Definition at line 311 of file TSQLiteStatement.cxx.

◆ GetULong64()

ULong64_t TSQLiteStatement::GetULong64 ( Int_t npar)
finalvirtual

Return field value as unsigned 64-bit integer.

Reimplemented from TSQLStatement.

Definition at line 341 of file TSQLiteStatement.cxx.

◆ GetUniqueID()

UInt_t TObject::GetUniqueID ( ) const
virtualinherited

Return the unique object id.

Definition at line 480 of file TObject.cxx.

◆ GetVDouble()

virtual Bool_t TSQLStatement::GetVDouble ( Int_t ,
std::vector< Double_t > &  )
inlinevirtualinherited

Definition at line 114 of file TSQLStatement.h.

◆ GetVInt()

virtual Bool_t TSQLStatement::GetVInt ( Int_t ,
std::vector< Int_t > &  )
inlinevirtualinherited

Definition at line 109 of file TSQLStatement.h.

◆ GetVLong()

virtual Bool_t TSQLStatement::GetVLong ( Int_t ,
std::vector< Long_t > &  )
inlinevirtualinherited

Definition at line 111 of file TSQLStatement.h.

◆ GetVLong64()

virtual Bool_t TSQLStatement::GetVLong64 ( Int_t ,
std::vector< Long64_t > &  )
inlinevirtualinherited

Definition at line 112 of file TSQLStatement.h.

◆ GetVUInt()

virtual Bool_t TSQLStatement::GetVUInt ( Int_t ,
std::vector< UInt_t > &  )
inlinevirtualinherited

Definition at line 110 of file TSQLStatement.h.

◆ GetVULong64()

virtual Bool_t TSQLStatement::GetVULong64 ( Int_t ,
std::vector< ULong64_t > &  )
inlinevirtualinherited

Definition at line 113 of file TSQLStatement.h.

◆ GetYear()

Int_t TSQLStatement::GetYear ( Int_t npar)
inherited

return year value for parameter (if applicable)

Definition at line 329 of file TSQLStatement.cxx.

◆ HandleTimer()

Bool_t TObject::HandleTimer ( TTimer * timer)
virtualinherited

Execute action in response of a timer timing out.

This method must be overridden if an object has to react to timers.

Reimplemented in TGCommandPlugin, TGDNDManager, TGFileContainer, TGHtml, TGLEventHandler, TGPopupMenu, TGraphTime, TGScrollBar, TGShutter, TGTextEdit, TGTextEditor, TGTextEntry, TGTextView, TGToolTip, TGuiBldDragManager, TGWindow, and TTreeViewer.

Definition at line 516 of file TObject.cxx.

◆ Hash()

ULong_t TObject::Hash ( ) const
virtualinherited

Return hash value for this object.

Note: If this routine is overloaded in a derived class, this derived class should also add

void CallRecursiveRemoveIfNeeded(TObject &obj)
call RecursiveRemove for obj if gROOT is valid and obj.TestBit(kMustCleanup) is true.
Definition TROOT.h:406

Otherwise, when RecursiveRemove is called (by ~TObject or example) for this type of object, the transversal of THashList and THashTable containers will will have to be done without call Hash (and hence be linear rather than logarithmic complexity). You will also see warnings like

Error in <ROOT::Internal::TCheckHashRecursiveRemoveConsistency::CheckRecursiveRemove>: The class SomeName overrides
TObject::Hash but does not call TROOT::RecursiveRemove in its destructor.
virtual void Error(const char *method, const char *msgfmt,...) const
Issue error message.
Definition TObject.cxx:1098
TObject()
TObject constructor.
Definition TObject.h:259
virtual ULong_t Hash() const
Return hash value for this object.
Definition TObject.cxx:539
void RecursiveRemove(TObject *obj) override
Recursively remove this object from the list of Cleanups.
Definition TROOT.cxx:2651

Reimplemented in RooLinkedList, TASImagePlugin, TASPluginGS, TCollection, TEnvRec, TGObject, TGPicture, TIconBoxThumb, TImagePlugin, TNamed, TObjString, TPad, TPair, TParameter< AParamType >, TParameter< Long64_t >, TPave, and TStatistic.

Definition at line 539 of file TObject.cxx.

◆ HasInconsistentHash()

Bool_t TObject::HasInconsistentHash ( ) const
inlineinherited

Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.

missing call to RecursiveRemove in destructor).

Note: Since the consistency is only tested for during inserts, this routine will return true for object that have never been inserted whether or not they have a consistent setup. This has no negative side-effect as searching for the object with the right or wrong Hash will always yield a not-found answer (Since anyway no hash can be guaranteed unique, there is always a check)

Definition at line 366 of file TObject.h.

◆ Info()

void TObject::Info ( const char * location,
const char * fmt,
... ) const
virtualinherited

Issue info message.

Use "location" to specify the method where the warning occurred. Accepts standard printf formatting arguments.

Definition at line 1072 of file TObject.cxx.

◆ InheritsFrom() [1/2]

Bool_t TObject::InheritsFrom ( const char * classname) const
virtualinherited

Returns kTRUE if object inherits from class "classname".

Reimplemented in TClass.

Definition at line 549 of file TObject.cxx.

◆ InheritsFrom() [2/2]

Bool_t TObject::InheritsFrom ( const TClass * cl) const
virtualinherited

Returns kTRUE if object inherits from TClass cl.

Reimplemented in TClass.

Definition at line 557 of file TObject.cxx.

◆ Inspect()

void TObject::Inspect ( ) const
virtualinherited

Dump contents of this object in a graphics canvas.

Same action as Dump but in a graphical form. In addition pointers to other objects can be followed.

The following picture is the Inspect of a histogram object:

Reimplemented in ROOT::Experimental::XRooFit::xRooNode, TGFrame, TInspectorObject, and TSystemFile.

Definition at line 570 of file TObject.cxx.

◆ InvertBit()

void TObject::InvertBit ( UInt_t f)
inlineinherited

Definition at line 206 of file TObject.h.

◆ IsA()

TClass * TSQLStatement::IsA ( ) const
inlineoverridevirtualinherited
Returns
TClass describing current object

Reimplemented from TObject.

Definition at line 121 of file TSQLStatement.h.

◆ IsDestructed()

Bool_t TObject::IsDestructed ( ) const
inlineinherited

IsDestructed.

Note
This function must be non-virtual as it can be used on destructed (but not yet modified) memory. This is used for example in TClonesArray to record the element that have been destructed but not deleted and thus are ready for re-use (by operator new with placement).
Returns
true if this object's destructor has been run.

Definition at line 186 of file TObject.h.

◆ IsEqual()

Bool_t TObject::IsEqual ( const TObject * obj) const
virtualinherited

Default equal comparison (objects are equal if they have the same address in memory).

More complicated classes might want to override this function.

Reimplemented in TGObject, TObjString, TPair, and TQCommand.

Definition at line 589 of file TObject.cxx.

◆ IsError()

virtual Bool_t TSQLStatement::IsError ( ) const
inlinevirtualinherited

Definition at line 116 of file TSQLStatement.h.

◆ IsFolder()

◆ IsNull()

Bool_t TSQLiteStatement::IsNull ( Int_t npar)
finalvirtual

Checks if field value is null.

Reimplemented from TSQLStatement.

Definition at line 291 of file TSQLiteStatement.cxx.

◆ IsOnHeap()

Bool_t TObject::IsOnHeap ( ) const
inlineinherited

Definition at line 160 of file TObject.h.

◆ IsResultSetMode()

Bool_t TSQLiteStatement::IsResultSetMode ( ) const
inlineprivate

Definition at line 34 of file TSQLiteStatement.h.

◆ IsSetParsMode()

Bool_t TSQLiteStatement::IsSetParsMode ( ) const
inlineprivate

Definition at line 33 of file TSQLiteStatement.h.

◆ IsSortable()

virtual Bool_t TObject::IsSortable ( ) const
inlinevirtualinherited

◆ IsZombie()

Bool_t TObject::IsZombie ( ) const
inlineinherited

Definition at line 161 of file TObject.h.

◆ ls()

◆ MakeZombie()

void TObject::MakeZombie ( )
inlineprotectedinherited

Definition at line 55 of file TObject.h.

◆ MayNotUse()

void TObject::MayNotUse ( const char * method) const
inherited

Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).

Definition at line 1160 of file TObject.cxx.

◆ NextIteration()

Bool_t TSQLiteStatement::NextIteration ( )
finalvirtual

Increment iteration counter for statement, where parameter can be set.

Statement with parameters of previous iteration automatically will be applied to database. Actually a NO-OP for SQLite, as parameters stay bound when step-ping.

Implements TSQLStatement.

Definition at line 246 of file TSQLiteStatement.cxx.

◆ NextResultRow()

Bool_t TSQLiteStatement::NextResultRow ( )
finalvirtual

Shift cursor to next row in result set.

Implements TSQLStatement.

Definition at line 223 of file TSQLiteStatement.cxx.

◆ Notify()

Bool_t TObject::Notify ( )
virtualinherited

This method must be overridden to handle object notification (the base implementation is no-op).

Different objects in ROOT use the Notify method for different purposes, in coordination with other objects that call this method at the appropriate time.

For example, TLeaf uses it to load class information; TBranchRef to load contents of referenced branches TBranchRef; most notably, based on Notify, TChain implements a callback mechanism to inform interested parties when it switches to a new sub-tree.

Reimplemented in h1analysis, h1analysisTreeReader, TARInterruptHandler, TASInputHandler, TASInterruptHandler, TASLogHandler, TASSigPipeHandler, TBlinkTimer, TBranchElement, TBranchRef, TBreakLineCom, TBrowserTimer, TCollection, TDelCharCom, TDelTextCom, TFileHandler, TGContainerKeyboardTimer, TGContainerScrollTimer, TGInputHandler, TGLRedrawTimer, TGTextEditHist, TGuiBldDragManagerRepeatTimer, TIdleTimer, TInsCharCom, TInsTextCom, TInterruptHandler, TLeafObject, TMessageHandler, TNotifyLink< Type >, TNotifyLink< RNoCleanupNotifierHelper >, TNotifyLink< ROOT::Detail::TBranchProxy >, TNotifyLink< TTreeReader >, TPopupDelayTimer, TProcessEventTimer, TRefTable, TRepeatTimer, TSBRepeatTimer, TSelector, TSelectorDraw, TSelectorEntries, TSignalHandler, TSingleShotCleaner, TSocketHandler, TStdExceptionHandler, TSysEvtHandler, TTermInputHandler, TThreadTimer, TTimeOutTimer, TTimer, TTipDelayTimer, TTree, TTreeFormula, TTreeFormulaManager, TTreeReader, TViewTimer, and TViewUpdateTimer.

Definition at line 618 of file TObject.cxx.

◆ Obsolete()

void TObject::Obsolete ( const char * method,
const char * asOfVers,
const char * removedFromVers ) const
inherited

Use this method to declare a method obsolete.

Specify as of which version the method is obsolete and as from which version it will be removed.

Definition at line 1169 of file TObject.cxx.

◆ operator delete() [1/3]

void TObject::operator delete ( void * ptr,
size_t size )
inherited

Operator delete for sized deallocation.

Definition at line 1234 of file TObject.cxx.

◆ operator delete() [2/3]

void TObject::operator delete ( void * ptr)
inherited

Operator delete.

Definition at line 1212 of file TObject.cxx.

◆ operator delete() [3/3]

void TObject::operator delete ( void * ptr,
void * vp )
inherited

Only called by placement new when throwing an exception.

Definition at line 1266 of file TObject.cxx.

◆ operator delete[]() [1/3]

void TObject::operator delete[] ( void * ptr,
size_t size )
inherited

Operator delete [] for sized deallocation.

Definition at line 1245 of file TObject.cxx.

◆ operator delete[]() [2/3]

void TObject::operator delete[] ( void * ptr)
inherited

Operator delete [].

Definition at line 1223 of file TObject.cxx.

◆ operator delete[]() [3/3]

void TObject::operator delete[] ( void * ptr,
void * vp )
inherited

Only called by placement new[] when throwing an exception.

Definition at line 1274 of file TObject.cxx.

◆ operator new() [1/2]

void * TObject::operator new ( size_t sz)
inlineinherited

Definition at line 189 of file TObject.h.

◆ operator new() [2/2]

void * TObject::operator new ( size_t sz,
void * vp )
inlineinherited

Definition at line 191 of file TObject.h.

◆ operator new[]() [1/2]

void * TObject::operator new[] ( size_t sz)
inlineinherited

Definition at line 190 of file TObject.h.

◆ operator new[]() [2/2]

void * TObject::operator new[] ( size_t sz,
void * vp )
inlineinherited

Definition at line 192 of file TObject.h.

◆ Paint()

void TObject::Paint ( Option_t * option = "")
virtualinherited

This method must be overridden if a class wants to paint itself.

The difference between Paint() and Draw() is that when a object draws itself it is added to the display list of the pad in which it is drawn (and automatically redrawn whenever the pad is redrawn). While paint just draws the object without adding it to the pad display list.

Reimplemented in ROOT::Experimental::RTreeMapPainter, ROOT::RGeoPainter, TAnnotation, TArrow, TASImage, TASPaletteEditor::LimitLine, TASPaletteEditor::PaintPalette, TAxis3D, TBits, TBox, TButton, TCanvas, TClassTree, TCollection, TColorWheel, TCrown, TDiamond, TDirectory, TEfficiency, TEllipse, TEveArrow, TEveCaloViz, TEveDigitSet, TEveGeoShape, TEveGeoTopNode, TEvePlot3D, TEvePointSet, TEveProjectionAxes, TEveScene, TEveShape, TEveStraightLineSet, TEveText, TEveTriangleSet, TExec, TF1, TF2, TF3, TFile, TFileDrawMap, TFrame, TGaxis, TGenerator, TGeoBoolNode, TGeoIntersection, TGeoNode, TGeoOverlap, TGeoPainter, TGeoPhysicalNode, TGeoShape, TGeoSubtraction, TGeoTrack, TGeoUnion, TGeoVGShape, TGeoVolume, TGL5DDataSet, TGLHistPainter, TGLParametricEquation, TGLTH3Composition, TGraph2D, TGraph2DPainter, TGraph, TGraphEdge, TGraphNode, TGraphPolargram, TGraphTime, TH1, THistPainter, THStack, TLatex, TLegend, TLine, TMacro, TMarker3DBox, TMarker, TMathText, TMultiGraph, TNode, TNodeDiv, TPad, TPaletteAxis, TParallelCoord, TParallelCoordRange, TParallelCoordVar, TParticle, TPave, TPaveLabel, TPaveStats, TPavesText, TPaveText, TPie, TPolyLine3D, TPolyLine, TPolyMarker3D, TPolyMarker, TPrimary, TRatioPlot, TScatter2D, TScatter, TShape, TSpectrum2Painter, TSpider, TSpline, TSQLFile, TStyle, TText, TTreePerfStats, TVirtualGeoPainter, TVirtualGeoTrack, TVirtualHistPainter, TVirtualPad, TWbox, and TXMLFile.

Definition at line 631 of file TObject.cxx.

◆ Pop()

void TObject::Pop ( )
virtualinherited

Pop on object drawn in a pad to the top of the display list.

I.e. it will be drawn last and on top of all other primitives.

Reimplemented in TFrame, TPad, and TVirtualPad.

Definition at line 640 of file TObject.cxx.

◆ Print()

void TObject::Print ( Option_t * option = "") const
virtualinherited

This method must be overridden when a class wants to print itself.

Reimplemented in Roo1DTable, RooAbsArg, RooAbsBinning, RooAbsCollection, RooAbsData, RooAbsDataStore, RooAbsGenContext, RooCatType, RooCmdArg, RooCurve, RooEllipse, RooFitResult, RooGenFitStudy, RooHist, RooLinkedList, RooMsgService, RooNumGenConfig, RooNumIntConfig, RooPlot, RooSharedProperties, RooStats::ModelConfig, ROOT::Experimental::REveTrans, ROOT::Experimental::XRooFit::xRooNLLVar::xRooHypoPoint, ROOT::Experimental::XRooFit::xRooNLLVar::xRooHypoSpace, ROOT::Experimental::XRooFit::xRooNode, ROOT::v5::TFormula, RooWorkspace, TAnnotation, TApplicationRemote, TAttParticle, TBenchmark, TBits, TBox, TBranch, TBranchClones, TBranchElement, TBranchObject, TBranchRef, TBranchSTL, TChain, TClassTable, TCling, TCollection, TColor, TDatabasePDG, TDecompBase, TDecompBK, TDecompChol, TDecompLU, TDecompQRH, TDecompSparse, TDecompSVD, TDirectory, TEllipse, TEnv, TEventList, TEveTrans, TF1, TFile, TFileCacheRead, TFileCacheWrite, TFileCollection, TFileInfo, TFileInfoMeta, TFitResult, TFoamCell, TFoamVect, TFormula, TFunction, TGCompositeFrame, TGDMLMatrix, TGeoBatemanSol, TGeoBorderSurface, TGeoBranchArray, TGeoDecayChannel, TGeoElement, TGeoElementRN, TGeoElementTable, TGeoIsotope, TGeoMatrix, TGeoOpticalSurface, TGeoOverlap, TGeoPhysicalNode, TGeoRegion, TGeoSkinSurface, TGeoTessellated, TGeoTrack, TGeoVolume, TGeoVoxelFinder, TGFont, TGFontPool, TGFrame, TGFrameElement, TGGC, TGGCPool, TGLayoutHints, TGMimeTypes, TGPicture, TGPicturePool, TGraph2D, TGraph2DAsymmErrors, TGraph2DErrors, TGraph, TGraphAsymmErrors, TGraphBentErrors, TGraphErrors, TGraphMultiErrors, TGTextEdit, TGWindow, TH1, THashTable, THbookTree, THelix, THnBase, THStack, TInetAddress, TKey, TLegend, TLegendEntry, TLine, TLorentzVector, TMacro, TMapFile, TMarker, TMatrixTBase< Element >, TMatrixTBase< Double_t >, TMatrixTBase< Float_t >, TMemFile, TMessageHandler, TMultiDimFit, TMultiGraph, TMVA::Event, TMVA::Option< T >, TMVA::Option< T * >, TMVA::OptionBase, TMVA::PDEFoamCell, TMVA::PDEFoamVect, TMVA::TNeuron, TNamed, TObjectTable, TObjString, TPad, TParallelCoordRange, TParallelCoordVar, TParameter< AParamType >, TParameter< Long64_t >, TParticle, TParticleClassPDG, TParticlePDG, TPave, TPaveText, TPluginHandler, TPluginManager, TPolyLine3D, TPolyLine, TPolyMarker3D, TPolyMarker, TPrimary, TPrincipal, TQpDataDens, TQpDataSparse, TQpVar, TQSlot, TQuaternion, TRolke, TRootBrowserHistoryCursor, TScatter2D, TScatter, TSpectrum2, TSpectrum3, TSpectrum, TSQLColumnInfo, TSQLFile, TSQLStructure, TSQLTableInfo, TStatistic, TStopwatch, TStreamerInfoActions::TActionSequence, TText, TTree, TTreeCache, TTreeCacheUnzip, TTreeIndex, TTreePerfStats, TUri, TUrl, TVector2, TVector3, TVectorT< Element >, TVectorT< Double_t >, TVectorT< Float_t >, TVirtualPad, TXMLFile, TXTRU, TZIPFile, and TZIPMember.

Definition at line 661 of file TObject.cxx.

◆ Process()

Bool_t TSQLiteStatement::Process ( )
finalvirtual

Process statement.

Implements TSQLStatement.

Definition at line 127 of file TSQLiteStatement.cxx.

◆ Read()

Int_t TObject::Read ( const char * name)
virtualinherited

Read contents of object with specified name from the current directory.

First the key with the given name is searched in the current directory, next the key buffer is deserialized into the object. The object must have been created before via the default constructor. See TObject::Write().

Reimplemented in TBuffer, TKey, TKeySQL, and TKeyXML.

Definition at line 673 of file TObject.cxx.

◆ RecursiveRemove()

◆ ResetBit()

void TObject::ResetBit ( UInt_t f)
inlineinherited

Definition at line 203 of file TObject.h.

◆ SaveAs()

void TObject::SaveAs ( const char * filename = "",
Option_t * option = "" ) const
virtualinherited

Save this object in the file specified by filename.

  • if "filename" contains ".root" the object is saved in filename as root binary file.
  • if "filename" contains ".xml" the object is saved in filename as a xml ascii file.
  • if "filename" contains ".cc" the object is saved in filename as C code independent from ROOT. The code is generated via SavePrimitive(). Specific code should be implemented in each object to handle this option. Like in TF1::SavePrimitive().
  • otherwise the object is written to filename as a CINT/C++ script. The C++ code to rebuild this object is generated via SavePrimitive(). The "option" parameter is passed to SavePrimitive. By default it is an empty string. It can be used to specify the Draw option in the code generated by SavePrimitive.

    The function is available via the object context menu.

Reimplemented in ROOT::Experimental::XRooFit::xRooNode, TClassTree, TFolder, TGeoVolume, TGObject, TGraph, TH1, TPad, TPaveClass, TSpline3, TSpline5, TSpline, TTreePerfStats, and TVirtualPad.

Definition at line 708 of file TObject.cxx.

◆ SavePrimitive()

void TObject::SavePrimitive ( std::ostream & out,
Option_t * option = "" )
virtualinherited

Save a primitive as a C++ statement(s) on output stream "out".

Reimplemented in TAnnotation, TArc, TArrow, TASImage, TAxis3D, TBox, TButton, TCanvas, TChain, TCrown, TCurlyArc, TCurlyLine, TCutG, TDiamond, TEfficiency, TEllipse, TExec, TF12, TF1, TF2, TF3, TFrame, TGaxis, TGButton, TGButtonGroup, TGCanvas, TGCheckButton, TGColorSelect, TGColumnLayout, TGComboBox, TGCompositeFrame, TGContainer, TGDockableFrame, TGDoubleHSlider, TGDoubleVSlider, TGedMarkerSelect, TGedPatternSelect, TGeoArb8, TGeoBBox, TGeoBoolNode, TGeoCombiTrans, TGeoCompositeShape, TGeoCone, TGeoConeSeg, TGeoCtub, TGeoDecayChannel, TGeoElementRN, TGeoEltu, TGeoGtra, TGeoHalfSpace, TGeoHMatrix, TGeoHype, TGeoIdentity, TGeoIntersection, TGeoMaterial, TGeoMedium, TGeoMixture, TGeoPara, TGeoParaboloid, TGeoPatternCylPhi, TGeoPatternCylR, TGeoPatternParaX, TGeoPatternParaY, TGeoPatternParaZ, TGeoPatternSphPhi, TGeoPatternSphR, TGeoPatternSphTheta, TGeoPatternTrapZ, TGeoPatternX, TGeoPatternY, TGeoPatternZ, TGeoPcon, TGeoPgon, TGeoRotation, TGeoScaledShape, TGeoShapeAssembly, TGeoSphere, TGeoSubtraction, TGeoTessellated, TGeoTorus, TGeoTranslation, TGeoTrap, TGeoTrd1, TGeoTrd2, TGeoTube, TGeoTubeSeg, TGeoUnion, TGeoVolume, TGeoXtru, TGFileContainer, TGFont, TGFrame, TGFSComboBox, TGGC, TGGroupFrame, TGHButtonGroup, TGHorizontal3DLine, TGHorizontalFrame, TGHorizontalLayout, TGHProgressBar, TGHScrollBar, TGHSlider, TGHSplitter, TGHtml, TGIcon, TGLabel, TGLayoutHints, TGLineStyleComboBox, TGLineWidthComboBox, TGListBox, TGListDetailsLayout, TGListLayout, TGListTree, TGListView, TGLVContainer, TGMainFrame, TGMatrixLayout, TGMdiFrame, TGMdiMainFrame, TGMdiMenuBar, TGMenuBar, TGMenuTitle, TGNumberEntry, TGNumberEntryField, TGPictureButton, TGPopupMenu, TGProgressBar, TGRadioButton, TGraph2D, TGraph2DAsymmErrors, TGraph2DErrors, TGraph, TGraphAsymmErrors, TGraphBentErrors, TGraphEdge, TGraphErrors, TGraphMultiErrors, TGraphNode, TGraphPolar, TGraphPolargram, TGraphStruct, TGroupButton, TGRowLayout, TGShapedFrame, TGShutter, TGShutterItem, TGSplitFrame, TGStatusBar, TGTab, TGTabLayout, TGTableLayout, TGTableLayoutHints, TGTextButton, TGTextEdit, TGTextEntry, TGTextLBEntry, TGTextView, TGTileLayout, TGToolBar, TGTransientFrame, TGTripleHSlider, TGTripleVSlider, TGVButtonGroup, TGVertical3DLine, TGVerticalFrame, TGVerticalLayout, TGVFileSplitter, TGVProgressBar, TGVScrollBar, TGVSlider, TGVSplitter, TGXYLayout, TGXYLayoutHints, TH1, TH2Poly, THelix, THStack, TLatex, TLegend, TLine, TMacro, TMarker3DBox, TMarker, TMathText, TMultiGraph, TPad, TPaletteAxis, TParallelCoord, TParallelCoordVar, TPave, TPaveClass, TPaveLabel, TPaveStats, TPavesText, TPaveText, TPie, TPieSlice, TPolyLine3D, TPolyLine, TPolyMarker3D, TPolyMarker, TProfile2D, TProfile3D, TProfile, TRootContainer, TRootEmbeddedCanvas, TScatter2D, TScatter, TSlider, TSliderBox, TSpline3, TSpline5, TStyle, TText, TTreePerfStats, and TWbox.

Definition at line 858 of file TObject.cxx.

◆ SavePrimitiveConstructor()

void TObject::SavePrimitiveConstructor ( std::ostream & out,
TClass * cl,
const char * variable_name,
const char * constructor_agrs = "",
Bool_t empty_line = kTRUE )
staticprotectedinherited

Save object constructor in the output stream "out".

Can be used as first statement when implementing SavePrimitive() method for the object

Definition at line 777 of file TObject.cxx.

◆ SavePrimitiveDraw()

void TObject::SavePrimitiveDraw ( std::ostream & out,
const char * variable_name,
Option_t * option = nullptr )
staticprotectedinherited

Save invocation of primitive Draw() method Skipped if option contains "nodraw" string.

Definition at line 845 of file TObject.cxx.

◆ SavePrimitiveVector()

TString TObject::SavePrimitiveVector ( std::ostream & out,
const char * prefix,
Int_t len,
Double_t * arr,
Int_t flag = 0 )
staticprotectedinherited

Save array in the output stream "out" as vector.

Create unique variable name based on prefix value Returns name of vector which can be used in constructor or in other places of C++ code If flag === kTRUE, just add empty line If flag === 111, check if array is empty and return nullptr or <vectorname>.data()

Definition at line 796 of file TObject.cxx.

◆ SetBinary()

Bool_t TSQLiteStatement::SetBinary ( Int_t npar,
void * mem,
Long_t size,
Long_t maxsize = 0x1000 )
finalvirtual

Set parameter value as binary data.

Maxsize is ignored for SQLite, we directly insert BLOB of size 'size'. Negative size would cause undefined behaviour, so we refuse that.

Reimplemented from TSQLStatement.

Definition at line 557 of file TSQLiteStatement.cxx.

◆ SetBit() [1/2]

void TObject::SetBit ( UInt_t f)
inlineinherited

Definition at line 202 of file TObject.h.

◆ SetBit() [2/2]

void TObject::SetBit ( UInt_t f,
Bool_t set )
inherited

Set or unset the user status bits as specified in f.

Definition at line 888 of file TObject.cxx.

◆ SetDate() [1/2]

Bool_t TSQLiteStatement::SetDate ( Int_t npar,
Int_t year,
Int_t month,
Int_t day )
finalvirtual

Set parameter value as date.

Reimplemented from TSQLStatement.

Definition at line 572 of file TSQLiteStatement.cxx.

◆ SetDate() [2/2]

Bool_t TSQLStatement::SetDate ( Int_t npar,
const TDatime & tm )
inherited

set only date value for specified parameter from TDatime object

Definition at line 276 of file TSQLStatement.cxx.

◆ SetDatime() [1/2]

Bool_t TSQLiteStatement::SetDatime ( Int_t npar,
Int_t year,
Int_t month,
Int_t day,
Int_t hour,
Int_t min,
Int_t sec )
finalvirtual

Set parameter value as date & time.

Reimplemented from TSQLStatement.

Definition at line 595 of file TSQLiteStatement.cxx.

◆ SetDatime() [2/2]

Bool_t TSQLStatement::SetDatime ( Int_t npar,
const TDatime & tm )
inherited

set date & time value for specified parameter from TDatime object

Definition at line 292 of file TSQLStatement.cxx.

◆ SetDouble()

Bool_t TSQLiteStatement::SetDouble ( Int_t npar,
Double_t value )
finalvirtual

Set parameter value as double value.

Reimplemented from TSQLStatement.

Definition at line 535 of file TSQLiteStatement.cxx.

◆ SetDrawOption()

void TObject::SetDrawOption ( Option_t * option = "")
virtualinherited

Set drawing option for object.

This option only affects the drawing style and is stored in the option field of the TObjOptLink supporting a TPad's primitive list (TList). Note that it does not make sense to call object.SetDrawOption(option) before having called object.Draw().

Reimplemented in RooPlot, TAxis, TBrowser, TGedFrame, TGFrame, TPad, TPaveStats, TRootBrowserLite, TSystemDirectory, and TSystemFile.

Definition at line 871 of file TObject.cxx.

◆ SetDtorOnly()

void TObject::SetDtorOnly ( void * obj)
staticinherited

Set destructor only flag.

Definition at line 1204 of file TObject.cxx.

◆ SetError()

void TSQLStatement::SetError ( Int_t code,
const char * msg,
const char * method = nullptr )
protectedinherited

set new values for error fields if method specified, displays error message

Definition at line 265 of file TSQLStatement.cxx.

◆ SetInt()

Bool_t TSQLiteStatement::SetInt ( Int_t npar,
Int_t value )
finalvirtual

Set parameter value as integer.

Reimplemented from TSQLStatement.

Definition at line 483 of file TSQLiteStatement.cxx.

◆ SetLargeObject()

virtual Bool_t TSQLStatement::SetLargeObject ( Int_t col,
void * mem,
Long_t size,
Long_t maxsize = 0x1000 )
inlinevirtualinherited

Definition at line 62 of file TSQLStatement.h.

◆ SetLong()

Bool_t TSQLiteStatement::SetLong ( Int_t npar,
Long_t value )
finalvirtual

Set parameter value as long.

Reimplemented from TSQLStatement.

Definition at line 504 of file TSQLiteStatement.cxx.

◆ SetLong64()

Bool_t TSQLiteStatement::SetLong64 ( Int_t npar,
Long64_t value )
finalvirtual

Set parameter value as 64-bit integer.

Reimplemented from TSQLStatement.

Definition at line 514 of file TSQLiteStatement.cxx.

◆ SetMaxFieldSize()

virtual Bool_t TSQLStatement::SetMaxFieldSize ( Int_t ,
Long_t  )
inlinevirtualinherited

Definition at line 77 of file TSQLStatement.h.

◆ SetNull()

Bool_t TSQLiteStatement::SetNull ( Int_t npar)
finalvirtual

Set NULL as parameter value.

Reimplemented from TSQLStatement.

Definition at line 473 of file TSQLiteStatement.cxx.

◆ SetObjectStat()

void TObject::SetObjectStat ( Bool_t stat)
staticinherited

Turn on/off tracking of objects in the TObjectTable.

Definition at line 1188 of file TObject.cxx.

◆ SetSQLParamType()

Bool_t TSQLiteStatement::SetSQLParamType ( Int_t npar,
int sqltype,
bool sig,
int sqlsize = 0 )
private

◆ SetString()

Bool_t TSQLiteStatement::SetString ( Int_t npar,
const char * value,
Int_t maxsize = 256 )
finalvirtual

Set parameter value as string.

Reimplemented from TSQLStatement.

Definition at line 545 of file TSQLiteStatement.cxx.

◆ SetTime() [1/2]

Bool_t TSQLiteStatement::SetTime ( Int_t npar,
Int_t hour,
Int_t min,
Int_t sec )
finalvirtual

Set parameter value as time.

Reimplemented from TSQLStatement.

Definition at line 583 of file TSQLiteStatement.cxx.

◆ SetTime() [2/2]

Bool_t TSQLStatement::SetTime ( Int_t npar,
const TDatime & tm )
inherited

set only time value for specified parameter from TDatime object

Definition at line 284 of file TSQLStatement.cxx.

◆ SetTimeFormating()

virtual void TSQLStatement::SetTimeFormating ( const char * )
inlinevirtualinherited

Definition at line 60 of file TSQLStatement.h.

◆ SetTimestamp() [1/3]

Bool_t TSQLiteStatement::SetTimestamp ( Int_t npar,
Int_t year,
Int_t month,
Int_t day,
Int_t hour,
Int_t min,
Int_t sec,
Int_t frac = 0 )
finalvirtual

Set parameter value as timestamp.

The second fraction has to be in milliseconds, as all SQLite functions for date and time assume 3 significant digits.

Reimplemented from TSQLStatement.

Definition at line 609 of file TSQLiteStatement.cxx.

◆ SetTimestamp() [2/3]

set timestamp value for specified parameter from TDatime object

Definition at line 59 of file TSQLStatement.cxx.

◆ SetTimestamp() [3/3]

Set parameter as TTimeStamp.

Reimplemented from TSQLStatement.

Definition at line 58 of file TSQLStatement.cxx.

◆ SetUInt()

Bool_t TSQLiteStatement::SetUInt ( Int_t npar,
UInt_t value )
finalvirtual

Set parameter value as unsigned integer.

Actually casted to signed integer, has to be re-casted upon read!

Reimplemented from TSQLStatement.

Definition at line 494 of file TSQLiteStatement.cxx.

◆ SetULong64()

Bool_t TSQLiteStatement::SetULong64 ( Int_t npar,
ULong64_t value )
finalvirtual

Set parameter value as unsigned 64-bit integer.

Actually casted to signed integer, has to be re-casted upon read!

Reimplemented from TSQLStatement.

Definition at line 525 of file TSQLiteStatement.cxx.

◆ SetUniqueID()

void TObject::SetUniqueID ( UInt_t uid)
virtualinherited

Set the unique object id.

Definition at line 899 of file TObject.cxx.

◆ SetVDouble()

virtual Bool_t TSQLStatement::SetVDouble ( Int_t ,
const std::vector< Double_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 69 of file TSQLStatement.h.

◆ SetVInt()

virtual Bool_t TSQLStatement::SetVInt ( Int_t ,
const std::vector< Int_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 64 of file TSQLStatement.h.

◆ SetVLong()

virtual Bool_t TSQLStatement::SetVLong ( Int_t ,
const std::vector< Long_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 66 of file TSQLStatement.h.

◆ SetVLong64()

virtual Bool_t TSQLStatement::SetVLong64 ( Int_t ,
const std::vector< Long64_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 67 of file TSQLStatement.h.

◆ SetVUInt()

virtual Bool_t TSQLStatement::SetVUInt ( Int_t ,
const std::vector< UInt_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 65 of file TSQLStatement.h.

◆ SetVULong64()

virtual Bool_t TSQLStatement::SetVULong64 ( Int_t ,
const std::vector< ULong64_t > ,
const char * ,
const char *  )
inlinevirtualinherited

Definition at line 68 of file TSQLStatement.h.

◆ StoreResult()

Bool_t TSQLiteStatement::StoreResult ( )
finalvirtual

Store result of statement processing to access them via GetInt(), GetDouble() and so on methods.

For SQLite, this is a NO-OP.

Implements TSQLStatement.

Definition at line 192 of file TSQLiteStatement.cxx.

◆ Streamer()

void TSQLStatement::Streamer ( TBuffer & R__b)
overridevirtualinherited

Stream an object of class TObject.

Reimplemented from TObject.

◆ StreamerNVirtual()

void TSQLStatement::StreamerNVirtual ( TBuffer & ClassDef_StreamerNVirtual_b)
inlineinherited

Definition at line 121 of file TSQLStatement.h.

◆ SysError()

void TObject::SysError ( const char * location,
const char * fmt,
... ) const
virtualinherited

Issue system error message.

Use "location" to specify the method where the system error occurred. Accepts standard printf formatting arguments.

Definition at line 1112 of file TObject.cxx.

◆ TestBit()

Bool_t TObject::TestBit ( UInt_t f) const
inlineinherited

Definition at line 204 of file TObject.h.

◆ TestBits()

Int_t TObject::TestBits ( UInt_t f) const
inlineinherited

Definition at line 205 of file TObject.h.

◆ UseCurrentStyle()

void TObject::UseCurrentStyle ( )
virtualinherited

Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.

Reimplemented in TAxis3D, TCanvas, TFrame, TGraph, TH1, TPad, TPaveStats, TPaveText, and TTree.

Definition at line 909 of file TObject.cxx.

◆ Warning()

void TObject::Warning ( const char * location,
const char * fmt,
... ) const
virtualinherited

Issue warning message.

Use "location" to specify the method where the warning occurred. Accepts standard printf formatting arguments.

Definition at line 1084 of file TObject.cxx.

◆ Write() [1/2]

Int_t TObject::Write ( const char * name = nullptr,
Int_t option = 0,
Int_t bufsize = 0 )
virtualinherited

Write this object to the current directory.

For more see the const version of this method.

Reimplemented in ROOT::TBufferMergerFile, TBuffer, TCollection, TDirectory, TDirectoryFile, TFile, TMap, TParallelMergingFile, TSQLFile, TTree, and TXMLFile.

Definition at line 989 of file TObject.cxx.

◆ Write() [2/2]

Int_t TObject::Write ( const char * name = nullptr,
Int_t option = 0,
Int_t bufsize = 0 ) const
virtualinherited

Write this object to the current directory.

The data structure corresponding to this object is serialized. The corresponding buffer is written to the current directory with an associated key with name "name".

Writing an object to a file involves the following steps:

  • Creation of a support TKey object in the current directory. The TKey object creates a TBuffer object.
  • The TBuffer object is filled via the class::Streamer function.
  • If the file is compressed (default) a second buffer is created to hold the compressed buffer.
  • Reservation of the corresponding space in the file by looking in the TFree list of free blocks of the file.
  • The buffer is written to the file.

Bufsize can be given to force a given buffer size to write this object. By default, the buffersize will be taken from the average buffer size of all objects written to the current file so far.

If a name is specified, it will be the name of the key. If name is not given, the name of the key will be the name as returned by GetName().

The option can be a combination of: kSingleKey, kOverwrite or kWriteDelete Using the kOverwrite option a previous key with the same name is overwritten. The previous key is deleted before writing the new object. Using the kWriteDelete option a previous key with the same name is deleted only after the new object has been written. This option is safer than kOverwrite but it is slower. NOTE: Neither kOverwrite nor kWriteDelete reduces the size of a TFile– the space is simply freed up to be overwritten; in the case of a TTree, it is more complicated. If one opens a TTree, appends some entries, then writes it out, the behaviour is effectively the same. If, however, one creates a new TTree and writes it out in this way, only the metadata is replaced, effectively making the old data invisible without deleting it. TTree::Delete() can be used to mark all disk space occupied by a TTree as free before overwriting its metadata this way. The kSingleKey option is only used by TCollection::Write() to write a container with a single key instead of each object in the container with its own key.

An object is read from the file into memory via TKey::Read() or via TObject::Read().

The function returns the total number of bytes written to the file. It returns 0 if the object cannot be written.

Reimplemented in TBuffer, TCollection, TDirectory, TDirectoryFile, TFile, TMap, TParallelMergingFile, TSQLFile, TTree, and TXMLFile.

Definition at line 964 of file TObject.cxx.

Member Data Documentation

◆ fBits

UInt_t TObject::fBits
privateinherited

bit field status word

Definition at line 47 of file TObject.h.

◆ fErrorCode

Int_t TSQLStatement::fErrorCode {0}
protectedinherited

Definition at line 26 of file TSQLStatement.h.

◆ fErrorMsg

TString TSQLStatement::fErrorMsg
protectedinherited

Definition at line 27 of file TSQLStatement.h.

◆ fErrorOut

Bool_t TSQLStatement::fErrorOut {kFALSE}
protectedinherited

Definition at line 28 of file TSQLStatement.h.

◆ fgDtorOnly

Longptr_t TObject::fgDtorOnly = 0
staticprivateinherited

object for which to call dtor only (i.e. no delete)

Definition at line 49 of file TObject.h.

◆ fgObjectStat

Bool_t TObject::fgObjectStat = kTRUE
staticprivateinherited

if true keep track of objects in TObjectTable

Definition at line 50 of file TObject.h.

◆ fIterationCount

Int_t TSQLiteStatement::fIterationCount {0}
private

! Iteration count

Definition at line 31 of file TSQLiteStatement.h.

◆ fNumPars

Int_t TSQLiteStatement::fNumPars {0}
private

! Number of bindable / gettable parameters

Definition at line 30 of file TSQLiteStatement.h.

◆ fStmt

SQLite3_Stmt_t* TSQLiteStatement::fStmt {nullptr}
private

! executed statement

Definition at line 28 of file TSQLiteStatement.h.

◆ fUniqueID

UInt_t TObject::fUniqueID
privateinherited

object unique identifier

Definition at line 46 of file TObject.h.

◆ fWorkingMode

Int_t TSQLiteStatement::fWorkingMode {0}
private

! 1 - setting parameters, 2 - retrieving results

Definition at line 29 of file TSQLiteStatement.h.


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