| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583 | <?php/** * PHPExcel * * Copyright (c) 2006 - 2011 PHPExcel * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA * * @category   PHPExcel * @package	PHPExcel_Worksheet * @copyright  Copyright (c) 2006 - 2011 PHPExcel (http://www.codeplex.com/PHPExcel) * @license	http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt	LGPL * @version	1.7.6, 2011-02-27 *//** * PHPExcel_Worksheet * * @category   PHPExcel * @package	PHPExcel_Worksheet * @copyright  Copyright (c) 2006 - 2011 PHPExcel (http://www.codeplex.com/PHPExcel) */class PHPExcel_Worksheet implements PHPExcel_IComparable{	/* Break types */	const BREAK_NONE	= 0;	const BREAK_ROW		= 1;	const BREAK_COLUMN	= 2;	/* Sheet state */	const SHEETSTATE_VISIBLE	= 'visible';	const SHEETSTATE_HIDDEN	= 'hidden';	const SHEETSTATE_VERYHIDDEN = 'veryHidden';	/**	 * Invalid characters in sheet title	 *	 * @var array	 */	private static $_invalidCharacters = array('*', ':', '/', '\\', '?', '[', ']');	/**	 * Parent spreadsheet	 *	 * @var PHPExcel	 */	private $_parent;	/**	 * Cacheable collection of cells	 *	 * @var PHPExcel_CachedObjectStorage_xxx	 */	private $_cellCollection = null;	/**	 * Collection of row dimensions	 *	 * @var PHPExcel_Worksheet_RowDimension[]	 */	private $_rowDimensions = array();	/**	 * Default row dimension	 *	 * @var PHPExcel_Worksheet_RowDimension	 */	private $_defaultRowDimension = null;	/**	 * Collection of column dimensions	 *	 * @var PHPExcel_Worksheet_ColumnDimension[]	 */	private $_columnDimensions = array();	/**	 * Default column dimension	 *	 * @var PHPExcel_Worksheet_ColumnDimension	 */	private $_defaultColumnDimension = null;	/**	 * Collection of drawings	 *	 * @var PHPExcel_Worksheet_BaseDrawing[]	 */	private $_drawingCollection = null;	/**	 * Worksheet title	 *	 * @var string	 */	private $_title;	/**	 * Sheet state	 *	 * @var string	 */	private $_sheetState;	/**	 * Page setup	 *	 * @var PHPExcel_Worksheet_PageSetup	 */	private $_pageSetup;	/**	 * Page margins	 *	 * @var PHPExcel_Worksheet_PageMargins	 */	private $_pageMargins;	/**	 * Page header/footer	 *	 * @var PHPExcel_Worksheet_HeaderFooter	 */	private $_headerFooter;	/**	 * Sheet view	 *	 * @var PHPExcel_Worksheet_SheetView	 */	private $_sheetView;	/**	 * Protection	 *	 * @var PHPExcel_Worksheet_Protection	 */	private $_protection;	/**	 * Collection of styles	 *	 * @var PHPExcel_Style[]	 */	private $_styles = array();	/**	 * Conditional styles. Indexed by cell coordinate, e.g. 'A1'	 *	 * @var array	 */	private $_conditionalStylesCollection = array();	/**	 * Is the current cell collection sorted already?	 *	 * @var boolean	 */	private $_cellCollectionIsSorted = false;	/**	 * Collection of breaks	 *	 * @var array	 */	private $_breaks = array();	/**	 * Collection of merged cell ranges	 *	 * @var array	 */	private $_mergeCells = array();	/**	 * Collection of protected cell ranges	 *	 * @var array	 */	private $_protectedCells = array();	/**	 * Autofilter Range	 *	 * @var string	 */	private $_autoFilter = '';	/**	 * Freeze pane	 *	 * @var string	 */	private $_freezePane = '';	/**	 * Show gridlines?	 *	 * @var boolean	 */	private $_showGridlines = true;	/**	* Print gridlines?	*	* @var boolean	*/	private $_printGridlines = false;	/**	* Show row and column headers?	*	* @var boolean	*/	private $_showRowColHeaders = true;	/**	 * Show summary below? (Row/Column outline)	 *	 * @var boolean	 */	private $_showSummaryBelow = true;	/**	 * Show summary right? (Row/Column outline)	 *	 * @var boolean	 */	private $_showSummaryRight = true;	/**	 * Collection of comments	 *	 * @var PHPExcel_Comment[]	 */	private $_comments = array();	/**	 * Active cell. (Only one!)	 *	 * @var string	 */	private $_activeCell = 'A1';	/**	 * Selected cells	 *	 * @var string	 */	private $_selectedCells = 'A1';	/**	 * Cached highest column	 *	 * @var string	 */	private $_cachedHighestColumn = 'A';	/**	 * Cached highest row	 *	 * @var int	 */	private $_cachedHighestRow = 1;	/**	 * Right-to-left?	 *	 * @var boolean	 */	private $_rightToLeft = false;	/**	 * Hyperlinks. Indexed by cell coordinate, e.g. 'A1'	 *	 * @var array	 */	private $_hyperlinkCollection = array();	/**	 * Data validation objects. Indexed by cell coordinate, e.g. 'A1'	 *	 * @var array	 */	private $_dataValidationCollection = array();	/**	 * Tab color	 *	 * @var PHPExcel_Style_Color	 */	private $_tabColor;	/**	 * Dirty flag	 *	 * @var boolean	 */	private $_dirty	= true;	/**	 * Hash	 *	 * @var string	 */	private $_hash	= null;	/**	 * Create a new worksheet	 *	 * @param PHPExcel		$pParent	 * @param string		$pTitle	 */	public function __construct(PHPExcel $pParent = null, $pTitle = 'Worksheet')	{		// Set parent and title		$this->_parent = $pParent;		$this->setTitle($pTitle);		$this->setSheetState(PHPExcel_Worksheet::SHEETSTATE_VISIBLE);		$this->_cellCollection		= PHPExcel_CachedObjectStorageFactory::getInstance($this);		// Set page setup		$this->_pageSetup			= new PHPExcel_Worksheet_PageSetup();		// Set page margins		$this->_pageMargins			= new PHPExcel_Worksheet_PageMargins();		// Set page header/footer		$this->_headerFooter		= new PHPExcel_Worksheet_HeaderFooter();		// Set sheet view		$this->_sheetView			= new PHPExcel_Worksheet_SheetView();		// Drawing collection		$this->_drawingCollection	= new ArrayObject();		// Protection		$this->_protection			= new PHPExcel_Worksheet_Protection();		// Default row dimension		$this->_defaultRowDimension = new PHPExcel_Worksheet_RowDimension(null);		// Default column dimension		$this->_defaultColumnDimension = new PHPExcel_Worksheet_ColumnDimension(null);	}	public function disconnectCells() {		$this->_cellCollection->unsetWorksheetCells();		$this->_cellCollection = null;		//	detach ourself from the workbook, so that it can then delete this worksheet successfully		$this->_parent = null;	}	/**	 * Return the cache controller for the cell collection	 *	 * @return PHPExcel_CachedObjectStorage_xxx	 */	public function getCellCacheController() {		return $this->_cellCollection;	}	//	function getCellCacheController()	/**	 * Get array of invalid characters for sheet title	 *	 * @return array	 */	public static function getInvalidCharacters()	{		return self::$_invalidCharacters;	}	/**	 * Check sheet title for valid Excel syntax	 *	 * @param string $pValue The string to check	 * @return string The valid string	 * @throws Exception	 */	private static function _checkSheetTitle($pValue)	{		// Some of the printable ASCII characters are invalid:  * : / \ ? [ ]		if (str_replace(self::$_invalidCharacters, '', $pValue) !== $pValue) {			throw new Exception('Invalid character found in sheet title');		}		// Maximum 31 characters allowed for sheet title		if (PHPExcel_Shared_String::CountCharacters($pValue) > 31) {			throw new Exception('Maximum 31 characters allowed in sheet title.');		}		return $pValue;	}	/**	 * Get collection of cells	 *	 * @param boolean $pSorted Also sort the cell collection?	 * @return PHPExcel_Cell[]	 */	public function getCellCollection($pSorted = true)	{		if ($pSorted) {			// Re-order cell collection			return $this->sortCellCollection();		}		if (!is_null($this->_cellCollection)) {			return $this->_cellCollection->getCellList();		}		return array();	}	/**	 * Sort collection of cells	 *	 * @return PHPExcel_Worksheet	 */	public function sortCellCollection()	{		if (!is_null($this->_cellCollection)) {			return $this->_cellCollection->getSortedCellList();		}		return array();	}	/**	 * Get collection of row dimensions	 *	 * @return PHPExcel_Worksheet_RowDimension[]	 */	public function getRowDimensions()	{		return $this->_rowDimensions;	}	/**	 * Get default row dimension	 *	 * @return PHPExcel_Worksheet_RowDimension	 */	public function getDefaultRowDimension()	{		return $this->_defaultRowDimension;	}	/**	 * Get collection of column dimensions	 *	 * @return PHPExcel_Worksheet_ColumnDimension[]	 */	public function getColumnDimensions()	{		return $this->_columnDimensions;	}	/**	 * Get default column dimension	 *	 * @return PHPExcel_Worksheet_ColumnDimension	 */	public function getDefaultColumnDimension()	{		return $this->_defaultColumnDimension;	}	/**	 * Get collection of drawings	 *	 * @return PHPExcel_Worksheet_BaseDrawing[]	 */	public function getDrawingCollection()	{		return $this->_drawingCollection;	}	/**	 * Refresh column dimensions	 *	 * @return PHPExcel_Worksheet	 */	public function refreshColumnDimensions()	{		$currentColumnDimensions = $this->getColumnDimensions();		$newColumnDimensions = array();		foreach ($currentColumnDimensions as $objColumnDimension) {			$newColumnDimensions[$objColumnDimension->getColumnIndex()] = $objColumnDimension;		}		$this->_columnDimensions = $newColumnDimensions;		return $this;	}	/**	 * Refresh row dimensions	 *	 * @return PHPExcel_Worksheet	 */	public function refreshRowDimensions()	{		$currentRowDimensions = $this->getRowDimensions();		$newRowDimensions = array();		foreach ($currentRowDimensions as $objRowDimension) {			$newRowDimensions[$objRowDimension->getRowIndex()] = $objRowDimension;		}		$this->_rowDimensions = $newRowDimensions;		return $this;	}	/**	 * Calculate worksheet dimension	 *	 * @return string  String containing the dimension of this worksheet	 */	public function calculateWorksheetDimension()	{		// Return		return 'A1' . ':' .  $this->getHighestColumn() . $this->getHighestRow();	}	/**	 * Calculate widths for auto-size columns	 *	 * @param  boolean  $calculateMergeCells  Calculate merge cell width	 * @return PHPExcel_Worksheet;	 */	public function calculateColumnWidths($calculateMergeCells = false)	{		// initialize $autoSizes array		$autoSizes = array();		foreach ($this->getColumnDimensions() as $colDimension) {			if ($colDimension->getAutoSize()) {				$autoSizes[$colDimension->getColumnIndex()] = -1;			}		}		// There is only something to do if there are some auto-size columns		if (!empty($autoSizes)) {			// build list of cells references that participate in a merge			$isMergeCell = array();			foreach ($this->getMergeCells() as $cells) {				foreach (PHPExcel_Cell::extractAllCellReferencesInRange($cells) as $cellReference) {					$isMergeCell[$cellReference] = true;				}			}			// loop through all cells in the worksheet			foreach ($this->getCellCollection(false) as $cellID) {				$cell = $this->getCell($cellID);				if (isset($autoSizes[$cell->getColumn()])) {					// Determine width if cell does not participate in a merge					if (!isset($isMergeCell[$cell->getCoordinate()])) {						// Calculated value						$cellValue = $cell->getCalculatedValue();						// To formatted string						$cellValue = PHPExcel_Style_NumberFormat::toFormattedString($cellValue, $this->getParent()->getCellXfByIndex($cell->getXfIndex())->getNumberFormat()->getFormatCode());						$autoSizes[$cell->getColumn()] = max(							(float)$autoSizes[$cell->getColumn()],							(float)PHPExcel_Shared_Font::calculateColumnWidth(								$this->getParent()->getCellXfByIndex($cell->getXfIndex())->getFont(),								$cellValue,								$this->getParent()->getCellXfByIndex($cell->getXfIndex())->getAlignment()->getTextRotation(),								$this->getDefaultStyle()->getFont()							)						);					}				}			}			// adjust column widths			foreach ($autoSizes as $columnIndex => $width) {				if ($width == -1) $width = $this->getDefaultColumnDimension()->getWidth();				$this->getColumnDimension($columnIndex)->setWidth($width);			}		}		return $this;	}	/**	 * Get parent	 *	 * @return PHPExcel	 */	public function getParent() {		return $this->_parent;	}	/**	 * Re-bind parent	 *	 * @param PHPExcel $parent	 * @return PHPExcel_Worksheet	 */	public function rebindParent(PHPExcel $parent) {		$namedRanges = $this->_parent->getNamedRanges();		foreach ($namedRanges as $namedRange) {			$parent->addNamedRange($namedRange);		}		$this->_parent->removeSheetByIndex(			$this->_parent->getIndex($this)		);		$this->_parent = $parent;		return $this;	}	/**	 * Get title	 *	 * @return string	 */	public function getTitle()	{		return $this->_title;	}	/**	 * Set title	 *	 * @param string $pValue String containing the dimension of this worksheet	 * @return PHPExcel_Worksheet	 */	public function setTitle($pValue = 'Worksheet')	{		// Is this a 'rename' or not?		if ($this->getTitle() == $pValue) {			return $this;		}		// Syntax check		self::_checkSheetTitle($pValue);		// Old title		$oldTitle = $this->getTitle();		// Is there already such sheet name?		if ($this->getParent()->getSheetByName($pValue)) {			// Use name, but append with lowest possible integer			if (PHPExcel_Shared_String::CountCharacters($pValue) > 29) {				$pValue = PHPExcel_Shared_String::Substring($pValue,0,29);			}			$i = 1;			while ($this->getParent()->getSheetByName($pValue . ' ' . $i)) {				++$i;				if ($i == 10) {					if (PHPExcel_Shared_String::CountCharacters($pValue) > 28) {						$pValue = PHPExcel_Shared_String::Substring($pValue,0,28);					}				} elseif ($i == 100) {					if (PHPExcel_Shared_String::CountCharacters($pValue) > 27) {						$pValue = PHPExcel_Shared_String::Substring($pValue,0,27);					}				}			}			$altTitle = $pValue . ' ' . $i;			return $this->setTitle($altTitle);		}		// Set title		$this->_title = $pValue;		$this->_dirty = true;		// New title		$newTitle = $this->getTitle();		PHPExcel_ReferenceHelper::getInstance()->updateNamedFormulas($this->getParent(), $oldTitle, $newTitle);		return $this;	}	/**	 * Get sheet state	 *	 * @return string Sheet state (visible, hidden, veryHidden)	 */	public function getSheetState() {		return $this->_sheetState;	}	/**	 * Set sheet state	 *	 * @param string $value Sheet state (visible, hidden, veryHidden)	 * @return PHPExcel_Worksheet	 */	public function setSheetState($value = PHPExcel_Worksheet::SHEETSTATE_VISIBLE) {		$this->_sheetState = $value;		return $this;	}	/**	 * Get page setup	 *	 * @return PHPExcel_Worksheet_PageSetup	 */	public function getPageSetup()	{		return $this->_pageSetup;	}	/**	 * Set page setup	 *	 * @param PHPExcel_Worksheet_PageSetup	$pValue	 * @return PHPExcel_Worksheet	 */	public function setPageSetup(PHPExcel_Worksheet_PageSetup $pValue)	{		$this->_pageSetup = $pValue;		return $this;	}	/**	 * Get page margins	 *	 * @return PHPExcel_Worksheet_PageMargins	 */	public function getPageMargins()	{		return $this->_pageMargins;	}	/**	 * Set page margins	 *	 * @param PHPExcel_Worksheet_PageMargins	$pValue	 * @return PHPExcel_Worksheet	 */	public function setPageMargins(PHPExcel_Worksheet_PageMargins $pValue)	{		$this->_pageMargins = $pValue;		return $this;	}	/**	 * Get page header/footer	 *	 * @return PHPExcel_Worksheet_HeaderFooter	 */	public function getHeaderFooter()	{		return $this->_headerFooter;	}	/**	 * Set page header/footer	 *	 * @param PHPExcel_Worksheet_HeaderFooter	$pValue	 * @return PHPExcel_Worksheet	 */	public function setHeaderFooter(PHPExcel_Worksheet_HeaderFooter $pValue)	{		$this->_headerFooter = $pValue;		return $this;	}	/**	 * Get sheet view	 *	 * @return PHPExcel_Worksheet_HeaderFooter	 */	public function getSheetView()	{		return $this->_sheetView;	}	/**	 * Set sheet view	 *	 * @param PHPExcel_Worksheet_SheetView	$pValue	 * @return PHPExcel_Worksheet	 */	public function setSheetView(PHPExcel_Worksheet_SheetView $pValue)	{		$this->_sheetView = $pValue;		return $this;	}	/**	 * Get Protection	 *	 * @return PHPExcel_Worksheet_Protection	 */	public function getProtection()	{		return $this->_protection;	}	/**	 * Set Protection	 *	 * @param PHPExcel_Worksheet_Protection	$pValue	 * @return PHPExcel_Worksheet	 */	public function setProtection(PHPExcel_Worksheet_Protection $pValue)	{		$this->_protection = $pValue;		$this->_dirty = true;		return $this;	}	/**	 * Get highest worksheet column	 *	 * @return string Highest column name	 */	public function getHighestColumn()	{		return $this->_cachedHighestColumn;	}	/**	 * Get highest worksheet row	 *	 * @return int Highest row number	 */	public function getHighestRow()	{		return $this->_cachedHighestRow;	}	/**	 * Set a cell value	 *	 * @param string	$pCoordinate	Coordinate of the cell	 * @param mixed	$pValue			Value of the cell	 * @param bool		$returnCell		Return the worksheet (false, default) or the cell (true)	 * @return PHPExcel_Worksheet|PHPExcel_Cell	Depending on the last parameter being specified	 */	public function setCellValue($pCoordinate = 'A1', $pValue = null, $returnCell = false)	{		$cell = $this->getCell($pCoordinate);		$cell->setValue($pValue);		if ($returnCell) {			return $cell;		}		return $this;	}	/**	 * Set a cell value by using numeric cell coordinates	 *	 * @param string	$pColumn		Numeric column coordinate of the cell	 * @param string	$pRow			Numeric row coordinate of the cell	 * @param mixed		$pValue			Value of the cell	 * @param bool		$returnCell		Return the worksheet (false, default) or the cell (true)	 * @return PHPExcel_Worksheet|PHPExcel_Cell	Depending on the last parameter being specified	 */	public function setCellValueByColumnAndRow($pColumn = 0, $pRow = 1, $pValue = null, $returnCell = false)	{		$cell = $this->getCell(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);		$cell->setValue($pValue);		if ($returnCell) {			return $cell;		}		return $this;	}	/**	 * Set a cell value	 *	 * @param string	$pCoordinate	Coordinate of the cell	 * @param mixed	$pValue			Value of the cell	 * @param string	$pDataType		Explicit data type	 * @return PHPExcel_Worksheet	 */	public function setCellValueExplicit($pCoordinate = 'A1', $pValue = null, $pDataType = PHPExcel_Cell_DataType::TYPE_STRING)	{		// Set value		$this->getCell($pCoordinate)->setValueExplicit($pValue, $pDataType);		return $this;	}	/**	 * Set a cell value by using numeric cell coordinates	 *	 * @param string	$pColumn		Numeric column coordinate of the cell	 * @param string	$pRow			Numeric row coordinate of the cell	 * @param mixed		$pValue			Value of the cell	 * @param string	$pDataType		Explicit data type	 * @return PHPExcel_Worksheet	 */	public function setCellValueExplicitByColumnAndRow($pColumn = 0, $pRow = 1, $pValue = null, $pDataType = PHPExcel_Cell_DataType::TYPE_STRING)	{		return $this->getCell(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow)->setValueExplicit($pValue, $pDataType);	}	/**	 * Get cell at a specific coordinate	 *	 * @param	string			$pCoordinate	Coordinate of the cell	 * @throws	Exception	 * @return	PHPExcel_Cell	Cell that was found	 */	public function getCell($pCoordinate = 'A1')	{		// Check cell collection		if ($this->_cellCollection->isDataSet($pCoordinate)) {			return $this->_cellCollection->getCacheData($pCoordinate);		}		// Worksheet reference?		if (strpos($pCoordinate, '!') !== false) {			$worksheetReference = PHPExcel_Worksheet::extractSheetTitle($pCoordinate, true);			return $this->getParent()->getSheetByName($worksheetReference[0])->getCell($worksheetReference[1]);		}		// Named range?		if ((!preg_match('/^'.PHPExcel_Calculation::CALCULATION_REGEXP_CELLREF.'$/i', $pCoordinate, $matches)) &&			(preg_match('/^'.PHPExcel_Calculation::CALCULATION_REGEXP_NAMEDRANGE.'$/i', $pCoordinate, $matches))) {			$namedRange = PHPExcel_NamedRange::resolveRange($pCoordinate, $this);			if (!is_null($namedRange)) {				$pCoordinate = $namedRange->getRange();				return $namedRange->getWorksheet()->getCell($pCoordinate);			}		}		// Uppercase coordinate		$pCoordinate = strtoupper($pCoordinate);		if (strpos($pCoordinate,':') !== false || strpos($pCoordinate,',') !== false) {			throw new Exception('Cell coordinate can not be a range of cells.');		} elseif (strpos($pCoordinate,'$') !== false) {			throw new Exception('Cell coordinate must not be absolute.');		} else {			// Create new cell object			// Coordinates			$aCoordinates = PHPExcel_Cell::coordinateFromString($pCoordinate);			$cell = $this->_cellCollection->addCacheData($pCoordinate,new PHPExcel_Cell($aCoordinates[0], $aCoordinates[1], null, PHPExcel_Cell_DataType::TYPE_NULL, $this));			$this->_cellCollectionIsSorted = false;			if (PHPExcel_Cell::columnIndexFromString($this->_cachedHighestColumn) < PHPExcel_Cell::columnIndexFromString($aCoordinates[0]))				$this->_cachedHighestColumn = $aCoordinates[0];			$this->_cachedHighestRow = max($this->_cachedHighestRow,$aCoordinates[1]);			// Cell needs appropriate xfIndex			$rowDimensions	= $this->getRowDimensions();			$columnDimensions = $this->getColumnDimensions();			if ( isset($rowDimensions[$aCoordinates[1]]) && $rowDimensions[$aCoordinates[1]]->getXfIndex() !== null ) {				// then there is a row dimension with explicit style, assign it to the cell				$cell->setXfIndex($rowDimensions[$aCoordinates[1]]->getXfIndex());			} else if ( isset($columnDimensions[$aCoordinates[0]]) ) {				// then there is a column dimension, assign it to the cell				$cell->setXfIndex($columnDimensions[$aCoordinates[0]]->getXfIndex());			} else {				// set to default index				$cell->setXfIndex(0);			}			return $cell;		}	}	/**	 * Get cell at a specific coordinate by using numeric cell coordinates	 *	 * @param	string $pColumn		Numeric column coordinate of the cell	 * @param	string $pRow		Numeric row coordinate of the cell	 * @return	PHPExcel_Cell		Cell that was found	 */	public function getCellByColumnAndRow($pColumn = 0, $pRow = 1)	{		$columnLetter = PHPExcel_Cell::stringFromColumnIndex($pColumn);		$coordinate = $columnLetter . $pRow;		if (!$this->_cellCollection->isDataSet($coordinate)) {			$cell = $this->_cellCollection->addCacheData($coordinate, new PHPExcel_Cell($columnLetter, $pRow, null, PHPExcel_Cell_DataType::TYPE_NULL, $this));			$this->_cellCollectionIsSorted = false;			if (PHPExcel_Cell::columnIndexFromString($this->_cachedHighestColumn) < $pColumn)				$this->_cachedHighestColumn = $columnLetter;			$this->_cachedHighestRow = max($this->_cachedHighestRow,$pRow);			return $cell;		}		return $this->_cellCollection->getCacheData($coordinate);	}	/**	 * Cell at a specific coordinate exists?	 *	 * @param	string			$pCoordinate	Coordinate of the cell	 * @throws	Exception	 * @return	boolean	 */	public function cellExists($pCoordinate = 'A1')	{		// Worksheet reference?		if (strpos($pCoordinate, '!') !== false) {			$worksheetReference = PHPExcel_Worksheet::extractSheetTitle($pCoordinate, true);			return $this->getParent()->getSheetByName($worksheetReference[0])->cellExists($worksheetReference[1]);		}		// Named range?		if ((!preg_match('/^'.PHPExcel_Calculation::CALCULATION_REGEXP_CELLREF.'$/i', $pCoordinate, $matches)) &&			(preg_match('/^'.PHPExcel_Calculation::CALCULATION_REGEXP_NAMEDRANGE.'$/i', $pCoordinate, $matches))) {			$namedRange = PHPExcel_NamedRange::resolveRange($pCoordinate, $this);			if (!is_null($namedRange)) {				$pCoordinate = $namedRange->getRange();				if ($this->getHashCode() != $namedRange->getWorksheet()->getHashCode()) {					if (!$namedRange->getLocalOnly()) {						return $namedRange->getWorksheet()->cellExists($pCoordinate);					} else {						throw new Exception('Named range ' . $namedRange->getName() . ' is not accessible from within sheet ' . $this->getTitle());					}				}			}		}		// Uppercase coordinate		$pCoordinate = strtoupper($pCoordinate);		if (strpos($pCoordinate,':') !== false || strpos($pCoordinate,',') !== false) {			throw new Exception('Cell coordinate can not be a range of cells.');		} elseif (strpos($pCoordinate,'$') !== false) {			throw new Exception('Cell coordinate must not be absolute.');		} else {			// Coordinates			$aCoordinates = PHPExcel_Cell::coordinateFromString($pCoordinate);			// Cell exists?			return $this->_cellCollection->isDataSet($pCoordinate);		}	}	/**	 * Cell at a specific coordinate by using numeric cell coordinates exists?	 *	 * @param	string $pColumn		Numeric column coordinate of the cell	 * @param	string $pRow		Numeric row coordinate of the cell	 * @return	boolean	 */	public function cellExistsByColumnAndRow($pColumn = 0, $pRow = 1)	{		return $this->cellExists(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);	}	/**	 * Get row dimension at a specific row	 *	 * @param int $pRow	Numeric index of the row	 * @return PHPExcel_Worksheet_RowDimension	 */	public function getRowDimension($pRow = 1)	{		// Found		$found = null;		// Get row dimension		if (!isset($this->_rowDimensions[$pRow])) {			$this->_rowDimensions[$pRow] = new PHPExcel_Worksheet_RowDimension($pRow);			$this->_cachedHighestRow = max($this->_cachedHighestRow,$pRow);		}		return $this->_rowDimensions[$pRow];	}	/**	 * Get column dimension at a specific column	 *	 * @param string $pColumn	String index of the column	 * @return PHPExcel_Worksheet_ColumnDimension	 */	public function getColumnDimension($pColumn = 'A')	{		// Uppercase coordinate		$pColumn = strtoupper($pColumn);		// Fetch dimensions		if (!isset($this->_columnDimensions[$pColumn])) {			$this->_columnDimensions[$pColumn] = new PHPExcel_Worksheet_ColumnDimension($pColumn);			if (PHPExcel_Cell::columnIndexFromString($this->_cachedHighestColumn) < PHPExcel_Cell::columnIndexFromString($pColumn))				$this->_cachedHighestColumn = $pColumn;		}		return $this->_columnDimensions[$pColumn];	}	/**	 * Get column dimension at a specific column by using numeric cell coordinates	 *	 * @param	string $pColumn		Numeric column coordinate of the cell	 * @param	string $pRow		Numeric row coordinate of the cell	 * @return	PHPExcel_Worksheet_ColumnDimension	 */	public function getColumnDimensionByColumn($pColumn = 0)	{		return $this->getColumnDimension(PHPExcel_Cell::stringFromColumnIndex($pColumn));	}	/**	 * Get styles	 *	 * @return PHPExcel_Style[]	 */	public function getStyles()	{		return $this->_styles;	}	/**	 * Get default style of workbork.	 *	 * @deprecated	 * @return	PHPExcel_Style	 * @throws	Exception	 */	public function getDefaultStyle()	{		return $this->_parent->getDefaultStyle();	}	/**	 * Set default style - should only be used by PHPExcel_IReader implementations!	 *	 * @deprecated	 * @param	PHPExcel_Style $value	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setDefaultStyle(PHPExcel_Style $pValue)	{		$this->_parent->getDefaultStyle()->applyFromArray(array(			'font' => array(				'name' => $pValue->getFont()->getName(),				'size' => $pValue->getFont()->getSize(),			),		));		return $this;	}	/**	 * Get style for cell	 *	 * @param	string	$pCellCoordinate	Cell coordinate to get style for	 * @return	PHPExcel_Style	 * @throws	Exception	 */	public function getStyle($pCellCoordinate = 'A1')	{		// set this sheet as active		$this->_parent->setActiveSheetIndex($this->_parent->getIndex($this));		// set cell coordinate as active		$this->setSelectedCells($pCellCoordinate);		return $this->_parent->getCellXfSupervisor();	}	/**	 * Get conditional styles for a cell	 *	 * @param string $pCoordinate	 * @return PHPExcel_Style_Conditional[]	 */	public function getConditionalStyles($pCoordinate = 'A1')	{		if (!isset($this->_conditionalStylesCollection[$pCoordinate])) {			$this->_conditionalStylesCollection[$pCoordinate] = array();		}		return $this->_conditionalStylesCollection[$pCoordinate];	}	/**	 * Do conditional styles exist for this cell?	 *	 * @param string $pCoordinate	 * @return boolean	 */	public function conditionalStylesExists($pCoordinate = 'A1')	{		if (isset($this->_conditionalStylesCollection[$pCoordinate])) {			return true;		}		return false;	}	/**	 * Removes conditional styles for a cell	 *	 * @param string $pCoordinate	 * @return PHPExcel_Worksheet	 */	public function removeConditionalStyles($pCoordinate = 'A1')	{		unset($this->_conditionalStylesCollection[$pCoordinate]);		return $this;	}	/**	 * Get collection of conditional styles	 *	 * @return array	 */	public function getConditionalStylesCollection()	{		return $this->_conditionalStylesCollection;	}	/**	 * Set conditional styles	 *	 * @param $pCoordinate string E.g. 'A1'	 * @param $pValue PHPExcel_Style_Conditional[]	 * @return PHPExcel_Worksheet	 */	public function setConditionalStyles($pCoordinate = 'A1', $pValue)	{		$this->_conditionalStylesCollection[$pCoordinate] = $pValue;		return $this;	}	/**	 * Get style for cell by using numeric cell coordinates	 *	 * @param	int $pColumn	Numeric column coordinate of the cell	 * @param	int $pRow		Numeric row coordinate of the cell	 * @return	PHPExcel_Style	 */	public function getStyleByColumnAndRow($pColumn = 0, $pRow = 1)	{		return $this->getStyle(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);	}	/**	 * Set shared cell style to a range of cells	 *	 * Please note that this will overwrite existing cell styles for cells in range!	 *	 * @deprecated	 * @param	PHPExcel_Style	$pSharedCellStyle	Cell style to share	 * @param	string			$pRange				Range of cells (i.e. "A1:B10"), or just one cell (i.e. "A1")	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	 public function setSharedStyle(PHPExcel_Style $pSharedCellStyle = null, $pRange = '')	{		$this->duplicateStyle($pSharedCellStyle, $pRange);		return $this;	}	/**	 * Duplicate cell style to a range of cells	 *	 * Please note that this will overwrite existing cell styles for cells in range!	 *	 * @param	PHPExcel_Style	$pCellStyle	Cell style to duplicate	 * @param	string			$pRange		Range of cells (i.e. "A1:B10"), or just one cell (i.e. "A1")	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function duplicateStyle(PHPExcel_Style $pCellStyle = null, $pRange = '')	{		// make sure we have a real style and not supervisor		$style = $pCellStyle->getIsSupervisor() ? $pCellStyle->getSharedComponent() : $pCellStyle;		// Add the style to the workbook if necessary		$workbook = $this->_parent;		if ($existingStyle = $this->_parent->getCellXfByHashCode($pCellStyle->getHashCode())) {			// there is already such cell Xf in our collection			$xfIndex = $existingStyle->getIndex();		} else {			// we don't have such a cell Xf, need to add			$workbook->addCellXf($pCellStyle);			$xfIndex = $pCellStyle->getIndex();		}		// Uppercase coordinate		$pRange = strtoupper($pRange);		// Is it a cell range or a single cell?		$rangeA	= '';		$rangeB	= '';		if (strpos($pRange, ':') === false) {			$rangeA = $pRange;			$rangeB = $pRange;		} else {			list($rangeA, $rangeB) = explode(':', $pRange);		}		// Calculate range outer borders		$rangeStart = PHPExcel_Cell::coordinateFromString($rangeA);		$rangeEnd	= PHPExcel_Cell::coordinateFromString($rangeB);		// Translate column into index		$rangeStart[0]	= PHPExcel_Cell::columnIndexFromString($rangeStart[0]) - 1;		$rangeEnd[0]	= PHPExcel_Cell::columnIndexFromString($rangeEnd[0]) - 1;		// Make sure we can loop upwards on rows and columns		if ($rangeStart[0] > $rangeEnd[0] && $rangeStart[1] > $rangeEnd[1]) {			$tmp = $rangeStart;			$rangeStart = $rangeEnd;			$rangeEnd = $tmp;		}		// Loop through cells and apply styles		for ($col = $rangeStart[0]; $col <= $rangeEnd[0]; ++$col) {			for ($row = $rangeStart[1]; $row <= $rangeEnd[1]; ++$row) {				$this->getCell(PHPExcel_Cell::stringFromColumnIndex($col) . $row)->setXfIndex($xfIndex);			}		}		return $this;	}	/**	 * Duplicate cell style array to a range of cells	 *	 * Please note that this will overwrite existing cell styles for cells in range,	 * if they are in the styles array. For example, if you decide to set a range of	 * cells to font bold, only include font bold in the styles array.	 *	 * @deprecated	 * @param	array			$pStyles	Array containing style information	 * @param	string			$pRange		Range of cells (i.e. "A1:B10"), or just one cell (i.e. "A1")	 * @param	boolean			$pAdvanced	Advanced mode for setting borders.	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function duplicateStyleArray($pStyles = null, $pRange = '', $pAdvanced = true)	{		$this->getStyle($pRange)->applyFromArray($pStyles, $pAdvanced);		return $this;	}	/**	 * Set break on a cell	 *	 * @param	string			$pCell		Cell coordinate (e.g. A1)	 * @param	int				$pBreak		Break type (type of PHPExcel_Worksheet::BREAK_*)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setBreak($pCell = 'A1', $pBreak = PHPExcel_Worksheet::BREAK_NONE)	{		// Uppercase coordinate		$pCell = strtoupper($pCell);		if ($pCell != '') {			$this->_breaks[$pCell] = $pBreak;		} else {			throw new Exception('No cell coordinate specified.');		}		return $this;	}	/**	 * Set break on a cell by using numeric cell coordinates	 *	 * @param	integer	$pColumn	Numeric column coordinate of the cell	 * @param	integer	$pRow		Numeric row coordinate of the cell	 * @param	integer	$pBreak		Break type (type of PHPExcel_Worksheet::BREAK_*)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setBreakByColumnAndRow($pColumn = 0, $pRow = 1, $pBreak = PHPExcel_Worksheet::BREAK_NONE)	{		return $this->setBreak(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow, $pBreak);	}	/**	 * Get breaks	 *	 * @return array[]	 */	public function getBreaks()	{		return $this->_breaks;	}	/**	 * Set merge on a cell range	 *	 * @param	string			$pRange		Cell range (e.g. A1:E1)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function mergeCells($pRange = 'A1:A1')	{		// Uppercase coordinate		$pRange = strtoupper($pRange);		if (strpos($pRange,':') !== false) {			$this->_mergeCells[$pRange] = $pRange;			// make sure cells are created			// get the cells in the range			$aReferences = PHPExcel_Cell::extractAllCellReferencesInRange($pRange);			// create upper left cell if it does not already exist			$upperLeft = $aReferences[0];			if (!$this->cellExists($upperLeft)) {				$this->getCell($upperLeft)->setValueExplicit(null, PHPExcel_Cell_DataType::TYPE_NULL);			}			// create or blank out the rest of the cells in the range			$count = count($aReferences);			for ($i = 1; $i < $count; $i++) {				$this->getCell($aReferences[$i])->setValueExplicit(null, PHPExcel_Cell_DataType::TYPE_NULL);			}		} else {			throw new Exception('Merge must be set on a range of cells.');		}		return $this;	}	/**	 * Set merge on a cell range by using numeric cell coordinates	 *	 * @param	int $pColumn1	Numeric column coordinate of the first cell	 * @param	int $pRow1		Numeric row coordinate of the first cell	 * @param	int $pColumn2	Numeric column coordinate of the last cell	 * @param	int $pRow2		Numeric row coordinate of the last cell	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function mergeCellsByColumnAndRow($pColumn1 = 0, $pRow1 = 1, $pColumn2 = 0, $pRow2 = 1)	{		$cellRange = PHPExcel_Cell::stringFromColumnIndex($pColumn1) . $pRow1 . ':' . PHPExcel_Cell::stringFromColumnIndex($pColumn2) . $pRow2;		return $this->mergeCells($cellRange);	}	/**	 * Remove merge on a cell range	 *	 * @param	string			$pRange		Cell range (e.g. A1:E1)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function unmergeCells($pRange = 'A1:A1')	{		// Uppercase coordinate		$pRange = strtoupper($pRange);		if (strpos($pRange,':') !== false) {			if (isset($this->_mergeCells[$pRange])) {				unset($this->_mergeCells[$pRange]);			} else {				throw new Exception('Cell range ' . $pRange . ' not known as merged.');			}		} else {			throw new Exception('Merge can only be removed from a range of cells.');		}		return $this;	}	/**	 * Remove merge on a cell range by using numeric cell coordinates	 *	 * @param	int $pColumn1	Numeric column coordinate of the first cell	 * @param	int $pRow1		Numeric row coordinate of the first cell	 * @param	int $pColumn2	Numeric column coordinate of the last cell	 * @param	int $pRow2		Numeric row coordinate of the last cell	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function unmergeCellsByColumnAndRow($pColumn1 = 0, $pRow1 = 1, $pColumn2 = 0, $pRow2 = 1)	{		$cellRange = PHPExcel_Cell::stringFromColumnIndex($pColumn1) . $pRow1 . ':' . PHPExcel_Cell::stringFromColumnIndex($pColumn2) . $pRow2;		return $this->unmergeCells($cellRange);	}	/**	 * Get merge cells array.	 *	 * @return array[]	 */	public function getMergeCells()	{		return $this->_mergeCells;	}	/**	 * Set merge cells array for the entire sheet. Use instead mergeCells() to merge	 * a single cell range.	 *	 * @param array	 */	public function setMergeCells($pValue = array())	{		$this->_mergeCells = $pValue;		return $this;	}	/**	 * Set protection on a cell range	 *	 * @param	string			$pRange				Cell (e.g. A1) or cell range (e.g. A1:E1)	 * @param	string			$pPassword			Password to unlock the protection	 * @param	boolean		$pAlreadyHashed	If the password has already been hashed, set this to true	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function protectCells($pRange = 'A1', $pPassword = '', $pAlreadyHashed = false)	{		// Uppercase coordinate		$pRange = strtoupper($pRange);		if (!$pAlreadyHashed) {			$pPassword = PHPExcel_Shared_PasswordHasher::hashPassword($pPassword);		}		$this->_protectedCells[$pRange] = $pPassword;		return $this;	}	/**	 * Set protection on a cell range by using numeric cell coordinates	 *	 * @param	int	$pColumn1			Numeric column coordinate of the first cell	 * @param	int	$pRow1				Numeric row coordinate of the first cell	 * @param	int	$pColumn2			Numeric column coordinate of the last cell	 * @param	int	$pRow2				Numeric row coordinate of the last cell	 * @param	string	$pPassword			Password to unlock the protection	 * @param	boolean $pAlreadyHashed	If the password has already been hashed, set this to true	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function protectCellsByColumnAndRow($pColumn1 = 0, $pRow1 = 1, $pColumn2 = 0, $pRow2 = 1, $pPassword = '', $pAlreadyHashed = false)	{		$cellRange = PHPExcel_Cell::stringFromColumnIndex($pColumn1) . $pRow1 . ':' . PHPExcel_Cell::stringFromColumnIndex($pColumn2) . $pRow2;		return $this->protectCells($cellRange, $pPassword, $pAlreadyHashed);	}	/**	 * Remove protection on a cell range	 *	 * @param	string			$pRange		Cell (e.g. A1) or cell range (e.g. A1:E1)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function unprotectCells($pRange = 'A1')	{		// Uppercase coordinate		$pRange = strtoupper($pRange);		if (isset($this->_protectedCells[$pRange])) {			unset($this->_protectedCells[$pRange]);		} else {			throw new Exception('Cell range ' . $pRange . ' not known as protected.');		}		return $this;	}	/**	 * Remove protection on a cell range by using numeric cell coordinates	 *	 * @param	int	$pColumn1			Numeric column coordinate of the first cell	 * @param	int	$pRow1				Numeric row coordinate of the first cell	 * @param	int	$pColumn2			Numeric column coordinate of the last cell	 * @param	int	$pRow2				Numeric row coordinate of the last cell	 * @param	string	$pPassword			Password to unlock the protection	 * @param	boolean $pAlreadyHashed	If the password has already been hashed, set this to true	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function unprotectCellsByColumnAndRow($pColumn1 = 0, $pRow1 = 1, $pColumn2 = 0, $pRow2 = 1, $pPassword = '', $pAlreadyHashed = false)	{		$cellRange = PHPExcel_Cell::stringFromColumnIndex($pColumn1) . $pRow1 . ':' . PHPExcel_Cell::stringFromColumnIndex($pColumn2) . $pRow2;		return $this->unprotectCells($cellRange, $pPassword, $pAlreadyHashed);	}	/**	 * Get protected cells	 *	 * @return array[]	 */	public function getProtectedCells()	{		return $this->_protectedCells;	}	/**	 * Get Autofilter Range	 *	 * @return string	 */	public function getAutoFilter()	{		return $this->_autoFilter;	}	/**	 * Set Autofilter Range	 *	 * @param	string		$pRange		Cell range (i.e. A1:E10)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setAutoFilter($pRange = '')	{		// Uppercase coordinate		$pRange = strtoupper($pRange);		if (strpos($pRange,':') !== false) {			$this->_autoFilter = $pRange;			$this->_dirty = true;		} else {			throw new Exception('Autofilter must be set on a range of cells.');		}		return $this;	}	/**	 * Set Autofilter Range by using numeric cell coordinates	 *	 * @param	int	$pColumn1	Numeric column coordinate of the first cell	 * @param	int	$pRow1		Numeric row coordinate of the first cell	 * @param	int	$pColumn2	Numeric column coordinate of the second cell	 * @param	int	$pRow2		Numeric row coordinate of the second cell	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setAutoFilterByColumnAndRow($pColumn1 = 0, $pRow1 = 1, $pColumn2 = 0, $pRow2 = 1)	{		return $this->setAutoFilter(			PHPExcel_Cell::stringFromColumnIndex($pColumn1) . $pRow1			. ':' .			PHPExcel_Cell::stringFromColumnIndex($pColumn2) . $pRow2		);	}    /**     * Remove autofilter     *     * @return PHPExcel_Worksheet     */    public function removeAutoFilter()    {    	$this->_autoFilter = '';    	return $this;    }	/**	 * Get Freeze Pane	 *	 * @return string	 */	public function getFreezePane()	{		return $this->_freezePane;	}	/**	 * Freeze Pane	 *	 * @param	string		$pCell		Cell (i.e. A1)	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function freezePane($pCell = '')	{		// Uppercase coordinate		$pCell = strtoupper($pCell);		if (strpos($pCell,':') === false && strpos($pCell,',') === false) {			$this->_freezePane = $pCell;		} else {			throw new Exception('Freeze pane can not be set on a range of cells.');		}		return $this;	}	/**	 * Freeze Pane by using numeric cell coordinates	 *	 * @param	int	$pColumn	Numeric column coordinate of the cell	 * @param	int	$pRow		Numeric row coordinate of the cell	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function freezePaneByColumnAndRow($pColumn = 0, $pRow = 1)	{		return $this->freezePane(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);	}	/**	 * Unfreeze Pane	 *	 * @return PHPExcel_Worksheet	 */	public function unfreezePane()	{		return $this->freezePane('');	}	/**	 * Insert a new row, updating all possible related data	 *	 * @param	int	$pBefore	Insert before this one	 * @param	int	$pNumRows	Number of rows to insert	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function insertNewRowBefore($pBefore = 1, $pNumRows = 1) {		if ($pBefore >= 1) {			$objReferenceHelper = PHPExcel_ReferenceHelper::getInstance();			$objReferenceHelper->insertNewBefore('A' . $pBefore, 0, $pNumRows, $this);		} else {			throw new Exception("Rows can only be inserted before at least row 1.");		}		return $this;	}	/**	 * Insert a new column, updating all possible related data	 *	 * @param	int	$pBefore	Insert before this one	 * @param	int	$pNumCols	Number of columns to insert	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function insertNewColumnBefore($pBefore = 'A', $pNumCols = 1) {		if (!is_numeric($pBefore)) {			$objReferenceHelper = PHPExcel_ReferenceHelper::getInstance();			$objReferenceHelper->insertNewBefore($pBefore . '1', $pNumCols, 0, $this);		} else {			throw new Exception("Column references should not be numeric.");		}		return $this;	}	/**	 * Insert a new column, updating all possible related data	 *	 * @param	int	$pBefore	Insert before this one (numeric column coordinate of the cell)	 * @param	int	$pNumCols	Number of columns to insert	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function insertNewColumnBeforeByIndex($pBefore = 0, $pNumCols = 1) {		if ($pBefore >= 0) {			return $this->insertNewColumnBefore(PHPExcel_Cell::stringFromColumnIndex($pBefore), $pNumCols);		} else {			throw new Exception("Columns can only be inserted before at least column A (0).");		}	}	/**	 * Delete a row, updating all possible related data	 *	 * @param	int	$pRow		Remove starting with this one	 * @param	int	$pNumRows	Number of rows to remove	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function removeRow($pRow = 1, $pNumRows = 1) {		if ($pRow >= 1) {			$objReferenceHelper = PHPExcel_ReferenceHelper::getInstance();			$objReferenceHelper->insertNewBefore('A' . ($pRow + $pNumRows), 0, -$pNumRows, $this);		} else {			throw new Exception("Rows to be deleted should at least start from row 1.");		}		return $this;	}	/**	 * Remove a column, updating all possible related data	 *	 * @param	int	$pColumn	Remove starting with this one	 * @param	int	$pNumCols	Number of columns to remove	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function removeColumn($pColumn = 'A', $pNumCols = 1) {		if (!is_numeric($pColumn)) {			$pColumn = PHPExcel_Cell::stringFromColumnIndex(PHPExcel_Cell::columnIndexFromString($pColumn) - 1 + $pNumCols);			$objReferenceHelper = PHPExcel_ReferenceHelper::getInstance();			$objReferenceHelper->insertNewBefore($pColumn . '1', -$pNumCols, 0, $this);		} else {			throw new Exception("Column references should not be numeric.");		}		return $this;	}	/**	 * Remove a column, updating all possible related data	 *	 * @param	int	$pColumn	Remove starting with this one (numeric column coordinate of the cell)	 * @param	int	$pNumCols	Number of columns to remove	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function removeColumnByIndex($pColumn = 0, $pNumCols = 1) {		if ($pColumn >= 0) {			return $this->removeColumn(PHPExcel_Cell::stringFromColumnIndex($pColumn), $pNumCols);		} else {			throw new Exception("Columns to be deleted should at least start from column 0");		}	}	/**	 * Show gridlines?	 *	 * @return boolean	 */	public function getShowGridlines() {		return $this->_showGridlines;	}	/**	 * Set show gridlines	 *	 * @param boolean $pValue	Show gridlines (true/false)	 * @return PHPExcel_Worksheet	 */	public function setShowGridlines($pValue = false) {		$this->_showGridlines = $pValue;		return $this;	}	/**	* Print gridlines?	*	* @return boolean	*/	public function getPrintGridlines() {		return $this->_printGridlines;	}	/**	* Set print gridlines	*	* @param boolean $pValue Print gridlines (true/false)	* @return PHPExcel_Worksheet	*/	public function setPrintGridlines($pValue = false) {		$this->_printGridlines = $pValue;		return $this;	}	/**	* Show row and column headers?	*	* @return boolean	*/	public function getShowRowColHeaders() {		return $this->_showRowColHeaders;	}	/**	* Set show row and column headers	*	* @param boolean $pValue Show row and column headers (true/false)	* @return PHPExcel_Worksheet	*/	public function setShowRowColHeaders($pValue = false) {		$this->_showRowColHeaders = $pValue;		return $this;	}	/**	 * Show summary below? (Row/Column outlining)	 *	 * @return boolean	 */	public function getShowSummaryBelow() {		return $this->_showSummaryBelow;	}	/**	 * Set show summary below	 *	 * @param boolean $pValue	Show summary below (true/false)	 * @return PHPExcel_Worksheet	 */	public function setShowSummaryBelow($pValue = true) {		$this->_showSummaryBelow = $pValue;		return $this;	}	/**	 * Show summary right? (Row/Column outlining)	 *	 * @return boolean	 */	public function getShowSummaryRight() {		return $this->_showSummaryRight;	}	/**	 * Set show summary right	 *	 * @param boolean $pValue	Show summary right (true/false)	 * @return PHPExcel_Worksheet	 */	public function setShowSummaryRight($pValue = true) {		$this->_showSummaryRight = $pValue;		return $this;	}	/**	 * Get comments	 *	 * @return PHPExcel_Comment[]	 */	public function getComments()	{		return $this->_comments;	}	/**	 * Set comments array for the entire sheet.	 *	 * @param array of PHPExcel_Comment	 * @return PHPExcel_Worksheet	 */	public function setComments($pValue = array())	{		$this->_comments = $pValue;		return $this;	}	/**	 * Get comment for cell	 *	 * @param	string	$pCellCoordinate	Cell coordinate to get comment for	 * @return	PHPExcel_Comment	 * @throws	Exception	 */	public function getComment($pCellCoordinate = 'A1')	{		// Uppercase coordinate		$pCellCoordinate = strtoupper($pCellCoordinate);		if (strpos($pCellCoordinate,':') !== false || strpos($pCellCoordinate,',') !== false) {			throw new Exception('Cell coordinate string can not be a range of cells.');		} else if (strpos($pCellCoordinate,'$') !== false) {			throw new Exception('Cell coordinate string must not be absolute.');		} else if ($pCellCoordinate == '') {			throw new Exception('Cell coordinate can not be zero-length string.');		} else {			// Check if we already have a comment for this cell.			// If not, create a new comment.			if (isset($this->_comments[$pCellCoordinate])) {				return $this->_comments[$pCellCoordinate];			} else {				$newComment = new PHPExcel_Comment();				$this->_comments[$pCellCoordinate] = $newComment;				return $newComment;			}		}	}	/**	 * Get comment for cell by using numeric cell coordinates	 *	 * @param	int $pColumn	Numeric column coordinate of the cell	 * @param	int $pRow		Numeric row coordinate of the cell	 * @return	PHPExcel_Comment	 */	public function getCommentByColumnAndRow($pColumn = 0, $pRow = 1)	{		return $this->getComment(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);	}	/**	 * Get selected cell	 *	 * @deprecated	 * @return string	 */	public function getSelectedCell()	{		return $this->getSelectedCells();	}	/**	 * Get active cell	 *	 * @return string Example: 'A1'	 */	public function getActiveCell()	{		return $this->_activeCell;	}	/**	 * Get selected cells	 *	 * @return string	 */	public function getSelectedCells()	{		return $this->_selectedCells;	}	/**	 * Selected cell	 *	 * @param	string		$pCell		Cell (i.e. A1)	 * @return PHPExcel_Worksheet	 */	public function setSelectedCell($pCoordinate = 'A1')	{		return $this->setSelectedCells($pCoordinate);	}	/**	 * Select a range of cells.	 *	 * @param	string		$pCoordinate	Cell range, examples: 'A1', 'B2:G5', 'A:C', '3:6'	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setSelectedCells($pCoordinate = 'A1')	{		// Uppercase coordinate		$pCoordinate = strtoupper($pCoordinate);		// Convert 'A' to 'A:A'		$pCoordinate = preg_replace('/^([A-Z]+)$/', '${1}:${1}', $pCoordinate);		// Convert '1' to '1:1'		$pCoordinate = preg_replace('/^([0-9]+)$/', '${1}:${1}', $pCoordinate);		// Convert 'A:C' to 'A1:C1048576'		$pCoordinate = preg_replace('/^([A-Z]+):([A-Z]+)$/', '${1}1:${2}1048576', $pCoordinate);		// Convert '1:3' to 'A1:XFD3'		$pCoordinate = preg_replace('/^([0-9]+):([0-9]+)$/', 'A${1}:XFD${2}', $pCoordinate);		if (strpos($pCoordinate,':') !== false || strpos($pCoordinate,',') !== false) {			list($first, ) = PHPExcel_Cell::splitRange($pCoordinate);			$this->_activeCell = $first[0];		} else {			$this->_activeCell = $pCoordinate;		}		$this->_selectedCells = $pCoordinate;		return $this;	}	/**	 * Selected cell by using numeric cell coordinates	 *	 * @param	int	$pColumn	Numeric column coordinate of the cell	 * @param	int	$pRow		Numeric row coordinate of the cell	 * @throws	Exception	 * @return PHPExcel_Worksheet	 */	public function setSelectedCellByColumnAndRow($pColumn = 0, $pRow = 1)	{		return $this->setSelectedCells(PHPExcel_Cell::stringFromColumnIndex($pColumn) . $pRow);	}	/**	 * Get right-to-left	 *	 * @return boolean	 */	public function getRightToLeft() {		return $this->_rightToLeft;	}	/**	 * Set right-to-left	 *	 * @param	boolean	$value	Right-to-left true/false	 * @return PHPExcel_Worksheet	 */	public function setRightToLeft($value = false) {		$this->_rightToLeft = $value;		return $this;	}	/**	 * Fill worksheet from values in array	 *	 * @param	array	$source					Source array	 * @param	mixed	$nullValue				Value in source array that stands for blank cell	 * @param	string	$startCell				Insert array starting from this cell address as the top left coordinate	 * @param	boolean	$strictNullComparison	Apply strict comparison when testing for null values in the array	 * @throws Exception	 * @return PHPExcel_Worksheet	 */	public function fromArray($source = null, $nullValue = null, $startCell = 'A1', $strictNullComparison = false) {		if (is_array($source)) {			//	Convert a 1-D array to 2-D (for ease of looping)			if (!is_array(end($source))) {				$source = array($source);			}			// start coordinate			list ($startColumn, $startRow) = PHPExcel_Cell::coordinateFromString($startCell);			// Loop through $source			foreach ($source as $rowData) {				$currentColumn = $startColumn;				foreach($rowData as $cellValue) {					if ($strictNullComparison) {						if ($cellValue !== $nullValue) {							// Set cell value							$this->getCell($currentColumn . $startRow)->setValue($cellValue);						}					} else {						if ($cellValue != $nullValue) {							// Set cell value							$this->getCell($currentColumn . $startRow)->setValue($cellValue);						}					}					++$currentColumn;				}				++$startRow;			}		} else {			throw new Exception("Parameter \$source should be an array.");		}		return $this;	}	/**	 * Create array from a range of cells	 *	 * @param	string	$pRange					Range of cells (i.e. "A1:B10"), or just one cell (i.e. "A1")	 * @param	mixed	$nullValue				Value returned in the array entry if a cell doesn't exist	 * @param	boolean	$calculateFormulas		Should formulas be calculated?	 * @param	boolean	$formatData				Should formatting be applied to cell values?	 * @param	boolean	$returnCellRef			False - Return a simple array of rows and columns indexed by number counting from zero	 *											True - Return rows and columns indexed by their actual row and column IDs	 * @return array	 */	public function rangeToArray($pRange = 'A1', $nullValue = null, $calculateFormulas = true, $formatData = true, $returnCellRef = false) {		// Returnvalue		$returnValue = array();		//	Identify the range that we need to extract from the worksheet		list($rangeStart, $rangeEnd) = PHPExcel_Cell::rangeBoundaries($pRange);		$minCol = PHPExcel_Cell::stringFromColumnIndex($rangeStart[0] -1);		$minRow = $rangeStart[1];		$maxCol = PHPExcel_Cell::stringFromColumnIndex($rangeEnd[0] -1);		$maxRow = $rangeEnd[1];		$maxCol++;		// Loop through rows		for ($row = $minRow; $row <= $maxRow; ++$row) {			$c = -1;			// Loop through columns in the current row			for ($col = $minCol; $col != $maxCol; ++$col) {				$rRef = ($returnCellRef) ? $row : $row-1;				$cRef = ($returnCellRef) ? $col : ++$c;				//	Using getCell() will create a new cell if it doesn't already exist. We don't want that to happen				//		so we test and retrieve directly against _cellCollection				if ($this->_cellCollection->isDataSet($col.$row)) {					// Cell exists					$cell = $this->_cellCollection->getCacheData($col.$row);					if ($cell->getValue() !== null) {						if ($cell->getValue() instanceof PHPExcel_RichText) {							$returnValue[$rRef][$cRef] = $cell->getValue()->getPlainText();						} else {							if ($calculateFormulas) {								$returnValue[$rRef][$cRef] = $cell->getCalculatedValue();							} else {								$returnValue[$rRef][$cRef] = $cell->getValue();							}						}						if ($formatData) {							$style = $this->_parent->getCellXfByIndex($cell->getXfIndex());							$returnValue[$rRef][$cRef] = PHPExcel_Style_NumberFormat::toFormattedString($returnValue[$rRef][$cRef], $style->getNumberFormat()->getFormatCode());						}					} else {						// Cell holds a NULL						$returnValue[$rRef][$cRef] = $nullValue;					}				} else {					// Cell doesn't exist					$returnValue[$rRef][$cRef] = $nullValue;				}			}		}		// Return		return $returnValue;	}	/**	 * Create array from a range of cells	 *	 * @param	string	$pNamedRange			Name of the Named Range	 * @param	mixed	$nullValue				Value returned in the array entry if a cell doesn't exist	 * @param	boolean	$calculateFormulas		Should formulas be calculated?	 * @param	boolean	$formatData				Should formatting be applied to cell values?	 * @param	boolean	$returnCellRef			False - Return a simple array of rows and columns indexed by number counting from zero	 *											True - Return rows and columns indexed by their actual row and column IDs	 * @return array	 * @throws Exception	 */	public function namedRangeToArray($pNamedRange = '', $nullValue = null, $calculateFormulas = true, $formatData = true, $returnCellRef = false) {		$namedRange = PHPExcel_NamedRange::resolveRange($pNamedRange, $this);		if (!is_null($namedRange)) {			$pWorkSheet = $namedRange->getWorksheet();			$pCellRange = $namedRange->getRange();			return $pWorkSheet->rangeToArray(	$pCellRange,												$nullValue, $calculateFormulas, $formatData, $returnCellRef);		}		throw new Exception('Named Range '.$pNamedRange.' does not exist.');	}	/**	 * Create array from worksheet	 *	 * @param	mixed	$nullValue				Value returned in the array entry if a cell doesn't exist	 * @param	boolean	$calculateFormulas		Should formulas be calculated?	 * @param	boolean	$formatData				Should formatting be applied to cell values?	 * @param	boolean	$returnCellRef			False - Return a simple array of rows and columns indexed by number counting from zero	 *											True - Return rows and columns indexed by their actual row and column IDs	 * @return array	 */	public function toArray($nullValue = null, $calculateFormulas = true, $formatData = true, $returnCellRef = false) {		// Garbage collect...		$this->garbageCollect();		//	Identify the range that we need to extract from the worksheet		$maxCol = $this->getHighestColumn();		$maxRow = $this->getHighestRow();		// Return		return $this->rangeToArray(	'A1:'.$maxCol.$maxRow,									$nullValue, $calculateFormulas, $formatData, $returnCellRef);	}	/**	 * Get row iterator	 *	 * @return PHPExcel_Worksheet_RowIterator	 */	public function getRowIterator() {		return new PHPExcel_Worksheet_RowIterator($this);	}	/**	 * Run PHPExcel garabage collector.	 *	 * @return PHPExcel_Worksheet	 */	public function garbageCollect() {		// Build a reference table from images//		$imageCoordinates = array();//		$iterator = $this->getDrawingCollection()->getIterator();//		while ($iterator->valid()) {//			$imageCoordinates[$iterator->current()->getCoordinates()] = true;////			$iterator->next();//		}//		// Lookup highest column and highest row if cells are cleaned		$highestColumn = -1;		$highestRow	= 1;		// Find cells that can be cleaned		$col = $row = array();		foreach ($this->_cellCollection->getCellList() as $coord) {			list($c,$r) = sscanf($coord,'%[A-Z]%d');			$row[$r] = $r;			$col[$c] = strlen($c).$c;		}		if (count($row) > 0) {			// Determine highest column and row			$highestRow = max($row);			$highestColumn = PHPExcel_Cell::columnIndexFromString(substr(max($col),1));		}		// Loop through column dimensions		foreach ($this->_columnDimensions as $dimension) {			$highestColumn = max($highestColumn,PHPExcel_Cell::columnIndexFromString($dimension->getColumnIndex()));		}		// Loop through row dimensions		foreach ($this->_rowDimensions as $dimension) {			$highestRow = max($highestRow,$dimension->getRowIndex());		}		// Cache values		if ($highestColumn < 0) {			$this->_cachedHighestColumn = 'A';		} else {			$this->_cachedHighestColumn = PHPExcel_Cell::stringFromColumnIndex(--$highestColumn);		}		$this->_cachedHighestRow = $highestRow;		// Return		return $this;	}	/**	 * Get hash code	 *	 * @return string	Hash code	 */	public function getHashCode() {		if ($this->_dirty) {			$this->_hash = md5( $this->_title .								$this->_autoFilter .								($this->_protection->isProtectionEnabled() ? 't' : 'f') .								__CLASS__							  );			$this->_dirty = false;		}		return $this->_hash;	}	/**	 * Extract worksheet title from range.	 *	 * Example: extractSheetTitle("testSheet!A1") ==> 'A1'	 * Example: extractSheetTitle("'testSheet 1'!A1", true) ==> array('testSheet 1', 'A1');	 *	 * @param string $pRange	Range to extract title from	 * @param bool $returnRange	Return range? (see example)	 * @return mixed	 */	public static function extractSheetTitle($pRange, $returnRange = false) {		// Sheet title included?		if (($sep = strpos($pRange, '!')) === false) {			return '';		}		if ($returnRange) {			return array( trim(substr($pRange, 0, $sep),"'"),						  substr($pRange, $sep + 1)						);		}		return substr($pRange, $sep + 1);	}	/**	 * Get hyperlink	 *	 * @param string $pCellCoordinate	Cell coordinate to get hyperlink for	 */	public function getHyperlink($pCellCoordinate = 'A1')	{		// return hyperlink if we already have one		if (isset($this->_hyperlinkCollection[$pCellCoordinate])) {			return $this->_hyperlinkCollection[$pCellCoordinate];		}		// else create hyperlink		$this->_hyperlinkCollection[$pCellCoordinate] = new PHPExcel_Cell_Hyperlink();		return $this->_hyperlinkCollection[$pCellCoordinate];	}	/**	 * Set hyperlnk	 *	 * @param string $pCellCoordinate	Cell coordinate to insert hyperlink	 * @param	PHPExcel_Cell_Hyperlink	$pHyperlink	 * @return PHPExcel_Worksheet	 */	public function setHyperlink($pCellCoordinate = 'A1', PHPExcel_Cell_Hyperlink $pHyperlink = null)	{		if ($pHyperlink === null) {			unset($this->_hyperlinkCollection[$pCellCoordinate]);		} else {			$this->_hyperlinkCollection[$pCellCoordinate] = $pHyperlink;		}		return $this;	}	/**	 * Hyperlink at a specific coordinate exists?	 *	 * @param string $pCellCoordinate	 * @return boolean	 */	public function hyperlinkExists($pCoordinate = 'A1')	{		return isset($this->_hyperlinkCollection[$pCoordinate]);	}	/**	 * Get collection of hyperlinks	 *	 * @return PHPExcel_Cell_Hyperlink[]	 */	public function getHyperlinkCollection()	{		return $this->_hyperlinkCollection;	}	/**	 * Get data validation	 *	 * @param string $pCellCoordinate	Cell coordinate to get data validation for	 */	public function getDataValidation($pCellCoordinate = 'A1')	{		// return data validation if we already have one		if (isset($this->_dataValidationCollection[$pCellCoordinate])) {			return $this->_dataValidationCollection[$pCellCoordinate];		}		// else create data validation		$this->_dataValidationCollection[$pCellCoordinate] = new PHPExcel_Cell_DataValidation();		return $this->_dataValidationCollection[$pCellCoordinate];	}	/**	 * Set data validation	 *	 * @param string $pCellCoordinate	Cell coordinate to insert data validation	 * @param	PHPExcel_Cell_DataValidation	$pDataValidation	 * @return PHPExcel_Worksheet	 */	public function setDataValidation($pCellCoordinate = 'A1', PHPExcel_Cell_DataValidation $pDataValidation = null)	{		if ($pDataValidation === null) {			unset($this->_dataValidationCollection[$pCellCoordinate]);		} else {			$this->_dataValidationCollection[$pCellCoordinate] = $pDataValidation;		}		return $this;	}	/**	 * Data validation at a specific coordinate exists?	 *	 * @param string $pCellCoordinate	 * @return boolean	 */	public function dataValidationExists($pCoordinate = 'A1')	{		return isset($this->_dataValidationCollection[$pCoordinate]);	}	/**	 * Get collection of data validations	 *	 * @return PHPExcel_Cell_DataValidation[]	 */	public function getDataValidationCollection()	{		return $this->_dataValidationCollection;	}	/**	 * Accepts a range, returning it as a range that falls within the current highest row and column of the worksheet	 *	 * @param	string	$range	 * @return	string	Adjusted range value	 */	public function shrinkRangeToFit($range) {		$maxCol = $this->getHighestColumn();		$maxRow = $this->getHighestRow();		$maxCol = PHPExcel_Cell::columnIndexFromString($maxCol);		$rangeBlocks = explode(' ',$range);		foreach ($rangeBlocks as &$rangeSet) {			$rangeBoundaries = PHPExcel_Cell::getRangeBoundaries($rangeSet);			if (PHPExcel_Cell::columnIndexFromString($rangeBoundaries[0][0]) > $maxCol) { $rangeBoundaries[0][0] = PHPExcel_Cell::stringFromColumnIndex($maxCol); }			if ($rangeBoundaries[0][1] > $maxRow) { $rangeBoundaries[0][1] = $maxRow; }			if (PHPExcel_Cell::columnIndexFromString($rangeBoundaries[1][0]) > $maxCol) { $rangeBoundaries[1][0] = PHPExcel_Cell::stringFromColumnIndex($maxCol); }			if ($rangeBoundaries[1][1] > $maxRow) { $rangeBoundaries[1][1] = $maxRow; }			$rangeSet = $rangeBoundaries[0][0].$rangeBoundaries[0][1].':'.$rangeBoundaries[1][0].$rangeBoundaries[1][1];		}		unset($rangeSet);		$stRange = implode(' ',$rangeBlocks);		return $stRange;	}	/**	 * Get tab color	 *	 * @return PHPExcel_Style_Color	 */	public function getTabColor()	{		if (is_null($this->_tabColor))			$this->_tabColor = new PHPExcel_Style_Color();		return $this->_tabColor;	}	/**	 * Reset tab color	 *	 * @return PHPExcel_Worksheet	 */	public function resetTabColor()	{		$this->_tabColor = null;		unset($this->_tabColor);		return $this;	}	/**	 * Tab color set?	 *	 * @return boolean	 */	public function isTabColorSet()	{		return !is_null($this->_tabColor);	}	/**	 * Copy worksheet (!= clone!)	 *	 * @return PHPExcel_Worksheet	 */	public function copy() {		$copied = clone $this;		return $copied;	}	/**	 * Implement PHP __clone to create a deep clone, not just a shallow copy.	 */	public function __clone() {		foreach ($this as $key => $val) {			if ($key == '_parent') {				continue;			}			if (is_object($val) || (is_array($val))) {				if ($key == '_cellCollection') {					$newCollection = clone $this->_cellCollection;					$newCollection->copyCellCollection($this);					$this->_cellCollection = $newCollection;				} elseif ($key == '_drawingCollection') {					$newCollection = clone $this->_drawingCollection;					$this->_drawingCollection = $newCollection;				} else {					$this->{$key} = unserialize(serialize($val));				}			}		}	}}
 |