[DFDL-WG] Fw: Proposed Errata: New function dfdl:stringLiteralToString
Mike Beckerle
mbeckerle.dfdl at gmail.com
Thu Jan 10 18:22:25 EST 2013
Fine with me too.
Question on behavior. Does this function turn all spaces into %SP; I guess
it has to. So if you are synthesizing one of our whitespace separated lists
of string literals you have to create each of the tokens separately using
encodeAsDFDLStringLiteral(), and then concatenate them together with
regular space characters between the tokens.
Do I have that right?
...mikeb
On Thu, Jan 10, 2013 at 9:07 AM, Suman Kalia <kalia at ca.ibm.com> wrote:
> Sounds good..
>
> Suman Kalia
> IBM Canada Lab
> WMB Toolkit Architect and Development Lead
> Tel: 905-413-3923 T/L 313-3923
> Email: kalia at ca.ibm.com
>
> For info on Message broker
>
> http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html
>
>
>
>
>
> From: Tim Kimber <KIMBERT at uk.ibm.com>
> To: Steve Hanson <smh at uk.ibm.com>,
> Cc: dfdl-wg at ogf.org, dfdl-wg-bounces at ogf.org
> Date: 01/10/2013 06:27 AM
> Subject: Re: [DFDL-WG] Fw: Proposed Errata: New function
> dfdl:stringLiteralToString
> Sent by: dfdl-wg-bounces at ogf.org
> ------------------------------
>
>
>
> +1 from me.
>
> regards,
>
> Tim Kimber, DFDL Team,
> Hursley, UK
> Internet: kimbert at uk.ibm.com
> Tel. 01962-816742
> Internal tel. 37246742
>
>
>
>
> From: Steve Hanson/UK/IBM at IBMGB
> To: dfdl-wg at ogf.org,
> Date: 10/01/2013 10:08
> Subject: Re: [DFDL-WG] Fw: Proposed Errata: New function
> dfdl:stringLiteralToString
> Sent by: dfdl-wg-bounces at ogf.org
> ------------------------------
>
>
>
> Keeping threads together...
>
> Tim has suggested *decodeDFDLStringLiteral()* and *
> encodeAsDFDLStringLiteral()* as an improvement on my suggestion.
>
> Mike has suggested *fromEntities()* and *toEntities(), *taking on board
> Tim's suggestion that would be clearer as *fromDFDLEntities()* and *
> toDFDLEntities()*
>
> How about taking the best of both, giving: *decodeDFDLEntities()* and *encodeDFDLEntities()
> *?
>
> To see how these look in context:
>
> dfdl:separator='{ dfdl:encodeDFDLEntities(Document/Delimiters/Separator) }'
>
> dfdl:outputValueCalc = '{ fn:concat(../x,
> dfdl:decodeDFDLEntities("%NUL;")) }'
>
> Regards
>
> Steve Hanson
> Architect, Data Format Description Language (DFDL)
> Co-Chair, *OGF DFDL Working Group* <http://www.ogf.org/dfdl/>
> IBM SWG, Hursley, UK*
> **smh at uk.ibm.com* <smh at uk.ibm.com>
> tel:+44-1962-815848
>
>
>
> From: Mike Beckerle <mbeckerle.dfdl at gmail.com>
> To: Steve Hanson/UK/IBM at IBMGB,
> Cc: Suman Kalia <kalia at ca.ibm.com>, dfdl-wg at ogf.org
> Date: 09/01/2013 23:15
> Subject: Re: [DFDL-WG] Fw: Proposed Errata: New function
> dfdl:stringLiteralToString
> ------------------------------
>
>
>
> How about: convertEntitiesToCharacters/convertCharactersToEntities ?
>
> Those are nice and descriptive, but a bit verbose/long. XPath is already
> hard to write, adding huge long identifiers to functions you actually need
> to call alot just makes this worse.
>
> So, how about fromEntities/toEntities ? or replaceEntities/useEntities ?
>
> I like putting the word Entities in there, because that's more descriptive
> of what is really going on than "string" vs. "string literal".
>
> On Tue, Jan 8, 2013 at 12:09 PM, Steve Hanson <*smh at uk.ibm.com*<smh at uk.ibm.com>>
> wrote:
> Let's try and list some alternatives with pros and cons: *Terminology* *
> Pro* *Con* escape / unescape Used in some prog langs Confusion with DFDL
> escape schemes encode / decode Used for URIs Confusion with character
> set encoding stringToStringLiteral / stringLiteralToString Uses DFDL
> terminology Was not clear to Suman
>
>
>
>
> How about decodeStringLiteral() and encodeAsStringLiteral() ?
>
> Regards
>
> Steve Hanson
> Architect, Data Format Description Language (DFDL)
> Co-Chair, *OGF DFDL Working Group* <http://www.ogf.org/dfdl/>
> IBM SWG, Hursley, UK*
> **smh at uk.ibm.com* <smh at uk.ibm.com>
> tel:*+44-1962-815848* <%2B44-1962-815848>
>
>
>
> From: Suman Kalia <*kalia at ca.ibm.com* <kalia at ca.ibm.com>>
> To: *dfdl-wg at ogf.org* <dfdl-wg at ogf.org>, *dfdl-wg-bounces at ogf.org*<dfdl-wg-bounces at ogf.org>,
>
> Date: 08/01/2013 15:56
> Subject: Re: [DFDL-WG] Fw: Proposed Errata: New function
> dfdl:stringLiteralToString
> Sent by: *dfdl-wg-bounces at ogf.org* <dfdl-wg-bounces at ogf.org>
> ------------------------------
>
>
>
> Example: dfdl:outputValueCalc='{ fn:concat(../x,
> dfdl:stringLiteralToString("%NUL;")) }'
>
> The proposed function stringLiteralToString and
> stringLiteralFromString are essentially equivalent to the escape and
> unescape function in other programming language.. I would suggest
> renaming the function to escape and unescape as they truly capture the
> semantics of proposed functionality.
>
>
> Here are references to other programming languages that use escape and
> unescape function *
> **http://php.net/manual/en/sqlite3.escapestring.php*<http://php.net/manual/en/sqlite3.escapestring.php>
> *
> **http://www.w3schools.com/jsref/jsref_escape.asp*<http://www.w3schools.com/jsref/jsref_escape.asp>
>
> Suman Kalia
> IBM Canada Lab
> WMB Toolkit Architect and Development Lead
> Tel: *905-413-3923* <905-413-3923> T/L 313-3923
> Email: *kalia at ca.ibm.com* <kalia at ca.ibm.com>
>
> For info on Message broker *
> **
> http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html
> *<http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html>
>
>
>
>
>
> From: Steve Hanson/UK/IBM at IBMGB
> To: Suman Kalia/Toronto/IBM at IBMCA,
> Date: 01/08/2013 10:31 AM
> Subject: Fw: [DFDL-WG] Proposed Errata: New function
> dfdl:stringLiteralToString
> ------------------------------
>
>
>
> Regards
>
> Steve Hanson
> Architect, Data Format Description Language (DFDL)
> Co-Chair, *OGF DFDL Working Group* <http://www.ogf.org/dfdl/>
> IBM SWG, Hursley, UK*
> **smh at uk.ibm.com* <smh at uk.ibm.com>
> tel:*+44-1962-815848* <%2B44-1962-815848>
> ----- Forwarded by Steve Hanson/UK/IBM on 08/01/2013 15:31 -----
>
> From: Mike Beckerle <*mbeckerle.dfdl at gmail.com*<mbeckerle.dfdl at gmail.com>
> >
> To: Steve Hanson/UK/IBM at IBMGB,
> Cc: *dfdl-wg at ogf.org* <dfdl-wg at ogf.org>, *dfdl-wg-bounces at ogf.org*<dfdl-wg-bounces at ogf.org>
> Date: 12/12/2012 18:14
> Subject: Re: [DFDL-WG] Proposed Errata: New function
> dfdl:stringLiteralToString
> ------------------------------
>
>
>
> My vote is From then To style, as in
>
> dfdl:stringLiteralToString - new function
> dfdl:stringToStringLiteral - renamed from dfdl:stringLiteralFromString
>
>
>
> On Wed, Dec 12, 2012 at 1:02 PM, Steve Hanson <*smh at uk.ibm.com*<smh at uk.ibm.com>>
> wrote:
> Should name be dfdl:stringFromStringLiteral to mirror existing
> dfdl:stringLiteralFromString (or should the latter be
> dfdl:stringToStringLiteral - follows the Java toString() pattern) ?
>
> Regards
>
> Steve Hanson
> Architect, Data Format Description Language (DFDL)
> Co-Chair, *OGF DFDL Working Group* <http://www.ogf.org/dfdl/>
> IBM SWG, Hursley, UK*
> **smh at uk.ibm.com* <smh at uk.ibm.com>
> tel:*+44-1962-815848* <%2B44-1962-815848>
>
>
>
> From: Steve Hanson/UK/IBM
> To: Mike Beckerle <*mbeckerle.dfdl at gmail.com*<mbeckerle.dfdl at gmail.com>>,
>
> Cc: *dfdl-wg at ogf.org* <dfdl-wg at ogf.org>, *dfdl-wg-bounces at ogf.org*<dfdl-wg-bounces at ogf.org>
> Date: 12/12/2012 17:20
> Subject: Re: [DFDL-WG] Proposed Errata: New function
> dfdl:stringLiteralToString
> ------------------------------
>
>
>
> Mike, should we disallow DFDL Character Class entities also ?
>
> Regards
>
> Steve Hanson
> Architect, Data Format Description Language (DFDL)
> Co-Chair, *OGF DFDL Working Group* <http://www.ogf.org/dfdl/>
> IBM SWG, Hursley, UK*
> **smh at uk.ibm.com* <smh at uk.ibm.com>
> tel:*+44-1962-815848* <%2B44-1962-815848>
>
>
>
>
> From: Mike Beckerle <*mbeckerle.dfdl at gmail.com*<mbeckerle.dfdl at gmail.com>
> >
> To: *dfdl-wg at ogf.org* <dfdl-wg at ogf.org>,
> Date: 12/12/2012 15:40
> Subject: [DFDL-WG] Proposed Errata: New function
> dfdl:stringLiteralToString
> Sent by: *dfdl-wg-bounces at ogf.org* <dfdl-wg-bounces at ogf.org>
> ------------------------------
>
>
>
>
> Proposed Errata: The following function is provided to assist in creating
> data that contains characters expressed using DFDL String Literal syntax.
>
> dfdl:stringLiteralToString($arg)
>
> Returns a string constructed from the $arg string argument. If $arg
> contains syntax matching DFDL Character Entites syntax, then the
> corresponding characters are used in the result. Any characters in $arg
> not matching the DFDL Character Entities syntax remain unchanged in the
> result.
>
> Note that DFDL Byte Value Entities are not allowed. It is a schema
> definition error if $arg contains syntax matching DFDL Byte Value Entities
> syntax.
>
> Use this function when you need to create a value which contains
> characters for which DFDL Character Entities are needed. An example is to
> create data containing the NUL (character code 0) codepoint. This character
> code is not allowed in XML documents, including DFDL Schemas; hence, it
> must be specified using a DFDL Character Entity. Within a DFDL Expression,
> use this function to obtain a string containing this character.
>
> Example: dfdl:outputValueCalc='{ fn:concat(../x,
> dfdl:stringLiteralToString("%NUL;")) }'
>
>
>
> --
> Mike Beckerle | OGF DFDL WG Co-Chair | Tresys Technologies
> Tel: *781-330-0412* <781-330-0412>
>
> --
> dfdl-wg mailing list*
> **dfdl-wg at ogf.org* <dfdl-wg at ogf.org>*
> **https://www.ogf.org/mailman/listinfo/dfdl-wg*<https://www.ogf.org/mailman/listinfo/dfdl-wg>
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
>
>
>
> --
> Mike Beckerle | OGF DFDL WG Co-Chair | Tresys Technologies
> Tel: *781-330-0412* <781-330-0412>
>
> --
> dfdl-wg mailing list*
> **dfdl-wg at ogf.org* <dfdl-wg at ogf.org>*
> **https://www.ogf.org/mailman/listinfo/dfdl-wg*<https://www.ogf.org/mailman/listinfo/dfdl-wg>
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
>
> --
> dfdl-wg mailing list
> *dfdl-wg at ogf.org* <dfdl-wg at ogf.org>
> *https://www.ogf.org/mailman/listinfo/dfdl-wg*<https://www.ogf.org/mailman/listinfo/dfdl-wg>
>
>
>
> --
> Mike Beckerle | OGF DFDL Workgroup Co-Chair | Tresys Technology | *
> www.tresys.com* <http://www.tresys.com/>
>
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
> --
> dfdl-wg mailing list
> dfdl-wg at ogf.org
> *https://www.ogf.org/mailman/listinfo/dfdl-wg*<https://www.ogf.org/mailman/listinfo/dfdl-wg>
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number
> 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
> --
> dfdl-wg mailing list
> dfdl-wg at ogf.org
> https://www.ogf.org/mailman/listinfo/dfdl-wg
>
> --
> dfdl-wg mailing list
> dfdl-wg at ogf.org
> https://www.ogf.org/mailman/listinfo/dfdl-wg
>
--
Mike Beckerle | OGF DFDL Workgroup Co-Chair | Tresys Technology |
www.tresys.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.ogf.org/pipermail/dfdl-wg/attachments/20130110/b94d9fdc/attachment-0001.html>
More information about the dfdl-wg
mailing list