-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Improve
jsonstringify
and stringify
operators docs: part 2
- Loading branch information
1 parent
bd99cf3
commit 4ae6cb0
Showing
4 changed files
with
48 additions
and
15 deletions.
There are no files selected for viewing
11 changes: 11 additions & 0 deletions
11
editions/tw5.com/tiddlers/filters/examples/jsonstringify Operator (Examples).tid
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
created: 20230922121858167 | ||
modified: 20230922122333325 | ||
tags: [[Operator Examples]] [[jsonstringify Operator]] | ||
title: jsonstringify Operator (Examples) | ||
type: text/vnd.tiddlywiki | ||
|
||
Compare the encoding of quotes and control characters in the first example with the analogue [[example for the stringify operator|stringify Operator (Examples)]]. | ||
<<.operator-example 1 """[[Backslash \, double quote ", single quote ', tab , line feed | ||
]] +[jsonstringify[]]""">> | ||
<<.operator-example 2 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 without suffix]] +[jsonstringify[]]""">> | ||
<<.operator-example 3 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 with rawunicode suffix]] +[jsonstringify:rawunicode[]]""">> |
6 changes: 4 additions & 2 deletions
6
editions/tw5.com/tiddlers/filters/examples/stringify_Operator_(Examples).tid
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,9 +1,11 @@ | ||
created: 20161017154944352 | ||
modified: 20230919124059118 | ||
modified: 20230922122319674 | ||
tags: [[Operator Examples]] [[stringify Operator]] | ||
title: stringify Operator (Examples) | ||
type: text/vnd.tiddlywiki | ||
|
||
<<.operator-example 1 """[[Title with "double quotes" and single ' and \backslash]] +[stringify[]]""">> | ||
Compare the encoding of quotes and control characters in the first example with the analogue [[example for the jsonstringify operator|jsonstringify Operator (Examples)]]. | ||
<<.operator-example 1 """[[Backslash \, double quote ", single quote ', tab , line feed | ||
]] +[stringify[]]""">> | ||
<<.operator-example 2 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 without suffix]] +[stringify[]]""">> | ||
<<.operator-example 3 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 with rawunicode suffix]] +[stringify:rawunicode[]]""">> |
27 changes: 25 additions & 2 deletions
27
editions/tw5.com/tiddlers/filters/jsonstringify Operator.tid
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,12 +1,35 @@ | ||
caption: jsonstringify | ||
created: 20171029155051467 | ||
from-version: 5.1.14 | ||
modified: 20230919124826880 | ||
modified: 20230922121404577 | ||
op-input: a [[selection of titles|Title Selection]] | ||
op-output: the input with JSON string encodings applied | ||
op-parameter: | ||
op-parameter-name: | ||
op-purpose: deprecated, use <<.olink stringify>> instead | ||
op-purpose: apply JSON string encoding to a string, see also the similar <<.olink stringify>> | ||
op-suffix: <<.from-version "5.1.23">> optionally, the keyword `rawunicode` | ||
op-suffix-name: R | ||
tags: [[Filter Operators]] [[String Operators]] | ||
title: jsonstringify Operator | ||
type: text/vnd.tiddlywiki | ||
|
||
The following substitutions are made: | ||
|
||
|!Character |!Replacement |!Condition | | ||
|`\` |`\\` |Always | | ||
|`"` |`\"` |Always | | ||
|Carriage return (0x0d) |`\r` |Always | | ||
|Line feed (0x0a) |`\n` |Always | | ||
|Backspace (0x08) |`\b` |Always | | ||
|Form field (0x0c) |`\f` |Always | | ||
|Tab (0x09) |`\t` |Always| | ||
|Characters from 0x00 to 0x1f, except listed above |`\u####` where #### is four hex digits |Always | | ||
|Characters from from 0x80 to 0xffff|`\u####` where #### is four hex digits |If `rawunicode` suffix is not present (default) | | ||
|Characters from 0x80 to 0xffff|<<.from-version "5.1.23">> Unchanged |If `rawunicode` suffix is present | | ||
|
||
<<.from-version "5.1.23">> If the suffix `rawunicode` is present, Unicode characters above 0x80 (such as ß, ä, ñ or 🎄) will be passed through unchanged. Without the suffix, they will be substituted with `\u` codes, which was the default behavior before 5.1.23. Characters outside the Basic Multilingual Plane, such as 🎄 and other emojis, will be encoded as a UTF-16 surrogate pair, i.e. with two `\u` sequences. | ||
|
||
<<.note """Mind the differences compared to <<.olink stringify>> in encoding of single quotes and control characters (0x00 to 0x1f). | ||
""">> | ||
|
||
<<.operator-examples "jsonstringify">> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters