DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=7072>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=7072

Documentation for XMLString::transcode states invalid return value

           Summary: Documentation for XMLString::transcode states invalid
                    return value
           Product: Xerces-C++
           Version: 1.4
          Platform: Sun
        OS/Version: All
            Status: NEW
          Severity: Minor
          Priority: Other
         Component: Documentation
        AssignedTo: [EMAIL PROTECTED]
        ReportedBy: [EMAIL PROTECTED]


The documentation for the function

XMLString::transcode(  const char *const toTranscode,  
 XMLCh *const toFill,  
 const unsigned int maxChars )  

states under 
maxChars   ... If the resulting output cannot fit into this many characters, it 
is an error and false is returned.  

By looking at the code, I think this return value never occurs and should 
therefore not be documented. The system function wcstombs() just returns -1 if 
a non-convertable character is detected.

Maybe also DOMString::transcode() contains the same incorrect documentation, 
but I didn't look there.

All Versions from 1.4 up to 1.7 document this wrong.

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to