$ChkPat - Revision history

Dme: /* Syntax */

2018-01-23T18:53:57Z

Syntax

← Older revision		Revision as of 18:53, 23 January 2018
Line 8:		Line 8:
	Where:</p>		Where:</p>
	<ul>		<ul>
	<li>The required <var class="term">pattern</var> argument is the string of characters to verify, which can be a literal enclosed in quotation marks or a %variable.</li>		<li>The required <var class="term">pattern</var> argument is the string of characters to verify, which can be a literal enclosed in quotation marks or a %variable.
			<!-- This is not really required and probably we should change the doc to say that it defaults to the null string, which is a valid pattern. That example is used in QASHR tests SOUL.DME.263.QAR: -->
			<p>See the [[Like clause\|description of SOUL patterns]].</p></li>

	<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:		<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:

Dme: /* Examples */

2018-01-23T18:49:31Z

Examples

← Older revision		Revision as of 18:49, 23 January 2018
Line 25:		Line 25:
	<p>		<p>
	For U.S. English:</p>		For U.S. English:</p>
			<!-- The following example is used in QASHR tests SOUL.DME.263.QAR: -->
	<p class="code">%PAT='ABC*'		<p class="code">%PAT='ABC*'

DCameron: /* Syntax */

2018-01-23T13:35:39Z

Syntax

← Older revision		Revision as of 13:35, 23 January 2018
Line 12:		Line 12:
	<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:		<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:
	<ul>		<ul>
	<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English (even if the value of the <var>~~[[LANGUSER_parameter\|~~LANGUSER]]</var> parameter is not US) and lowercase characters are not recognized.</li>		<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English (even if the value of the <var>LANGUSER</var> parameter is not US) and lowercase characters are not recognized.</li>

	<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>		<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>

DCameron: /* Syntax */

2018-01-23T13:34:59Z

Syntax

← Older revision		Revision as of 13:34, 23 January 2018
Line 12:		Line 12:
	<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:		<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:
	<ul>		<ul>
	<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English (even if the value of the <var>LANGUSER</var> parameter is not US) and lowercase characters are not recognized.</li>		<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English (even if the value of the <var>[[LANGUSER_parameter\|LANGUSER]]</var> parameter is not US) and lowercase characters are not recognized.</li>

	<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>		<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>

ELowell: /* Syntax */

2016-03-08T18:11:55Z

Syntax

← Older revision		Revision as of 18:11, 8 March 2016
Line 12:		Line 12:
	<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:		<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:
	<ul>		<ul>
	<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English, even if the value of the <var>LANGUSER</var> parameter is not US, and lowercase characters are not recognized.</li>		<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English (even if the value of the <var>LANGUSER</var> parameter is not US) and lowercase characters are not recognized.</li>

	<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>		<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>

JAL: misc cleanup

2015-03-09T21:08:51Z

misc cleanup

← Older revision		Revision as of 21:08, 9 March 2015
Line 1:		Line 1:
	<p>The $ChkPat function verifies the syntax of a pattern. If the pattern is valid, a null string is returned; otherwise, an error message string is returned.</p>		<p>
	~~<b>~~Syntax~~</b>~~		The <var>$ChkPat</var> function verifies the syntax of a pattern. If the pattern is valid, a null string is returned; otherwise, an error message string is returned.</p>
	<p class="~~code~~">$ChkPat(<~~var~~ class="term">pattern</~~var~~>[,<~~var~~ class="term">language</~~var~~>])
			==Syntax==
			<p class="syntax">$ChkPat(<span class="term">pattern</span>[,<span class="term">language</span>])
	</p>		</p>
	<p>Where:</p>		<p>
	<p><~~var~~>The required pattern</var> argument is the string of characters to verify, which can be a literal enclosed in quotation marks or a %variable.</p>		Where:</p>
	<p><var>~~The optional~~ language</var> argument specifies the language to use. The language argument is handled as follows:~~</p>~~		<ul>
			<li>The required <var class="term">pattern</var> argument is the string of characters to verify, which can be a literal enclosed in quotation marks or a %variable.</li>

			<li>The optional <var class="term">language</var> argument specifies the language to use. The language argument is handled as follows:
	<ul>		<ul>
	<li>~~When~~ <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English, even if the value of the LANGUSER parameter is not US, and lowercase characters are not recognized.</li>		<li>If <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English, even if the value of the <var>LANGUSER</var> parameter is not US, and lowercase characters are not recognized.</li>
	~~</li>~~
	<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the LANGUSER parameter.</li>		<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the <var>LANGUSER</var> parameter.</li>
	~~</li>~~
	<li>You can enter the name of a valid language enclosed in quotation marks or a %variable containing a valid language. If the value you enter is not supported, the request is canceled with an error message. See ~~The LANGUSER parameter in~~ the ~~Rocket~~ <var ~~class="product"~~>~~Model 204~~</var> ~~Parameter and Command Reference Manual~~ for the valid values.</li>		<li>You can enter the name of a valid language enclosed in quotation marks or a %variable containing a valid language. If the value you enter is not supported, the request is canceled with an error message. See the <var>[[LANGUSER parameter\|LANGUSER]]</var> parameter for the valid values.</li>
	</li>		</ul></li>
	</ul>		</ul>
	<p>Without $ChkPat, pattern syntax errors can cause cancellation of the request or require the coding of complex ON units.</p>		<p>
	~~<b>~~Examples~~</b>~~		Without <var>$ChkPat</var>, pattern syntax errors can cause cancellation of the request or require the coding of complex <var>ON</var> units.</p>
	<p>For U.S. English:</p>
			==Examples==
			<p>
			For U.S. English:</p>
	<p class="code">%PAT='ABC*'		<p class="code">%PAT='ABC*'

Line 25:		Line 33:
	END IF		END IF
	</p>		</p>
	<p>For French Canadian:</p>		<p>
			For French Canadian:</p>
	<p class="code">%PAT='pêché'		<p class="code">%PAT='pêché'

Line 34:		Line 43:
	END IF		END IF
	</p>		</p>
	~~<b>~~Usage notes</b>
	<p>$ChkPat supports language-sensitive specification of patterns through an optional second parameter (such as [[~~$ALPHA#$ALPHA\|~~$Alpha]] and [[$~~ALPHNUM#$ALPHNUM\|$ALPHNUM~~]]).</p>		==Usage notes==
	<p>All characters X'00' through X'FF' are valid in a pattern presented to the ~~User Language~~ pattern matcher. The $ChkPat function no longer invokes either of the following messages when it encounters these characters.</p>		<p>
			<var>$ChkPat</var> supports language-sensitive specification of patterns through an optional second parameter (such as <var>[[$Alpha]]</var> and <var>[[$AlphNum]]</var>).</p>
			<p>
			All characters X'00' through X'FF' are valid in a pattern presented to the SOUL pattern matcher. The <var>$ChkPat</var> function no longer invokes either of the following messages when it encounters these characters.</p>
	<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char		<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char

	M204.1689: errortype IN PATTERN 'pattern' AT CHARACTER char		M204.1689: errortype IN PATTERN 'pattern' AT CHARACTER char
	</p>		</p>

	[[Category:SOUL $functions]]		[[Category:SOUL $functions]]

Mlarocca at 13:51, 15 July 2014

2014-07-15T13:51:17Z

← Older revision		Revision as of 13:51, 15 July 2014
Line 1:		Line 1:
	<p>The $~~CHKPAT~~ function verifies the syntax of a pattern. If the pattern is valid, a null string is returned; otherwise, an error message string is returned.</p>		<p>The $ChkPat function verifies the syntax of a pattern. If the pattern is valid, a null string is returned; otherwise, an error message string is returned.</p>
	<b>Syntax</b>		<b>Syntax</b>
	<p class="code">$~~CHKPAT~~(<var class="term">pattern</var>[,<var class="term">language</var>])		<p class="code">$ChkPat(<var class="term">pattern</var>[,<var class="term">language</var>])
	</p>		</p>
	<p>Where:</p>		<p>Where:</p>
Line 14:		Line 14:
	</li>		</li>
	</ul>		</ul>
	<p>Without $~~CHKPAT~~, pattern syntax errors can cause cancellation of the request or require the coding of complex ON units.</p>		<p>Without $ChkPat, pattern syntax errors can cause cancellation of the request or require the coding of complex ON units.</p>
	<b>Examples</b>		<b>Examples</b>
	<p>For U.S. English:</p>		<p>For U.S. English:</p>
	<p class="code">%PAT='ABC*'		<p class="code">%PAT='ABC*'

	%X=$~~CHKPAT~~(%PAT)		%X=$chkpat(%PAT)
	IF %X NE <nowiki>''</nowiki> THEN		IF %X NE <nowiki>''</nowiki> THEN
	PRINT %X		PRINT %X
Line 28:		Line 28:
	<p class="code">%PAT='pêché'		<p class="code">%PAT='pêché'

	%X=$~~CHKPAT~~(%PAT,'FRENCHC')		%X=$chkpat(%PAT,'FRENCHC')
	IF %X NE <nowiki>''</nowiki> THEN		IF %X NE <nowiki>''</nowiki> THEN
	PRINT %X		PRINT %X
Line 35:		Line 35:
	</p>		</p>
	<b>Usage notes</b>		<b>Usage notes</b>
	<p>$~~CHKPAT~~ supports language-sensitive specification of patterns through an optional second parameter (such as [[$ALPHA#$ALPHA\|$Alpha]] and [[$ALPHNUM#$ALPHNUM\|$ALPHNUM]]).</p>		<p>$ChkPat supports language-sensitive specification of patterns through an optional second parameter (such as [[$ALPHA#$ALPHA\|$Alpha]] and [[$ALPHNUM#$ALPHNUM\|$ALPHNUM]]).</p>
	<p>All characters X'00' through X'FF' are valid in a pattern presented to the User Language pattern matcher. The $~~CHKPAT~~ function no longer invokes either of the following messages when it encounters these characters.</p>		<p>All characters X'00' through X'FF' are valid in a pattern presented to the User Language pattern matcher. The $ChkPat function no longer invokes either of the following messages when it encounters these characters.</p>
	<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char		<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char

Mlarocca: Mlarocca moved page $CHKPAT to $ChkPat: Lower case change

2014-07-15T13:48:45Z

Mlarocca moved page $CHKPAT to $ChkPat: Lower case change

← Older revision	Revision as of 13:48, 15 July 2014
(No difference)

Mlarocca at 14:10, 17 June 2014

2014-06-17T14:10:08Z

← Older revision		Revision as of 14:10, 17 June 2014
Line 35:		Line 35:
	</p>		</p>
	<b>Usage notes</b>		<b>Usage notes</b>
	<p>$CHKPAT supports language-sensitive specification of patterns through an optional second parameter (such as [[$ALPHA#$ALPHA\|$~~ALPHA~~]] and [[$ALPHNUM#$ALPHNUM\|$ALPHNUM]]).</p>		<p>$CHKPAT supports language-sensitive specification of patterns through an optional second parameter (such as [[$ALPHA#$ALPHA\|$Alpha]] and [[$ALPHNUM#$ALPHNUM\|$ALPHNUM]]).</p>
	<p>All characters X'00' through X'FF' are valid in a pattern presented to the User Language pattern matcher. The $CHKPAT function no longer invokes either of the following messages when it encounters these characters.</p>		<p>All characters X'00' through X'FF' are valid in a pattern presented to the User Language pattern matcher. The $CHKPAT function no longer invokes either of the following messages when it encounters these characters.</p>
	<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char		<p class="code">M204.1688: errortype IN PATTERN 'pattern' AT CHARACTER char

JAL at 21:33, 5 June 2013

2013-06-05T21:33:37Z

← Older revision		Revision as of 21:33, 5 June 2013
Line 9:		Line 9:
	<li>When <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English, even if the value of the LANGUSER parameter is not US, and lowercase characters are not recognized.</li>		<li>When <var class="term">language</var> is omitted, <var class="product">Model 204</var> performs the validation in U.S. English, even if the value of the LANGUSER parameter is not US, and lowercase characters are not recognized.</li>
	</li>		</li>
	<li>An asterisk enclosed in quotation marks ('*') instructs <var class="product">Model 204</var> to use the value of the LANGUSER parameter.</li>		<li>An asterisk enclosed in quotation marks (<tt>'*'</tt>) instructs <var class="product">Model 204</var> to use the value of the LANGUSER parameter.</li>
	</li>		</li>
	<li>You can enter the name of a valid language enclosed in quotation marks or a %variable containing a valid language. If the value you enter is not supported, the request is canceled with an error message. See The LANGUSER parameter in the Rocket <var class="product">Model 204</var> Parameter and Command Reference Manual for the valid values.</li>		<li>You can enter the name of a valid language enclosed in quotation marks or a %variable containing a valid language. If the value you enter is not supported, the request is canceled with an error message. See The LANGUSER parameter in the Rocket <var class="product">Model 204</var> Parameter and Command Reference Manual for the valid values.</li>
Line 26:		Line 26:
	</p>		</p>
	<p>For French Canadian:</p>		<p>For French Canadian:</p>
	<p class="code">%PAT='p&#~~xFFFD~~;ch&#~~xFFFD~~;'		<p class="code">%PAT='pêché'

	%X=$CHKPAT(%PAT,'FRENCHC')		%X=$CHKPAT(%PAT,'FRENCHC')