Remove @api annotation

This commit is contained in:
Adrien Loison 2017-11-05 01:16:59 +01:00
parent 7274226b75
commit cf765e3783
27 changed files with 0 additions and 72 deletions

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Common\Exception;
/** /**
* Class EncodingConversionException * Class EncodingConversionException
*
* @api
*/ */
class EncodingConversionException extends SpoutException class EncodingConversionException extends SpoutException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Common\Exception;
/** /**
* Class IOException * Class IOException
*
* @api
*/ */
class IOException extends SpoutException class IOException extends SpoutException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Common\Exception;
/** /**
* Class InvalidArgumentException * Class InvalidArgumentException
*
* @api
*/ */
class InvalidArgumentException extends SpoutException class InvalidArgumentException extends SpoutException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Common\Exception;
/** /**
* Class UnsupportedTypeException * Class UnsupportedTypeException
*
* @api
*/ */
class UnsupportedTypeException extends SpoutException class UnsupportedTypeException extends SpoutException
{ {

View File

@ -5,8 +5,6 @@ namespace Box\Spout\Common;
/** /**
* Class Type * Class Type
* This class references the supported types * This class references the supported types
*
* @api
*/ */
abstract class Type abstract class Type
{ {

View File

@ -21,7 +21,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return \Box\Spout\Reader\CSV\RowIterator * @return \Box\Spout\Reader\CSV\RowIterator
*/ */
public function getRowIterator() public function getRowIterator()
@ -30,7 +29,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return int Index of the sheet * @return int Index of the sheet
*/ */
public function getIndex() public function getIndex()
@ -39,7 +37,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return string Name of the sheet - empty string since CSV does not support that * @return string Name of the sheet - empty string since CSV does not support that
*/ */
public function getName() public function getName()
@ -48,7 +45,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return bool Always TRUE as there is only one sheet * @return bool Always TRUE as there is only one sheet
*/ */
public function isActive() public function isActive()

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Reader\Exception;
/** /**
* Class IteratorNotRewindableException * Class IteratorNotRewindableException
*
* @api
*/ */
class IteratorNotRewindableException extends ReaderException class IteratorNotRewindableException extends ReaderException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Reader\Exception;
/** /**
* Class NoSheetsFoundException * Class NoSheetsFoundException
*
* @api
*/ */
class NoSheetsFoundException extends ReaderException class NoSheetsFoundException extends ReaderException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Reader\Exception;
/** /**
* Class ReaderNotOpenedException * Class ReaderNotOpenedException
*
* @api
*/ */
class ReaderNotOpenedException extends ReaderException class ReaderNotOpenedException extends ReaderException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Reader\Exception;
/** /**
* Class SharedStringNotFoundException * Class SharedStringNotFoundException
*
* @api
*/ */
class SharedStringNotFoundException extends ReaderException class SharedStringNotFoundException extends ReaderException
{ {

View File

@ -40,7 +40,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return \Box\Spout\Reader\ODS\RowIterator * @return \Box\Spout\Reader\ODS\RowIterator
*/ */
public function getRowIterator() public function getRowIterator()
@ -49,7 +48,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return int Index of the sheet, based on order in the workbook (zero-based) * @return int Index of the sheet, based on order in the workbook (zero-based)
*/ */
public function getIndex() public function getIndex()
@ -58,7 +56,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return string Name of the sheet * @return string Name of the sheet
*/ */
public function getName() public function getName()
@ -67,7 +64,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return bool Whether the sheet was defined as active * @return bool Whether the sheet was defined as active
*/ */
public function isActive() public function isActive()

View File

@ -75,7 +75,6 @@ abstract class ReaderAbstract implements ReaderInterface
/** /**
* Sets whether date/time values should be returned as PHP objects or be formatted as strings. * Sets whether date/time values should be returned as PHP objects or be formatted as strings.
* *
* @api
* @param bool $shouldFormatDates * @param bool $shouldFormatDates
* @return ReaderAbstract * @return ReaderAbstract
*/ */
@ -89,7 +88,6 @@ abstract class ReaderAbstract implements ReaderInterface
/** /**
* Sets whether empty rows should be returned or skipped. * Sets whether empty rows should be returned or skipped.
* *
* @api
* @param bool $shouldPreserveEmptyRows * @param bool $shouldPreserveEmptyRows
* @return ReaderAbstract * @return ReaderAbstract
*/ */
@ -104,7 +102,6 @@ abstract class ReaderAbstract implements ReaderInterface
* Prepares the reader to read the given file. It also makes sure * Prepares the reader to read the given file. It also makes sure
* that the file exists and is readable. * that the file exists and is readable.
* *
* @api
* @param string $filePath Path of the file to be read * @param string $filePath Path of the file to be read
* @throws \Box\Spout\Common\Exception\IOException If the file at the given path does not exist, is not readable or is corrupted * @throws \Box\Spout\Common\Exception\IOException If the file at the given path does not exist, is not readable or is corrupted
* @return void * @return void
@ -213,7 +210,6 @@ abstract class ReaderAbstract implements ReaderInterface
/** /**
* Returns an iterator to iterate over sheets. * Returns an iterator to iterate over sheets.
* *
* @api
* @throws \Box\Spout\Reader\Exception\ReaderNotOpenedException If called before opening the reader * @throws \Box\Spout\Reader\Exception\ReaderNotOpenedException If called before opening the reader
* @return \Iterator To iterate over sheets * @return \Iterator To iterate over sheets
*/ */
@ -229,7 +225,6 @@ abstract class ReaderAbstract implements ReaderInterface
/** /**
* Closes the reader, preventing any additional reading * Closes the reader, preventing any additional reading
* *
* @api
* @return void * @return void
*/ */
public function close() public function close()

View File

@ -17,7 +17,6 @@ class ReaderFactory
/** /**
* This creates an instance of the appropriate reader, given the type of the file to be read * This creates an instance of the appropriate reader, given the type of the file to be read
* *
* @api
* @param string $readerType Type of the reader to instantiate * @param string $readerType Type of the reader to instantiate
* @throws \Box\Spout\Common\Exception\UnsupportedTypeException * @throws \Box\Spout\Common\Exception\UnsupportedTypeException
* @return ReaderInterface * @return ReaderInterface

View File

@ -37,7 +37,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return \Box\Spout\Reader\XLSX\RowIterator * @return \Box\Spout\Reader\XLSX\RowIterator
*/ */
public function getRowIterator() public function getRowIterator()
@ -46,7 +45,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return int Index of the sheet, based on order in the workbook (zero-based) * @return int Index of the sheet, based on order in the workbook (zero-based)
*/ */
public function getIndex() public function getIndex()
@ -55,7 +53,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return string Name of the sheet * @return string Name of the sheet
*/ */
public function getName() public function getName()
@ -64,7 +61,6 @@ class Sheet implements SheetInterface
} }
/** /**
* @api
* @return bool Whether the sheet was defined as active * @return bool Whether the sheet was defined as active
*/ */
public function isActive() public function isActive()

View File

@ -26,7 +26,6 @@ class Writer extends WriterAbstract
/** /**
* Sets the field delimiter for the CSV * Sets the field delimiter for the CSV
* *
* @api
* @param string $fieldDelimiter Character that delimits fields * @param string $fieldDelimiter Character that delimits fields
* @return Writer * @return Writer
*/ */
@ -40,7 +39,6 @@ class Writer extends WriterAbstract
/** /**
* Sets the field enclosure for the CSV * Sets the field enclosure for the CSV
* *
* @api
* @param string $fieldEnclosure Character that enclose fields * @param string $fieldEnclosure Character that enclose fields
* @return Writer * @return Writer
*/ */
@ -54,7 +52,6 @@ class Writer extends WriterAbstract
/** /**
* Set if a BOM has to be added to the file * Set if a BOM has to be added to the file
* *
* @api
* @param bool $shouldAddBOM * @param bool $shouldAddBOM
* @return Writer * @return Writer
*/ */

View File

@ -25,7 +25,6 @@ class StyleBuilder
/** /**
* Makes the font bold. * Makes the font bold.
* *
* @api
* @return StyleBuilder * @return StyleBuilder
*/ */
public function setFontBold() public function setFontBold()
@ -38,7 +37,6 @@ class StyleBuilder
/** /**
* Makes the font italic. * Makes the font italic.
* *
* @api
* @return StyleBuilder * @return StyleBuilder
*/ */
public function setFontItalic() public function setFontItalic()
@ -51,7 +49,6 @@ class StyleBuilder
/** /**
* Makes the font underlined. * Makes the font underlined.
* *
* @api
* @return StyleBuilder * @return StyleBuilder
*/ */
public function setFontUnderline() public function setFontUnderline()
@ -64,7 +61,6 @@ class StyleBuilder
/** /**
* Makes the font struck through. * Makes the font struck through.
* *
* @api
* @return StyleBuilder * @return StyleBuilder
*/ */
public function setFontStrikethrough() public function setFontStrikethrough()
@ -77,7 +73,6 @@ class StyleBuilder
/** /**
* Sets the font size. * Sets the font size.
* *
* @api
* @param int $fontSize Font size, in pixels * @param int $fontSize Font size, in pixels
* @return StyleBuilder * @return StyleBuilder
*/ */
@ -91,7 +86,6 @@ class StyleBuilder
/** /**
* Sets the font color. * Sets the font color.
* *
* @api
* @param string $fontColor ARGB color (@see Color) * @param string $fontColor ARGB color (@see Color)
* @return StyleBuilder * @return StyleBuilder
*/ */
@ -105,7 +99,6 @@ class StyleBuilder
/** /**
* Sets the font name. * Sets the font name.
* *
* @api
* @param string $fontName Name of the font to use * @param string $fontName Name of the font to use
* @return StyleBuilder * @return StyleBuilder
*/ */
@ -119,7 +112,6 @@ class StyleBuilder
/** /**
* Makes the text wrap in the cell if requested * Makes the text wrap in the cell if requested
* *
* @api
* @param bool $shouldWrap Should the text be wrapped * @param bool $shouldWrap Should the text be wrapped
* @return StyleBuilder * @return StyleBuilder
*/ */
@ -146,7 +138,6 @@ class StyleBuilder
/** /**
* Sets a background color * Sets a background color
* *
* @api
* @param string $color ARGB color (@see Color) * @param string $color ARGB color (@see Color)
* @return StyleBuilder * @return StyleBuilder
*/ */
@ -160,7 +151,6 @@ class StyleBuilder
/** /**
* Returns the configured style. The style is cached and can be reused. * Returns the configured style. The style is cached and can be reused.
* *
* @api
* @return Style * @return Style
*/ */
public function build() public function build()

View File

@ -41,7 +41,6 @@ class Sheet
} }
/** /**
* @api
* @return int Index of the sheet, based on order in the workbook (zero-based) * @return int Index of the sheet, based on order in the workbook (zero-based)
*/ */
public function getIndex() public function getIndex()
@ -58,7 +57,6 @@ class Sheet
} }
/** /**
* @api
* @return string Name of the sheet * @return string Name of the sheet
*/ */
public function getName() public function getName()
@ -73,7 +71,6 @@ class Sheet
* - it should not contain these characters: \ / ? * : [ or ] * - it should not contain these characters: \ / ? * : [ or ]
* - it should be unique * - it should be unique
* *
* @api
* @param string $name Name of the sheet * @param string $name Name of the sheet
* @throws \Box\Spout\Writer\Exception\InvalidSheetNameException If the sheet's name is invalid. * @throws \Box\Spout\Writer\Exception\InvalidSheetNameException If the sheet's name is invalid.
* @return Sheet * @return Sheet

View File

@ -27,7 +27,6 @@ class Color
/** /**
* Returns an RGB color from R, G and B values * Returns an RGB color from R, G and B values
* *
* @api
* @param int $red Red component, 0 - 255 * @param int $red Red component, 0 - 255
* @param int $green Green component, 0 - 255 * @param int $green Green component, 0 - 255
* @param int $blue Blue component, 0 - 255 * @param int $blue Blue component, 0 - 255

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Writer\Exception;
/** /**
* Class InvalidColorException * Class InvalidColorException
*
* @api
*/ */
class InvalidColorException extends WriterException class InvalidColorException extends WriterException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Writer\Exception;
/** /**
* Class InvalidSheetNameException * Class InvalidSheetNameException
*
* @api
*/ */
class InvalidSheetNameException extends WriterException class InvalidSheetNameException extends WriterException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Writer\Exception;
/** /**
* Class SheetNotFoundException * Class SheetNotFoundException
*
* @api
*/ */
class SheetNotFoundException extends WriterException class SheetNotFoundException extends WriterException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Writer\Exception;
/** /**
* Class WriterAlreadyOpenedException * Class WriterAlreadyOpenedException
*
* @api
*/ */
class WriterAlreadyOpenedException extends WriterException class WriterAlreadyOpenedException extends WriterException
{ {

View File

@ -4,8 +4,6 @@ namespace Box\Spout\Writer\Exception;
/** /**
* Class WriterNotOpenedException * Class WriterNotOpenedException
*
* @api
*/ */
class WriterNotOpenedException extends WriterException class WriterNotOpenedException extends WriterException
{ {

View File

@ -18,7 +18,6 @@ class Writer extends WriterMultiSheetsAbstract
* Sets a custom temporary folder for creating intermediate files/folders. * Sets a custom temporary folder for creating intermediate files/folders.
* This must be set before opening the writer. * This must be set before opening the writer.
* *
* @api
* @param string $tempFolder Temporary folder where the files to create the ODS will be stored * @param string $tempFolder Temporary folder where the files to create the ODS will be stored
* @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened * @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened
* @return Writer * @return Writer

View File

@ -20,7 +20,6 @@ class WriterFactory
/** /**
* This creates an instance of the appropriate writer, given the type of the file to be read * This creates an instance of the appropriate writer, given the type of the file to be read
* *
* @api
* @param string $writerType Type of the writer to instantiate * @param string $writerType Type of the writer to instantiate
* @throws \Box\Spout\Common\Exception\UnsupportedTypeException * @throws \Box\Spout\Common\Exception\UnsupportedTypeException
* @return WriterInterface * @return WriterInterface

View File

@ -51,7 +51,6 @@ abstract class WriterMultiSheetsAbstract extends WriterAbstract
* Sets whether new sheets should be automatically created when the max rows limit per sheet is reached. * Sets whether new sheets should be automatically created when the max rows limit per sheet is reached.
* This must be set before opening the writer. * This must be set before opening the writer.
* *
* @api
* @param bool $shouldCreateNewSheetsAutomatically Whether new sheets should be automatically created when the max rows limit per sheet is reached * @param bool $shouldCreateNewSheetsAutomatically Whether new sheets should be automatically created when the max rows limit per sheet is reached
* @throws WriterAlreadyOpenedException If the writer was already opened * @throws WriterAlreadyOpenedException If the writer was already opened
* @return WriterMultiSheetsAbstract * @return WriterMultiSheetsAbstract
@ -79,7 +78,6 @@ abstract class WriterMultiSheetsAbstract extends WriterAbstract
/** /**
* Returns all the workbook's sheets * Returns all the workbook's sheets
* *
* @api
* @throws WriterNotOpenedException If the writer has not been opened yet * @throws WriterNotOpenedException If the writer has not been opened yet
* @return Sheet[] All the workbook's sheets * @return Sheet[] All the workbook's sheets
*/ */
@ -101,7 +99,6 @@ abstract class WriterMultiSheetsAbstract extends WriterAbstract
/** /**
* Creates a new sheet and make it the current sheet. The data will now be written to this sheet. * Creates a new sheet and make it the current sheet. The data will now be written to this sheet.
* *
* @api
* @throws WriterNotOpenedException If the writer has not been opened yet * @throws WriterNotOpenedException If the writer has not been opened yet
* @return Sheet The created sheet * @return Sheet The created sheet
*/ */
@ -116,7 +113,6 @@ abstract class WriterMultiSheetsAbstract extends WriterAbstract
/** /**
* Returns the current sheet * Returns the current sheet
* *
* @api
* @throws WriterNotOpenedException If the writer has not been opened yet * @throws WriterNotOpenedException If the writer has not been opened yet
* @return Sheet The current sheet * @return Sheet The current sheet
*/ */
@ -131,7 +127,6 @@ abstract class WriterMultiSheetsAbstract extends WriterAbstract
* Sets the given sheet as the current one. New data will be written to this sheet. * Sets the given sheet as the current one. New data will be written to this sheet.
* The writing will resume where it stopped (i.e. data won't be truncated). * The writing will resume where it stopped (i.e. data won't be truncated).
* *
* @api
* @param Sheet $sheet The sheet to set as current * @param Sheet $sheet The sheet to set as current
* @throws WriterNotOpenedException If the writer has not been opened yet * @throws WriterNotOpenedException If the writer has not been opened yet
* @throws SheetNotFoundException If the given sheet does not exist in the workbook * @throws SheetNotFoundException If the given sheet does not exist in the workbook

View File

@ -18,7 +18,6 @@ class Writer extends WriterMultiSheetsAbstract
* Sets a custom temporary folder for creating intermediate files/folders. * Sets a custom temporary folder for creating intermediate files/folders.
* This must be set before opening the writer. * This must be set before opening the writer.
* *
* @api
* @param string $tempFolder Temporary folder where the files to create the XLSX will be stored * @param string $tempFolder Temporary folder where the files to create the XLSX will be stored
* @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened * @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened
* @return Writer * @return Writer
@ -36,7 +35,6 @@ class Writer extends WriterMultiSheetsAbstract
* Use inline string to be more memory efficient. If set to false, it will use shared strings. * Use inline string to be more memory efficient. If set to false, it will use shared strings.
* This must be set before opening the writer. * This must be set before opening the writer.
* *
* @api
* @param bool $shouldUseInlineStrings Whether inline or shared strings should be used * @param bool $shouldUseInlineStrings Whether inline or shared strings should be used
* @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened * @throws \Box\Spout\Writer\Exception\WriterAlreadyOpenedException If the writer was already opened
* @return Writer * @return Writer