io::ReadWriteModule Class Reference

Basic interface to event data file input and output. More...

#include <ReadWriteModule.h>

List of all members.

Public Member Functions
	ReadWriteModule ()
virtual	~ReadWriteModule ()
int	AddFile (const char *file_regexp)
int	RemoveFile (const char *file_regexp)
int	GoToFile (const char *file)
int	AdvanceFile (int n=1)
int	RewindFile (int n=1)
virtual int	GoTo (int run, int event)
virtual int	Advance (int n=1)
virtual int	Rewind (int n=1)
virtual int	Reload ()
void	AdoptInputFilter (io::Filter *f)
void	AdoptOutputFilter (io::Filter *f)
void	SetOutputFileName (const char *n)
void	Report () const
const char *	CurrentFile () const
const char *	FileName (int i) const
int	RunNumber () const
int	EventNumber () const
bool	ReadOK ()
edm::EventHandle &	GetEvent ()
int	WriteEvent ()
void	Close ()
void	SetOutSizeLimit (int mbLimit)
Protected Member Functions
void	SetReadOK (bool ok=true)
void	SetEventHandle (io::EventHandle *handle)
Private Member Functions
virtual void	UpdateEventNumbers ()
virtual int	SetupInputFile ()
int	SetupOutputFile ()
bool	CheckInFilters (edm::EventHandle &evt)
bool	CheckOutFilters (edm::EventHandle &evt)
Private Attributes
int	fRunNumber
	Run number for current event.
int	fEventNumber
	Event number for current event.
bool	fReadOK
	Next read should be OK?
int	fFileIndex
	Current place in the file list.
TFile *	fInFile
	Current file pointer.
io::EventHandle *	fEvtHandle
	The event handle.
bool	fOwnHandle
	Is the EvtHandle owned by us?
std::vector< std::string >	fFileList
	List of files attached.
TFile *	fOutFile
	Output data file.
int	fNwrite
	Number of events written.
int	fFlushFreq
	Flush output every n events.
Long64_t	fOutSizeLimit
	[bytes] Split output after this limit
std::vector< io::Filter * >	fInFilterList
	Owned list of input filters.
std::vector< io::Filter * >	fOutFilterList
	Owned list of output filters.

---

Detailed Description

Basic interface to event data file input and output.

Definition at line 27 of file ReadWriteModule.h.

---

Constructor & Destructor Documentation

ReadWriteModule::ReadWriteModule (   )

Definition at line 18 of file ReadWriteModule.cxx. : fRunNumber ( 0 ), fEventNumber ( 0 ), fReadOK ( false ), fFileIndex ( -1 ), fInFile ( 0 ), fEvtHandle ( 0 ), fOwnHandle ( true ), fOutFile ( 0 ), fNwrite ( 0 ), fFlushFreq ( 100 ), fOutSizeLimit( 0 ) { // fEvtHandle pointer is set to 0 so that classes which inherit can // change the pointer in their constructor before the handle is ever // accessed by IO module }

ReadWriteModule::~ReadWriteModule (   )  [virtual]

Close all files and clean up Definition at line 40 of file ReadWriteModule.cxx. References fEvtHandle, fInFile, fInFilterList, fOutFile, fOutFilterList, and fOwnHandle. { if (fInFile) { fInFile->Close(); delete fInFile; fInFile = 0; } if (fOutFile) { fOutFile->Write(); fOutFile->Close(); delete fOutFile; fOutFile = 0; } if (fOwnHandle && fEvtHandle) { delete fEvtHandle; } std::vector<Filter*>::iterator itr; std::vector<Filter*>::iterator itrEnd (fInFilterList.end()); itr = fInFilterList.begin(); itrEnd = fInFilterList.end(); for (; itr!=itrEnd; ++itr) if (*itr) delete (*itr); itr = fOutFilterList.begin(); itrEnd = fOutFilterList.end(); for (; itr!=itrEnd; ++itr) if (*itr) delete (*itr); }

---

Member Function Documentation

int ReadWriteModule::AddFile (  const char *  file_regexp  )

Add files that match the regular expression Todo: : The method for finding files which match the regular expression is rather primitive Definition at line 73 of file ReadWriteModule.cxx. References edm::EventHandle::Clear(), fEvtHandle, fFileIndex, fFileList, fReadOK, and SetupInputFile(). Referenced by evdb::IoModule::AddFile(), main(), and jobc::CmdLine::SetupIoModule(). { // If nobody created event handle, we should do it now if (!fEvtHandle) fEvtHandle = new EventHandle; // Cheap way to get list of files matching the expression (assumes // some flavor of unix char tmp_name[128] = {"/tmp/IOMOD.XXXXXX"}; mkstemp(tmp_name); std::string cmd; cmd = "(ls "; cmd += file_regexp; cmd += " > "; cmd += tmp_name; cmd += ") >& /dev/null"; system(cmd.c_str()); // Open the temp file and get the list of files which matched static const int s = 256; char buff[s]; FILE* fp = fopen(tmp_name,"r"); int nfiles = 0; std::string file; while ( fgets(buff,s-1,fp) != NULL ) { int len = strlen(buff); while (buff[len]==' ' || buff[len]=='\n' || buff[len]=='\0') --len; buff[len+1]='\0'; file = buff; fFileList.push_back(file); ++nfiles; } fclose(fp); // Remove the temporary file unlink(tmp_name); if(strstr(file_regexp,"dcache:dcap")!=0){ std::string f=(std::string)file_regexp; fFileList.push_back(f); } else if (strstr(file_regexp, "root://") != 0) { std::string f=(std::string)file_regexp; fFileList.push_back(f); } // Setup the first file in the list if (fFileIndex<0 && fFileList.size()>0) { fFileIndex = 0; fEvtHandle->Clear(); if (this->SetupInputFile()) { fReadOK = true; } else { fReadOK = false; } } return nfiles; }

void ReadWriteModule::AdoptInputFilter (  io::Filter *  f  )

Definition at line 531 of file ReadWriteModule.cxx. References fInFilterList. Referenced by jobc::CmdLine::SetupIoModule(). { fInFilterList.push_back(f); }

void ReadWriteModule::AdoptOutputFilter (  io::Filter *  f  )

Definition at line 539 of file ReadWriteModule.cxx. References fOutFilterList. { fOutFilterList.push_back(f); }

int ReadWriteModule::Advance (  int  n = 1  )  [virtual]

Advance n events in the stream Parameters: n  : Number of events to skip ahead Returns: Number of events actually skipped Definition at line 271 of file ReadWriteModule.cxx. References io::EventHandle::Advance(), AdvanceFile(), CheckInFilters(), fEvtHandle, fReadOK, and UpdateEventNumbers(). Referenced by evdb::IoModule::Advance(), GoTo(), main(), jobc::Job::Run(), and jobc::CmdLine::SetupIoModule(). { assert(fEvtHandle); int ndone = 0; while (ndone < n) { // Try to advance far enough in the current file to match the request int ntry = n-ndone; int ndid; ndid = fEvtHandle->Advance(ntry); ndone += ndid; // If the current file doesn't have enough events to fill the // request, go to the next file if (ndid<ntry) { int advance = this->AdvanceFile(); // If there is no next file, stop and return the number of records // actually advanced if (advance<1) { fReadOK = false; return ndone; } ++ndone; // count the file boundary as one advance } } // Check if the current event passed filters, if not, advance one if (this->CheckInFilters(*fEvtHandle) == false) { ndone += this->Advance(1); } this->UpdateEventNumbers(); return ndone; }

int ReadWriteModule::AdvanceFile (  int  n = 1  )

Advance n positions in the file list Parameters: n  : Number of files to skip. Counts the current file. Returns: Number of files actually skipped. Definition at line 171 of file ReadWriteModule.cxx. References fFileIndex, fFileList, fReadOK, and SetupInputFile(). Referenced by Advance(), and evdb::IoModule::AdvanceFile(). { if (n<=0) return 0; int indexMax = fFileList.size()-1; int indexSave = fFileIndex; fFileIndex += n; if (fFileIndex > indexMax) { fFileIndex = indexMax+1; fReadOK = false; return 0; } // Do something to open new file... this->SetupInputFile(); return (fFileIndex-indexSave); }

bool ReadWriteModule::CheckInFilters (  edm::EventHandle &  evd  )  [private]

Check if this event passes all the input filters attached to this module. Events which fail will be skipped. Parameters: evd  : The event to check against all filters. Definition at line 550 of file ReadWriteModule.cxx. References fInFilterList. Referenced by Advance(), and Rewind(). { std::vector<Filter*>::iterator itr (fInFilterList.begin()); std::vector<Filter*>::iterator itrEnd (fInFilterList.end()); for (; itr!=itrEnd; ++itr) { bool ret = (**itr)(evd); if (ret==false) return false; // Failed filter } return true; // Passed all filters }

bool ReadWriteModule::CheckOutFilters (  edm::EventHandle &  evd  )  [private]

Check if this event passes all the output filter attached to this module. Events which failed will not be written. Parameters: evd  : Handle to the event to examine Definition at line 568 of file ReadWriteModule.cxx. References fOutFilterList. { std::vector<Filter*>::iterator itr (fOutFilterList.begin()); std::vector<Filter*>::iterator itrEnd (fOutFilterList.end()); for (; itr!=itrEnd; ++itr) { bool ret = (**itr)(evd); if (ret==false) return false; // Failed filter } return true; // Passed all filters }

void ReadWriteModule::Close (   )

Close the output file attached to this module Definition at line 596 of file ReadWriteModule.cxx. References fNwrite, and fOutFile. Referenced by main(). { if (fOutFile) { std::cout << "Wrote " << fNwrite << " events. Closing file." << std::endl; fOutFile->Write(); fOutFile->Close(); delete fOutFile; fOutFile = 0; } }

const char * ReadWriteModule::CurrentFile (   )  const

Return the name of the currently open input file Parameters: The  name of the currently open input file Definition at line 397 of file ReadWriteModule.cxx. References fFileIndex, and fFileList. Referenced by evdb::IoModule::CurrentFile(), main(), and jobc::Job::Run(). { if (fFileList.size()>0) { if (fFileIndex>=0 && fFileIndex<(int)fFileList.size()) { return fFileList[fFileIndex].c_str(); } } return ""; }

int io::ReadWriteModule::EventNumber (   )  const [inline]

Definition at line 53 of file ReadWriteModule.h. References fEventNumber. Referenced by jobc::Job::Run(). { return fEventNumber; }

const char * ReadWriteModule::FileName (  int  i  )  const

Return the name of the ith file in the input list Parameters: i  : Index (starts from 0) Returns: : File name. 0 if there is no file at the position i Definition at line 414 of file ReadWriteModule.cxx. References fFileList. Referenced by evdb::IoModule::FileName(). { if (i>=0 && i<(int)fFileList.size()) return fFileList[i].c_str(); return 0; }

edm::EventHandle & ReadWriteModule::GetEvent (   )

Return the event handle connected to the input stream Returns: The event handle connected to the input stream Definition at line 426 of file ReadWriteModule.cxx. References fEvtHandle. Referenced by evdb::IoModule::GetEvent(), main(), jobc::Job::Run(), and UpdateEventNumbers(). { if (!fEvtHandle) fEvtHandle = new EventHandle; return *fEvtHandle; }

int ReadWriteModule::GoTo (  int  run, int  event )  [virtual]

Skip exactly to a particular run and event number. Returns: 1 if run/event are found, 0 if failed. If we fail to find the event, the position in the stream is left where the search terminated. Definition at line 227 of file ReadWriteModule.cxx. References Advance(), fEventNumber, fRunNumber, Rewind(), and UpdateEventNumbers(). Referenced by evdb::IoModule::GoTo(), main(), and jobc::CmdLine::SetupIoModule(). { // Get an initial guess at how many events to skip this->UpdateEventNumbers(); int nSkipEvent = abs(event - fEventNumber); if (run != fRunNumber) nSkipEvent += 1000; // This assumes that the files are sorted in run/event order for (;;) { // Check if we're done if (fRunNumber == run && fEventNumber == event) return 1; // Advance/Rewind in the data stream while (run<fRunNumber || event<fEventNumber) { int nrew = this->Rewind(nSkipEvent); this->UpdateEventNumbers(); if (nrew == 0) break; } while (run>fRunNumber || event>fEventNumber) { int nadv = this->Advance(nSkipEvent); this->UpdateEventNumbers(); if (nadv == 0) break; } // Check if we've found the right event if (fRunNumber == run && fEventNumber == event) return 1; // If we were stepping one-by-one and couldn't find the event, // stop searching if (nSkipEvent <= 1) return 0; // Reduce step size for next search nSkipEvent = nSkipEvent/2; } return 0; }

int ReadWriteModule::GoToFile (  const char *  file  )

Move the input stream to the start of a named file Parameters: file  : name of file to skip to Returns: 1 on success, 0 on failure Definition at line 150 of file ReadWriteModule.cxx. References fFileIndex, fFileList, and SetupInputFile(). Referenced by evdb::IoModule::GoToFile(). { unsigned int i; for (i=0; i<fFileList.size(); ++i) { if (fFileList[i] == file) { fFileIndex = i; this->SetupInputFile(); return 1; } } // File not in list return 0; }

bool ReadWriteModule::ReadOK (   )

Definition at line 482 of file ReadWriteModule.cxx. References fReadOK. Referenced by main(), and jobc::Job::Run(). { return fReadOK; }

int ReadWriteModule::Reload (   )  [virtual]

Mark the event handle as unfilled so that requests for data members have to go back to the event file Returns: 1 on success ( Todo: success is the only possibility...) Definition at line 342 of file ReadWriteModule.cxx. References edm::EventHandle::ClearLoadFlags(), and fEvtHandle. Referenced by evdb::IoModule::Reload(). { fEvtHandle->ClearLoadFlags(); return 1; }

int ReadWriteModule::RemoveFile (  const char *  file_regexp  )

Remove files from the input list Parameters: file_regexp  : Files to remove from a list Todo: Not implemented Definition at line 139 of file ReadWriteModule.cxx. Referenced by evdb::IoModule::RemoveFile(). { return 0; }

void ReadWriteModule::Report (   )  const

Print some summary information about the status of the input module Definition at line 379 of file ReadWriteModule.cxx. References fEvtHandle, fFileIndex, fFileList, and io::EventHandle::Index(). Referenced by evdb::IoModule::AddFile(), and jobc::Job::Run(). { std::cout << "Files in list:" << std::endl; for (int i=0; i<(int)fFileList.size(); ++i) { if (i==fFileIndex) std::cout << ">"; else std::cout << " "; std::cout << "[" << i << "] " << fFileList[i]; if (i==fFileIndex) std::cout << " (i="<<fEvtHandle->Index()<<")"; std::cout << std::endl; } }

int ReadWriteModule::Rewind (  int  n = 1  )  [virtual]

Go back n positions in the event stream Parameters: n  : Skip backwards n events in the stream Returns: Number of events actually skipped Definition at line 310 of file ReadWriteModule.cxx. References CheckInFilters(), fEvtHandle, io::EventHandle::Rewind(), and RewindFile(). Referenced by GoTo(), and evdb::IoModule::Rewind(). { int ndone = 0; while (ndone < n) { // Try to rewind far enough in the current file to finish int ntry = n-ndone; int ndid = fEvtHandle->Rewind(ntry); ndone += ndid; // Not enough events in current file, go to previous file and if (ndid<ntry) { int rewind = this->RewindFile(); if (rewind<1) { std::cout << "Reached start of event stream.\n"; return ndone; } ++ndone; // count the file boundary as one rewind } } // Check if the current event passed filters, if not, rewind one if (this->CheckInFilters(*fEvtHandle) == false) { ndone += this->Rewind(1); } return ndone; }

int ReadWriteModule::RewindFile (  int  n = 1  )

Rewind n positions in the file list Parameters: n  : Number of position to go back Returns: Number of positions actually skipped Definition at line 198 of file ReadWriteModule.cxx. References fFileIndex, fReadOK, and SetupInputFile(). Referenced by Rewind(), and evdb::IoModule::RewindFile(). { if (n<=0) return 0; int indexMin = 0; int indexSave = fFileIndex; fFileIndex -= n; if (fFileIndex < indexMin) { fFileIndex = 0; fReadOK = false; return 0; } // Do something to open new file... this->SetupInputFile(); return (indexSave-fFileIndex); }

int io::ReadWriteModule::RunNumber (   )  const [inline]

Definition at line 52 of file ReadWriteModule.h. References fRunNumber. Referenced by jobc::Job::Run(), and jobc::CmdLine::SetupIoModule(). { return fRunNumber; }

void ReadWriteModule::SetEventHandle (  io::EventHandle *  handle  )  [protected]

Establish the connection between this module and an event handle. Parameters: handle  : The event handle where event data ends up in memory Definition at line 585 of file ReadWriteModule.cxx. References fEvtHandle, and fOwnHandle. { assert(!fEvtHandle); fEvtHandle = handle; fOwnHandle = false; }

void ReadWriteModule::SetOutputFileName (  const char *  n  )

Set the output file name and set it up Parameters: n  : Name of the output file Todo: No provisions made for appending to files etc. etc. Only "RECREATE" supported Definition at line 357 of file ReadWriteModule.cxx. References io::EventHandle::Close(), fEvtHandle, fOutFile, and io::EventHandle::SetupOutputFile(). Referenced by main(), evdb::IoModule::SetOutputFileName(), jobc::CmdLine::SetupIoModule(), and WriteEvent(). { std::string fname(n); if (!fEvtHandle) fEvtHandle = new EventHandle; if (fOutFile && (fname==fOutFile->GetName())) return; if (fOutFile) { fEvtHandle->Close(); fOutFile->Flush(); fOutFile->Write(); delete fOutFile; fOutFile = 0; } fOutFile = new TFile(fname.c_str(),"RECREATE","Event Data File",1); fEvtHandle->SetupOutputFile(fOutFile); }

void ReadWriteModule::SetOutSizeLimit (  int  mbLimit  )

Set the output file buffer size Parameters: mbLimit  : Size in Mb Definition at line 614 of file ReadWriteModule.cxx. References fOutSizeLimit. Referenced by jobc::CmdLine::SetupIoModule(). { fOutSizeLimit = mbLimit; fOutSizeLimit *= 1000000; }

void io::ReadWriteModule::SetReadOK (  bool  ok = true  )  [inline, protected]

Definition at line 69 of file ReadWriteModule.h. References fReadOK. { fReadOK = ok; }

int ReadWriteModule::SetupInputFile (   )  [private, virtual]

Definition at line 486 of file ReadWriteModule.cxx. References fEvtHandle, fFileIndex, fFileList, fInFile, fReadOK, io::EventHandle::SetupInputFile(), and UpdateEventNumbers(). Referenced by AddFile(), AdvanceFile(), GoToFile(), and RewindFile(). { //====================================================================== // Setup a new file //====================================================================== if (fFileIndex<0 || fFileIndex>=(int)fFileList.size()) { fReadOK = false; return 0; } // Check if the filename has changed if (fInFile && fInFile->GetName()!=fFileList[fFileIndex]) { fInFile->Flush(); fInFile->Close(); delete fInFile; fInFile = 0; fReadOK = false; } // Open the new file fInFile = TFile::Open(fFileList[fFileIndex].c_str()); if (fInFile==0) { std::cout << "Failed to open file '" << fFileList[fFileIndex] << "' for read.\n"; // std::cout<<"Is it a dcache file? "<<endl; // if(strstr(fFileList[fFileIndex].c_str(),"dcache:dcap")!=0){ // fInFile = TFile::Open(fFileList[fFileIndex].c_str()) fReadOK = false; return 0; } // Sync. the event handle to the new file if (fEvtHandle->SetupInputFile(fInFile)) { this->UpdateEventNumbers(); fReadOK = true; return 1; } // Error conditions fall through to here fReadOK = false; return 0; }

int io::ReadWriteModule::SetupOutputFile (   )  [private]

void ReadWriteModule::UpdateEventNumbers (   )  [private, virtual]

Update the run and event numbers used for tracking our position in the event stream Definition at line 437 of file ReadWriteModule.cxx. References edm::EventHeader::Event(), fEventNumber, fRunNumber, GetEvent(), edm::EventHandle::Header(), and edm::EventHeader::Run(). Referenced by Advance(), GoTo(), and SetupInputFile(). { edm::EventHandle& ev = this->GetEvent(); edm::EventHeader& eh = ev.Header(); fRunNumber = eh.Run(); fEventNumber = eh.Event(); }

int ReadWriteModule::WriteEvent (   )

Write Todo: There should be some options for clearing temporary Definition at line 450 of file ReadWriteModule.cxx. References fEventNumber, fEvtHandle, fFlushFreq, fNwrite, fOutFile, fOutSizeLimit, SetOutputFileName(), and io::EventHandle::Write(). Referenced by main(), jobc::Job::Run(), and evdb::IoModule::WriteEvent(). { if (fOutFile==0) { std::cout << "ReadWriteModule: No output file set." << std::endl; return 0; } int aok = fEvtHandle->Write(); if (aok) { ++fNwrite; if (fNwrite%fFlushFreq == 0) { fOutFile->Flush(); } } if ((fOutSizeLimit > 0) && (fOutSizeLimit < fOutFile->GetSize())) { // We should start writing to a new file std::string fname = fOutFile->GetName(); std::string::size_type pos = fname.find("_Evt"); if (pos == std::string::npos) { pos = fname.find(".root"); } fname = fname.substr(0, pos); char evtStr[256]; sprintf(evtStr, "_Evt%06d.root", fEventNumber); fname += evtStr; std::cout << "Starting new file: " << fname << std::endl; SetOutputFileName(fname.c_str()); } return aok; }

---

Member Data Documentation

int io::ReadWriteModule::fEventNumber [private]

Event number for current event. Definition at line 75 of file ReadWriteModule.h. Referenced by EventNumber(), GoTo(), UpdateEventNumbers(), and WriteEvent().

io::EventHandle* io::ReadWriteModule::fEvtHandle [private]

The event handle. Definition at line 79 of file ReadWriteModule.h. Referenced by AddFile(), Advance(), GetEvent(), Reload(), Report(), Rewind(), SetEventHandle(), SetOutputFileName(), SetupInputFile(), WriteEvent(), and ~ReadWriteModule().

int io::ReadWriteModule::fFileIndex [private]

Current place in the file list. Definition at line 77 of file ReadWriteModule.h. Referenced by AddFile(), AdvanceFile(), CurrentFile(), GoToFile(), Report(), RewindFile(), and SetupInputFile().

std::vector<std::string> io::ReadWriteModule::fFileList [private]

List of files attached. Definition at line 81 of file ReadWriteModule.h. Referenced by AddFile(), AdvanceFile(), CurrentFile(), FileName(), GoToFile(), Report(), and SetupInputFile().

int io::ReadWriteModule::fFlushFreq [private]

Flush output every n events. Definition at line 86 of file ReadWriteModule.h. Referenced by WriteEvent().

TFile* io::ReadWriteModule::fInFile [private]

Current file pointer. Definition at line 78 of file ReadWriteModule.h. Referenced by SetupInputFile(), and ~ReadWriteModule().

std::vector<io::Filter*> io::ReadWriteModule::fInFilterList [private]

Owned list of input filters. Definition at line 90 of file ReadWriteModule.h. Referenced by AdoptInputFilter(), CheckInFilters(), and ~ReadWriteModule().

int io::ReadWriteModule::fNwrite [private]

Number of events written. Definition at line 85 of file ReadWriteModule.h. Referenced by Close(), and WriteEvent().

TFile* io::ReadWriteModule::fOutFile [private]

Output data file. Definition at line 84 of file ReadWriteModule.h. Referenced by Close(), SetOutputFileName(), WriteEvent(), and ~ReadWriteModule().

std::vector<io::Filter*> io::ReadWriteModule::fOutFilterList [private]

Owned list of output filters. Definition at line 91 of file ReadWriteModule.h. Referenced by AdoptOutputFilter(), CheckOutFilters(), and ~ReadWriteModule().

Long64_t io::ReadWriteModule::fOutSizeLimit [private]

[bytes] Split output after this limit Definition at line 87 of file ReadWriteModule.h. Referenced by SetOutSizeLimit(), and WriteEvent().

bool io::ReadWriteModule::fOwnHandle [private]

Is the EvtHandle owned by us? Definition at line 80 of file ReadWriteModule.h. Referenced by SetEventHandle(), and ~ReadWriteModule().

bool io::ReadWriteModule::fReadOK [private]

Next read should be OK? Definition at line 76 of file ReadWriteModule.h. Referenced by AddFile(), Advance(), AdvanceFile(), ReadOK(), RewindFile(), SetReadOK(), and SetupInputFile().

int io::ReadWriteModule::fRunNumber [private]

Run number for current event. Definition at line 74 of file ReadWriteModule.h. Referenced by GoTo(), RunNumber(), and UpdateEventNumbers().

---

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

• ReadWriteModule.h
• ReadWriteModule.cxx

---