Add API for getting page labels.

public/fpdf_doc.h

 // Copyright 2014 PDFium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
 
 #ifndef PUBLIC_FPDF_DOC_H_
 #define PUBLIC_FPDF_DOC_H_
 
 // NOLINTNEXTLINE(build/include)
@@ skipping 263 matching lines @@
 //   quadIndex  - the specified quad point index.
 //   quadPoints - receives the quadrilateral points.
 //
 // Returns true on success.
 DLLEXPORT FPDF_BOOL STDCALL FPDFLink_GetQuadPoints(FPDF_LINK linkAnnot,
                                                    int quadIndex,
                                                    FS_QUADPOINTSF* quadPoints);
 
 // Get meta-data |tag| content from |document|.
 //
-//   doc    - handle to the document
-//   tag    - the tag to retrieve. The tag can be one of:
-//              Title, Author, Subject, Keywords, Creator, Producer,
-//              CreationDate, or ModDate.
-//            For detailed explanations of these tags and their respective
-//            values, please refer to PDF Reference 1.6, section 10.2.1,
-//            'Document Information Dictionary'.
-//   buffer - a buffer for the title. May be NULL.
-//   buflen - the length of the buffer, in bytes. May be 0.
+//   document - handle to the document.
+//   tag      - the tag to retrieve. The tag can be one of:
+//                Title, Author, Subject, Keywords, Creator, Producer,
+//                CreationDate, or ModDate.
+//              For detailed explanations of these tags and their respective
+//              values, please refer to PDF Reference 1.6, section 10.2.1,
+//              'Document Information Dictionary'.
+//   buffer   - a buffer for the tag. May be NULL.
+//   buflen   - the length of the buffer, in bytes. May be 0.
 //
-// Returns the number of bytes in the title, including trailing zeros.
+// Returns the number of bytes in the tag, including trailing zeros.
 //
 // The |buffer| is always encoded in UTF-16LE. The |buffer| is followed by two
 // bytes of zeros indicating the end of the string.  If |buflen| is less than
 // the returned length, or |buffer| is NULL, |buffer| will not be modified.
-DLLEXPORT unsigned long STDCALL FPDF_GetMetaText(FPDF_DOCUMENT doc,
+DLLEXPORT unsigned long STDCALL FPDF_GetMetaText(FPDF_DOCUMENT document,
                                                  FPDF_BYTESTRING tag,
                                                  void* buffer,
                                                  unsigned long buflen);
 
+// Get the page label for |page_index| from |document|.
+//
+//   document    - handle to the document.
+//   page_index  - the index of the page.

[dsinclair, 2016/11/22 14:14:58]

0-based ?

[Lei Zhang, 2016/11/23 01:53:42]

Done.

+//   buffer      - a buffer for the page label. May be NULL.
+//   buflen      - the length of the buffer, in bytes. May be 0.
+//
+// Returns the number of bytes in the page label, including trailing zeros.
+//
+// The |buffer| is always encoded in UTF-16LE. The |buffer| is followed by two
+// bytes of zeros indicating the end of the string.  If |buflen| is less than
+// the returned length, or |buffer| is NULL, |buffer| will not be modified.
+DLLEXPORT unsigned long STDCALL FPDF_GetPagelLabel(FPDF_DOCUMENT document,
+                                                   int page_index,
+                                                   void* buffer,
+                                                   unsigned long buflen);
+
 #ifdef __cplusplus
 }  // extern "C"
 #endif  // __cplusplus
 
 #endif  // PUBLIC_FPDF_DOC_H_