[pdf-tasks] [flyspray] New pdf_text_get_printable() method in the text module

[GNU PDF Library]

THIS IS AN AUTOMATED MESSAGE, DO NOT REPLY.

A new Flyspray task has been opened.  Details are below. 

User who did this - Aleksander Morgado (aleksander) 

Attached to Project - GNU PDF Library
Summary - New pdf_text_get_printable() method in the text module
Task Type - Sporadic Task
Category - Text Module
Status - NEXT
Assigned To - 
Operating System - All
Severity - Very Low
Priority - Normal
Reported Version - START
Due in Version - BASE-LAYER-0
Due Date - Undecided
Details - When programming with pdf_text_t objects, more than once it makes 
sense to actually try to get a printable string of the contents in the 
pdf_text_t; a string that can be passed to any printf-like method as argument 
for the '%s' format string.

This method may be something like this:
const pdf_char_t *
pdf_text_get_printable (pdf_text_t text);

In GNU/Linux systems, it would return a constant non-modifiable and 
NUL-terminated UTF-8 string. In Windows, this could be a NUL-terminated UTF-16 
string to be used in their printf-like methods for UTF-16 strings.

Hints:
* The first time this method is called in a given pdf_text_t, it will 
internally setup the proper string contents to be returned.
* The following times this method is called, and IF the pdf_text_t contents 
have not been modified, the same internal string is returned.
* Whenever the contents of the pdf_text_t are modified, the internal buffer 
should be freed, so that any new call to pdf_text_get_printable() will 
re-create the printable string again with the proper contents.

Once this is implemented, it will be possible to actually print the pdf_text_t 
with any of our DEBUG macros, like:
PDF_DEBUG_BASE ("The text object contains: '%s'", pdf_text_get_printable 
(text_object));



More information can be found at the following URL:
http://www.gnupdf.org/flyspray/index.php?do=details&task_id=116

You are receiving this message because you have requested it from the Flyspray 
bugtracking system.  If you did not expect this message or don't want to 
receive mails in future, you can change your notification settings at the URL 
shown above.