From febcf92fec50f2ebff906510643f97ee7a8a8e72 Mon Sep 17 00:00:00 2001 From: Nick Burch Date: Mon, 15 Sep 2008 21:04:17 +0000 Subject: [PATCH] Merged revisions 695621 via svnmerge from https://svn.apache.org/repos/asf/poi/trunk ........ r695621 | nick | 2008-09-15 21:58:30 +0100 (Mon, 15 Sep 2008) | 1 line Make MissingCellPolicy javadocs even more explicit about iterators, as people seem not to quite get it ........ git-svn-id: https://svn.apache.org/repos/asf/poi/branches/ooxml@695625 13f79535-47bb-0310-9956-ffa450edef68 --- src/java/org/apache/poi/hssf/usermodel/HSSFRow.java | 2 ++ src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java | 5 ++++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFRow.java b/src/java/org/apache/poi/hssf/usermodel/HSSFRow.java index 44922014fd..26fd999efc 100644 --- a/src/java/org/apache/poi/hssf/usermodel/HSSFRow.java +++ b/src/java/org/apache/poi/hssf/usermodel/HSSFRow.java @@ -531,6 +531,8 @@ public final class HSSFRow implements Comparable, Row { * Note that the 4th element might well not be cell 4, as the iterator * will not return un-defined (null) cells. * Call getCellNum() on the returned cells to know which cell they are. + * As this only ever works on physically defined cells, + * the {@link MissingCellPolicy} has no effect. */ public Iterator cellIterator() { diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java b/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java index dd808a3413..b0da561fae 100644 --- a/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java +++ b/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java @@ -383,7 +383,10 @@ public class HSSFWorkbook extends POIDocument implements org.apache.poi.ss.userm * getting missing or blank cells from a row. * This will then apply to all calls to * {@link HSSFRow.getCell()}. See - * {@link MissingCellPolicy} + * {@link MissingCellPolicy}. + * Note that this has no effect on any + * iterators, only on when fetching Cells + * by their column index. */ public void setMissingCellPolicy(MissingCellPolicy missingCellPolicy) { this.missingCellPolicy = missingCellPolicy;