Index: public/fpdf_text.h |
diff --git a/public/fpdf_text.h b/public/fpdf_text.h |
index 32cc131859288aa17222c559fb696b55f747f7ee..304fb1bacde23fc83823d376ceeee1467fcc5571 100644 |
--- a/public/fpdf_text.h |
+++ b/public/fpdf_text.h |
@@ -353,11 +353,13 @@ DLLEXPORT int STDCALL FPDFLink_CountWebLinks(FPDF_PAGELINK link_page); |
// link_index - Zero-based index for the link. |
// buffer - A unicode buffer. |
// buflen - Number of characters (not bytes) for the buffer, |
-// including an additional terminator. |
+// including an additional terminator. |
// Return Value: |
// If buffer is NULL or buflen is zero, return number of characters |
// (not bytes and an additional terminator is also counted) needed, |
// otherwise, return number of characters copied into the buffer. |
+// If |link_index| does not correspond to a valid link, then 0 is |
+// returned and |buffer| is unmodified (if present). |
// |
DLLEXPORT int STDCALL FPDFLink_GetURL(FPDF_PAGELINK link_page, |
int link_index, |
@@ -370,7 +372,8 @@ DLLEXPORT int STDCALL FPDFLink_GetURL(FPDF_PAGELINK link_page, |
// link_page - Handle returned by FPDFLink_LoadWebLinks. |
// link_index - Zero-based index for the link. |
// Return Value: |
-// Number of rectangular areas for the link. |
+// Number of rectangular areas for the link. If |link_index| does |
+// not correspond to a valid link, then 0 is returned. |
// |
DLLEXPORT int STDCALL FPDFLink_CountRects(FPDF_PAGELINK link_page, |
int link_index); |
@@ -382,15 +385,16 @@ DLLEXPORT int STDCALL FPDFLink_CountRects(FPDF_PAGELINK link_page, |
// link_index - Zero-based index for the link. |
// rect_index - Zero-based index for a rectangle. |
// left - Pointer to a double value receiving the rectangle |
-// left boundary. |
+// left boundary. |
// top - Pointer to a double value receiving the rectangle |
-// top boundary. |
+// top boundary. |
// right - Pointer to a double value receiving the rectangle |
-// right boundary. |
+// right boundary. |
// bottom - Pointer to a double value receiving the rectangle |
-// bottom boundary. |
+// bottom boundary. |
// Return Value: |
-// None. |
+// None. If |link_index| does not correspond to a valid link, then |
+// |left|, |top|, |right|, and |bottom| remain unmodified. |
// |
DLLEXPORT void STDCALL FPDFLink_GetRect(FPDF_PAGELINK link_page, |
int link_index, |