Add APIs for getting bookmarks and named destinations.

fpdfsdk/include/fpdfview.h

Index: fpdfsdk/include/fpdfview.h
diff --git a/fpdfsdk/include/fpdfview.h b/fpdfsdk/include/fpdfview.h
index ddf359c127f48f46dc8d4c0527ae5440d012b991..ec4479f2f300047fde863764a2e658b79ca52aab 100644
--- a/fpdfsdk/include/fpdfview.h
+++ b/fpdfsdk/include/fpdfview.h
@@ -8,6 +8,7 @@
 #ifndef _FPDFVIEW_H_
 #define _FPDFVIEW_H_
 
+#include <string>
 #if defined(_WIN32) && !defined(__WINDOWS__)
 #include <windows.h>
 #endif
@@ -123,6 +124,17 @@ extern const char g_ModuleCodes[];
 extern "C" {
 #endif
 
+#ifndef _FPDF_DEF_STR_
+#define _FPDF_DEF_STR_
+	// brief Structure for byte string.
+	// note In SDK, a byte string commonly means a UTF-16LE format string.
+	typedef struct
+	{
+		char*	str;
+		int	len;
+	} FPDF_BSTR;
+#endif
+
 // Function: FPDF_InitLibrary
 //			Initialize the FPDFSDK library 
 // Parameters:
@@ -602,6 +614,14 @@ DLLEXPORT FPDF_PAGERANGE STDCALL FPDF_VIEWERREF_GetPrintPageRange(FPDF_DOCUMENT
 //
 DLLEXPORT FPDF_DUPLEXTYPE STDCALL FPDF_VIEWERREF_GetDuplex(FPDF_DOCUMENT document);
 
+// Function: FPDF_CountNamedDests
+//			Get the count of named destinations in the PDF document.
+// Parameters:
+//			document	-	Handle to a document
+// Return value:
+//			The count of named destinations.
+DLLEXPORT FPDF_DWORD STDCALL FPDF_CountNamedDests(FPDF_DOCUMENT document);
+
 // Function: FPDF_GetNamedDestByName
 //			get a special dest handle by the index.
 // Parameters: 
@@ -612,6 +632,17 @@ DLLEXPORT FPDF_DUPLEXTYPE STDCALL FPDF_VIEWERREF_GetDuplex(FPDF_DOCUMENT documen
 //
 DLLEXPORT FPDF_DEST STDCALL FPDF_GetNamedDestByName(FPDF_DOCUMENT document,FPDF_BYTESTRING name);
 
+// Function: FPDF_GetNamedDest
+//			Get the specified named destinations of the PDF document by index.
+// Parameters:
+//			document	-	Handle to a document
+//			index		-	The index of named destination.
+//			name		-	The name of the named destination.
+// Return value:
+//			The destination handle of a named destination.
+DLLEXPORT FPDF_DEST STDCALL FPDF_GetNamedDest(FPDF_DOCUMENT document, int index, std::string name);

[Bo Xu, 2015/01/06 18:15:56]

@Tom, @raymes, should we have something like:

FPDF_DEST STDCALL FPDF_GetNamedDest(FPDF_DOCUMENT document, int index,
      char* name, int& len);

and ask the application to manage the string buffer?

[Tom Sepez, 2015/01/06 18:25:44]

Yes.  But the problem is that the application doesn't know how big to make the
buffer.  There are a few ways to deal with this.

1. There's a fixed constant like MAX_NAMELEN somewhere that limits the length of
possible dest names, it must always be enforced upon creation of these dests,
and we require a buffer that big here.

2. We pass a length on input, and return an error if its too small.

3. We have a "query" mode where if |name| is null, we return the required space
for the next call in |len|.

Pick one of these.  Thanks.
 

[Bo Xu, 2015/01/06 23:00:20]

I use the query mode in patch 4. Can you take a look?

+
+
 #ifdef __cplusplus
 };
 #endif