first commit

PHPExcel/Documentation/markdown/ReadingSpreadsheetFiles/07-Helper-Methods.md

@@ -0,0 +1,47 @@
+# PHPExcel User Documentation – Reading Spreadsheet Files
+
+
+## Helper Methods
+
+You can retrieve a list of worksheet names contained in a file without loading the whole file by using the Reader’s `listWorksheetNames()` method; similarly, a `listWorksheetInfo()` method will retrieve the dimensions of worksheet in a file without needing to load and parse the whole file.
+
+### listWorksheetNames
+
+The `listWorksheetNames()` method returns a simple array listing each worksheet name within the workbook:
+
+```php
+$objReader = PHPExcel_IOFactory::createReader($inputFileType);
+
+$worksheetNames = $objReader->listWorksheetNames($inputFileName);
+
+echo '<h3>Worksheet Names</h3>';
+echo '<ol>';
+foreach ($worksheetNames as $worksheetName) {
+    echo '<li>', $worksheetName, '</li>';
+}
+echo '</ol>';
+```
+ > See Examples/Reader/exampleReader18.php for a working example of this code.
+
+### listWorksheetInfo
+
+The `listWorksheetInfo()` method returns a nested array, with each entry listing the name and dimensions for a worksheet:
+
+```php
+$objReader = PHPExcel_IOFactory::createReader($inputFileType);
+
+$worksheetData = $objReader->listWorksheetInfo($inputFileName);
+
+echo '<h3>Worksheet Information</h3>';
+echo '<ol>';
+foreach ($worksheetData as $worksheet) {
+    echo '<li>', $worksheet['worksheetName'], '<br />';
+    echo 'Rows: ', $worksheet['totalRows'],
+         ' Columns: ', $worksheet['totalColumns'], '<br />';
+    echo 'Cell Range: A1:',
+    $worksheet['lastColumnLetter'], $worksheet['totalRows'];
+    echo '</li>';
+}
+echo '</ol>';
+```
+ > See Examples/Reader/exampleReader19.php for a working example of this code.