[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

More documentation for svn_utf_cstring_from_utf8_ex() etc.

From: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2006-03-22 23:06:11 CET

I am requesting, not offering (sorry), more information in these two doc strings:

/** Set @a *dest to a @a topage encoded C string from utf8 C string
  * @a src; allocate @a *dest in @a pool. Use @a convset_key as the
  * cache key for the charset converter; if it's NULL, don't cache the
  * converter.
  */
svn_error_t *svn_utf_cstring_from_utf8_ex(const char **dest,
                                           const char *src,
                                           const char *topage,
                                           const char *convset_key,
                                           apr_pool_t *pool);

/** Set @a *dest to a utf8-encoded C string from @a frompage C string
  * @a src; allocate @a *dest in @a pool. Use @a convset_key as the
  * cache key for the charset converter; if it's NULL, don't cache the
  * converter.
  */
svn_error_t *svn_utf_cstring_to_utf8_ex(const char **dest,
                                         const char *src,
                                         const char *frompage,
                                         const char *convset_key,
                                         apr_pool_t *pool);

1. What is the set of allowable values of the "topage" or "frompage" parameter?
  (I expect the set to be described, not enumerated, of course.)

2. What is the meaning and purpose of the "convset_key" parameter? I can see
what's written; I don't understand what sort of value I have to pass and what
function it performs.

The reason I'm asking is that one of Paul Burba's OS400 patches (#9) causes
these functions to be called from multiple libraries, and a possible
implementation has the "convset_key" parameter values made public or
semi-public and shared between libraries. I'm thinking it doesn't seem like it
should be necessary to do that, but until I understand what these parameters
are for I don't know.

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Mar 22 23:06:35 2006

This is an archived mail posted to the Subversion Dev mailing list.