2020-02-27 13:18:25 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
2020-04-14 19:56:54 +03:00
< title > Javascript Pastes< / title >
2020-05-03 03:01:21 +03:00
< link href = "Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-03-19 02:11:25 +02:00
< meta name = "viewport" content = "width=device-width initial-scale=1" >
2020-02-27 13:18:25 +02:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
2020-05-03 03:01:21 +03:00
< link href = "Contents.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "Progress.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "Navigation.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "Fonts.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "Base.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
< link href = "Popups.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "Colours.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-04-14 19:56:54 +03:00
2020-02-27 13:18:25 +02:00
< / head >
2020-05-03 03:01:21 +03:00
< body class = "commentary-font" >
2020-03-19 02:11:25 +02:00
< nav role = "navigation" >
2020-04-14 19:56:54 +03:00
< h1 > < a href = "../index.html" >
< img src = "../docs-src/Figures/Inform.png" height = 72" >
< / a > < / h1 >
< ul > < li > < a href = "../compiler.html" > compiler tools< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../other.html" > other tools< / a > < / li >
< li > < a href = "../extensions.html" > extensions and kits< / a > < / li >
< li > < a href = "../units.html" > unit test tools< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Compiler Webs< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../inbuild/index.html" > inbuild< / a > < / li >
< li > < a href = "../inform7/index.html" > inform7< / a > < / li >
< li > < a href = "../inter/index.html" > inter< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inbuild Modules< / h2 > < ul >
< li > < a href = "../supervisor-module/index.html" > supervisor< / a > < / li >
< / ul > < h2 > Inform7 Modules< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../core-module/index.html" > core< / a > < / li >
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
< li > < a href = "../if-module/index.html" > if< / a > < / li >
< li > < a href = "../multimedia-module/index.html" > multimedia< / a > < / li >
2020-04-14 19:56:54 +03:00
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../index-module/index.html" > index< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inter Modules< / h2 > < ul >
< li > < a href = "../bytecode-module/index.html" > bytecode< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../building-module/index.html" > building< / a > < / li >
< li > < a href = "../codegen-module/index.html" > codegen< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Shared Modules< / h2 > < ul >
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / a > < / li >
< li > < a href = "index.html" > < span class = "selectedlink" > html< / span > < / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul >
2020-03-19 02:11:25 +02:00
< / nav >
< main role = "main" >
2020-05-03 03:01:21 +03:00
<!-- Weave of 'Javascript Pastes' generated by Inweb -->
< div class = "breadcrumbs" >
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../compiler.html" > Shared Modules< / a > < / li > < li > < a href = "index.html" > html< / a > < / li > < li > < a href = "index.html#2" > Chapter 2: HTML< / a > < / li > < li > < b > Javascript Pastes< / b > < / li > < / ul > < / div >
< p class = "purpose" > To write valid HTML for a paste icon which, when clicked, calls a Javascript function which will paste Inform source text into the Source panel of the application.< / p >
2020-02-27 13:18:25 +02:00
2020-04-16 01:49:59 +03:00
< ul class = "toc" > < li > < a href = "2-jp.html#SP1" > § 1. Definitions< / a > < / li > < li > < a href = "2-jp.html#SP7" > § 7. Individual characters< / a > < / li > < / ul > < hr class = "tocbar" >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1" > < / a > < b > § 1. Definitions. < / b > < / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2" > < / a > < b > § 2. < / b > The application is required to provide a Javascript function to copy text
2020-02-27 13:18:25 +02:00
into the source window. Broadly speaking, the application needs to support
Javascript in the following form:
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > var myProject = external.Project;< / span >
< span class = "plain-syntax" > myProject.selectView('source');< / span >
< span class = "plain-syntax" > myProject.pasteCode('Trying Taking Manhattan');< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > This for Windows: for OS X, the same code but < span class = "extract" > < span class = "extract-syntax" > window.Project< / span > < / span > rather
than < span class = "extract" > < span class = "extract-syntax" > external.Project< / span > < / span > .
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > As this implies, the details unfortunately differ on different platforms:
2020-02-27 13:18:25 +02:00
< / p >
< ul class = "items" > < li > (a) Model 1 - paste in OS X style, directly within the HREF of a link.
< / li > < li > (b) Model 2 - paste in Windows style, defining a function and calling that.
< / li > < / ul >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > In model 2 we define a Javascript function for each individual paste
2020-02-27 13:18:25 +02:00
because this protects against long paste texts overflowing what Windows
considers the maximum permitted length of a link: the WebKit rendering
engine in OS X has no such limit, apparently. This means that for Windows
we define numerous copies of the Javascript code above. In model 1, we
never need to compile fresh Javascript functions because the template file
2020-05-03 03:01:21 +03:00
< span class = "extract" > < span class = "extract-syntax" > ExtensionFileModel.html< / span > < / span > for OS X contains a definition of the single
2020-02-27 13:18:25 +02:00
Javascript function:
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < script language="JavaScript"> < / span >
< span class = "plain-syntax" > function pasteCode(code) {< / span >
< span class = "plain-syntax" > var myProject = project();< / span >
< span class = "plain-syntax" > myProject.selectView('source');< / span >
< span class = "plain-syntax" > myProject.pasteCode(code);< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < /script> < / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > and we can simply call < span class = "extract" > < span class = "extract-syntax" > href="javascript:pasteCode(...)"< / span > < / span > from any link.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The text pasted may in some cases be quite long (say, 5K or more) and the
2020-02-27 13:18:25 +02:00
code below should work whatever its length. It will of course be UTF-8 encoded,
2020-04-14 19:56:54 +03:00
since all HTML produced by Inform is.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP3" > < / a > < b > § 3. < / b > We have found that different Javascript implementations handle escape
2020-02-27 13:18:25 +02:00
characters in quoted text differently. (For instance, some allow a
2020-05-03 03:01:21 +03:00
double-quote < span class = "extract" > < span class = "extract-syntax" > "< / span > < / span > to appear as a literal in single-quoted text, others
require < span class = "extract" > < span class = "extract-syntax" > & quot;< / span > < / span > to be used, others still do not recognise HTML entities
like < span class = "extract" > < span class = "extract-syntax" > & quot;< / span > < / span > and treat them as literal text.) To avoid these tiresome
2020-02-27 13:18:25 +02:00
platform dependencies a single new escape-character syntax was added in
2020-05-03 03:01:21 +03:00
November 2007. This puts obligations both on Inform (and < span class = "extract" > < span class = "extract-syntax" > indoc< / span > < / span > , which also
2020-02-27 13:18:25 +02:00
generates HTML with Javascript pastes), to make use of the escape syntax,
and also on the application, to understand and act on it.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The application must implement < span class = "extract" > < span class = "extract-syntax" > myProject.pasteCode(code)< / span > < / span > such that every
instance of < span class = "extract" > < span class = "extract-syntax" > [=0xHHHH=]< / span > < / span > is replaced with the Unicode character whose
hexadecimal code is < span class = "extract" > < span class = "extract-syntax" > HHHH< / span > < / span > . There will always be four digits, with leading
zeros as needed, and < span class = "extract" > < span class = "extract-syntax" > A< / span > < / span > to < span class = "extract" > < span class = "extract-syntax" > F< / span > < / span > will be written in upper case. The only
Unicode characters with codes below < span class = "extract" > < span class = "extract-syntax" > 0x0020< / span > < / span > which must be handled are
newline, < span class = "extract" > < span class = "extract-syntax" > 0x000A< / span > < / span > , and tab, < span class = "extract" > < span class = "extract-syntax" > 0x0009< / span > < / span > .
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > The generator (Inform or < span class = "extract" > < span class = "extract-syntax" > indoc< / span > < / span > ) must always escape every instance of the
2020-02-27 13:18:25 +02:00
following characters:
< / p >
2020-05-03 03:01:21 +03:00
< ul class = "items" > < li > (a) every tab is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x0009=]< / span > < / span > ;
< / li > < li > (b) every newline is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x000A=]< / span > < / span > ;
< / li > < li > (c) every double quotation mark is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x0022=]< / span > < / span > ;
< / li > < li > (d) every ampersand is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x0026=]< / span > < / span > ;
< / li > < li > (e) every single quotation mark is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x0027=]< / span > < / span > ;
< / li > < li > (f) every less than sign is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x003C=]< / span > < / span > ;
< / li > < li > (g) every greater than sign is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x003E=]< / span > < / span > ;
< / li > < li > (h) every backslash is escaped to < span class = "extract" > < span class = "extract-syntax" > [=0x005C=]< / span > < / span > .
2020-02-27 13:18:25 +02:00
< / li > < / ul >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > It may also choose to escape other character codes, as it prefers. Other
2020-02-27 13:18:25 +02:00
characters are generated as literal UTF-8. In no case will any character
2020-05-03 03:01:21 +03:00
with code below < span class = "extract" > < span class = "extract-syntax" > 0x0020< / span > < / span > be passed as a literal.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP4" > < / a > < b > § 4. < / b > At the top level, the form of link used depends on the Javascript model.
2020-02-27 13:18:25 +02:00
Note that model 0 results in no material at all being output. The actual
2020-05-03 03:01:21 +03:00
text to be passed is all set via < span class = "extract" > < span class = "extract-syntax" > HTML::Javascript::javascript_string_out< / span > < / span > below, and which
2020-02-27 13:18:25 +02:00
does not depend on the model.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > javascript_fn_counter< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 1000< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::paste_W< / span > < button class = "popup" onclick = "togglePopup('usagePopup1')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup1" > Usage of < span class = "code-font" > < span class = "function-syntax" > HTML::Javascript::paste_W< / span > < / span > :< br / > HTML Documentation - < a href = "2-hd.html#SP9_4_1" > § 9.4.1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > wording< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP4" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::paste_inner< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Wordings::first_wn< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > Wordings::last_wn< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::paste_stream< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP4" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::paste_inner< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , -1, -1, < / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::paste_inner< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > to< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > ifndef< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WINDOWS_JAVASCRIPT< / span > < span class = "plain-syntax" > < / span > < span class = "comment-syntax" > OS X style, with long function arguments allowed in links< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "href=\"javascript:pasteCode("< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP6" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_string_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > to< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > ")\""< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_OPEN_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%S"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > link< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_TAG_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "img"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "border=0 src=inform:/doc_images/paste.png"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_CLOSE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > endif< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > ifdef< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WINDOWS_JAVASCRIPT< / span > < span class = "plain-syntax" > < / span > < span class = "comment-syntax" > Windows style, with long function arguments in links unreliable< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "< script language=\"JavaScript\"> \n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "function pasteCode%d(code) {\n"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > javascript_fn_counter< / span > < span class = "plain-syntax" > ); < / span > < span class = "identifier-syntax" > INDENT< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "var myProject = project();\n\n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "myProject.selectView('source');\n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "myProject.pasteCode("< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > OUTDENT< / span > < span class = "plain-syntax" > ; < / span > < a href = "2-jp.html#SP6" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_string_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > to< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > ");\n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "}\n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "< /script> \n"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_OPEN_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "href=\"javascript:pasteCode%d()\""< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > javascript_fn_counter< / span > < span class = "plain-syntax" > ++);< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_TAG_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "img"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "border=0 src=inform:/doc_images/paste.png"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_CLOSE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > endif< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP5" > < / a > < b > § 5. < / b > Though the Javascript function is called < span class = "extract" > < span class = "extract-syntax" > openFile< / span > < / span > , it can equally well
2020-02-27 13:18:25 +02:00
compile a link to open a folder on the host filing system.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::open_file< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > pathname< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > char< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > contents< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%f"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Filenames::in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > leaf< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%p"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > ifdef< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WINDOWS_JAVASCRIPT< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_THROUGH_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pos< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Str::get< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pos< / span > < span class = "plain-syntax" > ) == < / span > < span class = "character-syntax" > '\\'< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > Str::put< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pos< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '/'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > #< / span > < span class = "identifier-syntax" > endif< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_OPEN_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "href='javascript:project().openFile(\"%S\")'"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_TAG_WITH< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "img"< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%s"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > contents< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > HTML_CLOSE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "a"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > fn< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP6" > < / a > < b > § 6. < / b > In the following, the source of the text can be either a range of words
2020-02-27 13:18:25 +02:00
from the lexer (as for instance when a portion of an extension is being
typeset as documentation, with an example that can be pasted), or can
be a C string: if the latter, then its encoding must be ISO Latin-1.
2020-05-03 03:01:21 +03:00
The conversion to UTF-8 is performed in < span class = "extract" > < span class = "extract-syntax" > HTML::Javascript::javascript_char_out< / span > < / span > below.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::javascript_string_out< / span > < button class = "popup" onclick = "togglePopup('usagePopup2')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup2" > Usage of < span class = "code-font" > < span class = "function-syntax" > HTML::Javascript::javascript_string_out< / span > < / span > :< br / > < a href = "2-jp.html#SP4" > § 4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > to< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "'"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > ) < / span > < span class = "named-paragraph-container code-font" > < a href = "2-jp.html#SP6_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Write stream as Javascript string< / span > < span class = "named-paragraph-number" > 6.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "named-paragraph-container code-font" > < a href = "2-jp.html#SP6_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Write word range as Javascript string< / span > < span class = "named-paragraph-number" > 6.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "'"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< p class = "commentary firstcommentary" > < a id = "SP6_1" > < / a > < b > § 6.1. < / b > The art of leadership is delegation.
2020-02-27 13:18:25 +02:00
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Write stream as Javascript string< / span > < span class = "named-paragraph-number" > 6.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_THROUGH_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pos< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > alt_stream< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Str::get< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pos< / span > < span class = "plain-syntax" > ));< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "2-jp.html#SP6" > § 6< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP6_2" > < / a > < b > § 6.2. < / b > Writing a word range is much harder. In effect, we have to provide an
2020-02-27 13:18:25 +02:00
inverse function for the lexer, which converted raw source text to nicely
packaged up words.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > See Lexer for details of how words are stored, and in particular for the
< span class = "extract" > < span class = "extract-syntax" > lw_break< / span > < / span > character, which is < span class = "extract" > < span class = "extract-syntax" > '\t'< / span > < / span > when the word followed a tab, but is
< span class = "extract" > < span class = "extract-syntax" > '1'< / span > < / span > to < span class = "extract" > < span class = "extract-syntax" > '9'< / span > < / span > when it followed a newline plus that many tabs. We need
2020-02-27 13:18:25 +02:00
this because lexing has otherwise removed whitespace from the source, and
we need it back again if we're to paste a faithful Javascript representation:
otherwise the tabs used as column-dividers in tables will not come through,
for instance. Moreover, indentation from the left margin is used to make
prettier pastes (which respect the layout of the original examples from
2020-05-03 03:01:21 +03:00
which the paste has been made), and for that we need the < span class = "extract" > < span class = "extract-syntax" > '1'< / span > < / span > to < span class = "extract" > < span class = "extract-syntax" > '9'< / span > < / span >
2020-02-27 13:18:25 +02:00
possibilities.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > Note that we expect the material pasted to be indented at 1 tab stop from
2020-02-27 13:18:25 +02:00
the margin already, because it will almost always be a source text within
an example, where any matter unindented will be commentary rather than
source text. Thus a single tab after a newline is not significant, and we
only need to supply extra Javascript tabs when the indentation is 2 tab
stops or more.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Write word range as Javascript string< / span > < span class = "named-paragraph-number" > 6.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > follows_paragraph_break< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > close_I6_position< / span > < span class = "plain-syntax" > = -1;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > for< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > =< / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > ; < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > < =< / span > < span class = "identifier-syntax" > to< / span > < span class = "plain-syntax" > ; < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ++) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > wchar_t< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Lexer::word_raw_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Lexer::word< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > PARBREAK_V< / span > < span class = "plain-syntax" > ) { < / span > < span class = "comment-syntax" > marker for a paragraph break< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > follows_paragraph_break< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > while< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Lexer::word< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > PARBREAK_V< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ++; < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > --; < / span > < span class = "comment-syntax" > elide multiple breaks< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > continue< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > indentation< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Lexer::indentation_level< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > indentation< / span > < span class = "plain-syntax" > > < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) { < / span > < span class = "comment-syntax" > number of tab stops of indentation on this para< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > for< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > =0; < / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > indentation< / span > < span class = "plain-syntax" > -1; < / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ++) < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\t'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > Lexer::break_before< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) == < / span > < span class = "character-syntax" > '\t'< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > follows_paragraph_break< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )) {< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\t'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > follows_paragraph_break< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > ==< / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "2-jp.html#SP6_2_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Restore inter-word spaces unless this would be unnatural< / span > < span class = "named-paragraph-number" > 6.2.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > suppress_space< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > for< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > =0; < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ]; < / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ++) < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ]);< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "2-jp.html#SP6_2_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Insert a close-literal-I6 escape sequence if necessary< / span > < span class = "named-paragraph-number" > 6.2.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > );< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "2-jp.html#SP6" > § 6< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP6_2_1" > < / a > < b > § 6.2.1. < / b > The lexer also broke words around punctuation marks, so that, for instance,
"fish, finger" would have been lexed as < span class = "extract" > < span class = "extract-syntax" > fish , finger< / span > < / span > — three words.
2020-02-27 13:18:25 +02:00
But we want to restore the more natural spacing.
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Restore inter-word spaces unless this would be unnatural< / span > < span class = "named-paragraph-number" > 6.2.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > & & ((< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [1] != < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > Lexer::is_punctuation< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [0]) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ) ||< / span >
< span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [0] == < / span > < span class = "character-syntax" > '('< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [0] == < / span > < span class = "character-syntax" > '{'< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [0] == < / span > < span class = "character-syntax" > '}'< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > & & (< / span > < span class = "identifier-syntax" > compare_word< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > -1, < / span > < span class = "identifier-syntax" > OPENBRACKET_V< / span > < span class = "plain-syntax" > )==< / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > ' '< / span > < span class = "plain-syntax" > );< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "2-jp.html#SP6_2" > § 6.2< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP6_2_2" > < / a > < b > § 6.2.2. < / b > Finally, the lexer rendered a literal I6 inclusion in the form
2020-02-27 13:18:25 +02:00
< / p >
< blockquote >
< p > (- self=2; -)< / p >
< / blockquote >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > as a sequence of two lexical words: < span class = "extract" > < span class = "extract-syntax" > (-< / span > < / span > and then < span class = "extract" > < span class = "extract-syntax" > self=2;< / span > < / span > . In order
2020-02-27 13:18:25 +02:00
to paste back safely, we must supplement this with the closure "-)" once
again:
< / p >
2020-05-03 03:01:21 +03:00
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Insert a close-literal-I6 escape sequence if necessary< / span > < span class = "named-paragraph-number" > 6.2.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2020-02-27 13:18:25 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Lexer::word< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > OPENI6_V< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > close_I6_position< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > +1;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > close_I6_position< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > '-'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > ')'< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-jp.html#SP7" class = "function-link" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > , < / span > < span class = "character-syntax" > ' '< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "2-jp.html#SP6_2" > § 6.2< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP7" > < / a > < b > § 7. Individual characters. < / b > Note that every character within the single quotes of a Javascript string
2020-02-27 13:18:25 +02:00
is produced through the following routine. It escapes certain awkward
characters, but need not convert from ISO Latin-1 to UTF-8 since that will
happen automatically downstream of us when the output is written as a
UTF-8 encoded HTML file.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < button class = "popup" onclick = "togglePopup('usagePopup3')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup3" > Usage of < span class = "code-font" > < span class = "function-syntax" > HTML::Javascript::javascript_char_out< / span > < / span > :< br / > < a href = "2-jp.html#SP6_1" > § 6.1< / a > , < a href = "2-jp.html#SP6_2" > § 6.2< / a > , < a href = "2-jp.html#SP6_2_1" > § 6.2.1< / a > , < a href = "2-jp.html#SP6_2_2" > § 6.2.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > c< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > switch< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > c< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '\t'< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x0009=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '\n'< / span > < span class = "plain-syntax" > : < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NEWLINE_IN_STRING:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x000A=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '"'< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x0022=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '& '< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x0026=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '\''< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x0027=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '< '< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x003C=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '> '< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x003E=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > case< / span > < span class = "plain-syntax" > < / span > < span class = "character-syntax" > '\\'< / span > < span class = "plain-syntax" > : < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "[=0x005C=]"< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > default:< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PUT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > c< / span > < span class = "plain-syntax" > ); < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > }< / span >
2020-02-27 13:18:25 +02:00
< / pre >
2020-05-03 03:01:21 +03:00
< nav role = "progress" > < div class = "progresscontainer" >
< ul class = "progressbar" > < li class = "progressprev" > < a href = "2-hf.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "1-hm.html" > 1< / a > < / li > < li class = "progresscurrentchapter" > 2< / li > < li class = "progresssection" > < a href = "2-hf.html" > hf< / a > < / li > < li class = "progresscurrent" > jp< / li > < li class = "progresssection" > < a href = "2-hd.html" > hd< / a > < / li > < li class = "progressnext" > < a href = "2-hd.html" > ❯ < / a > < / li > < / ul > < / div >
< / nav > <!-- End of weave -->
2020-02-27 13:18:25 +02:00
2020-03-19 02:11:25 +02:00
< / main >
2020-02-27 13:18:25 +02:00
< / body >
< / html >
