[jira] Created: (XERCESC-1847) Removal of XMLString::release(XMLByte**) doesn't fit with Base64 class API

Removal of XMLString::release(XMLByte**) doesn't fit with Base64 class API
--------------------------------------------------------------------------

                 Key: XERCESC-1847
                 URL: https://issues.apache.org/jira/browse/XERCESC-1847
             Project: Xerces-C++
          Issue Type: Bug
          Components: Miscellaneous
    Affects Versions: 3.0.1
            Reporter: Scott Cantor


I'm doing a port of my code to the Xerces 3 API and one of the issues I noted is that there are APIs such as the Base64::decode method that return a dynamic XMLByte array and still document that XMLString::release() should be used to free the result.

However, somebody removed the XMLByte version of that method from the API, so technically there isn't a correct method to call.

Either the XMLByte version should be added back, or the affected APIs should be changed to not require it.


--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@...
For additional commands, e-mail: c-dev-help@...

     [ https://issues.apache.org/jira/browse/XERCESC-1847?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Boris Kolpackov updated XERCESC-1847:
-------------------------------------

    Affects Version/s:     (was: 3.0.1)
                       3.0.0

> Removal of XMLString::release(XMLByte**) doesn't fit with Base64 class API
> --------------------------------------------------------------------------
>
>                 Key: XERCESC-1847
>                 URL: https://issues.apache.org/jira/browse/XERCESC-1847
>             Project: Xerces-C++
>          Issue Type: Bug
>          Components: Miscellaneous
>    Affects Versions: 3.0.0
>            Reporter: Scott Cantor
>
> I'm doing a port of my code to the Xerces 3 API and one of the issues I noted is that there are APIs such as the Base64::decode method that return a dynamic XMLByte array and still document that XMLString::release() should be used to free the result.
> However, somebody removed the XMLByte version of that method from the API, so technically there isn't a correct method to call.
> Either the XMLByte version should be added back, or the affected APIs should be changed to not require it.

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@...
For additional commands, e-mail: c-dev-help@...

     [ https://issues.apache.org/jira/browse/XERCESC-1847?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Boris Kolpackov updated XERCESC-1847:
-------------------------------------

      Component/s:     (was: Miscellaneous)
                   Documentation
    Fix Version/s: 3.1.0
         Assignee: Boris Kolpackov

> Removal of XMLString::release(XMLByte**) doesn't fit with Base64 class API
> --------------------------------------------------------------------------
>
>                 Key: XERCESC-1847
>                 URL: https://issues.apache.org/jira/browse/XERCESC-1847
>             Project: Xerces-C++
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 3.0.0
>            Reporter: Scott Cantor
>            Assignee: Boris Kolpackov
>             Fix For: 3.1.0
>
>
> I'm doing a port of my code to the Xerces 3 API and one of the issues I noted is that there are APIs such as the Base64::decode method that return a dynamic XMLByte array and still document that XMLString::release() should be used to free the result.
> However, somebody removed the XMLByte version of that method from the API, so technically there isn't a correct method to call.
> Either the XMLByte version should be added back, or the affected APIs should be changed to not require it.

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@...
For additional commands, e-mail: c-dev-help@...

     [ https://issues.apache.org/jira/browse/XERCESC-1847?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Boris Kolpackov closed XERCESC-1847.
------------------------------------

    Resolution: Fixed

Updated the documentation.

> Removal of XMLString::release(XMLByte**) doesn't fit with Base64 class API
> --------------------------------------------------------------------------
>
>                 Key: XERCESC-1847
>                 URL: https://issues.apache.org/jira/browse/XERCESC-1847
>             Project: Xerces-C++
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 3.0.0
>            Reporter: Scott Cantor
>            Assignee: Boris Kolpackov
>             Fix For: 3.1.0
>
>
> I'm doing a port of my code to the Xerces 3 API and one of the issues I noted is that there are APIs such as the Base64::decode method that return a dynamic XMLByte array and still document that XMLString::release() should be used to free the result.
> However, somebody removed the XMLByte version of that method from the API, so technically there isn't a correct method to call.
> Either the XMLByte version should be added back, or the affected APIs should be changed to not require it.

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: c-dev-unsubscribe@...
For additional commands, e-mail: c-dev-help@...