Pic - Revision history

Gordon.dye: /* Other */

2018-06-29T12:13:26Z

Other

← Older revision		Revision as of 12:13, 29 June 2018
Line 166:		Line 166:

	See also [[FMT]], a similar method for formatting fields.		See also [[FMT]], a similar method for formatting fields.

			When PIC is used with non-numeric data it is processed very similar to the character string specifications C, V and G. Output is not formatted with insertion characters, but during keyboard entry insertion character positions are skipped.

	<noinclude>		<noinclude>

Gordon.dye: /* Digit identifiers */

2014-12-30T03:43:03Z

Digit identifiers

← Older revision		Revision as of 03:43, 30 December 2014
Line 80:		Line 80:
	{\|		{\|
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|'''~~SPECIFICATIONS~~'''\|\|~~output~~		\|width="75%"\|'''Specifications'''\|\|'''Output'''
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (# # # # # # # # ^ ^ ^ ^)\|\|1234500E-14		\|width="20%"\|PIC (# # # # # # # # ^ ^ ^ ^)\|\|1234500E-14
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (# #. # # #^ ^ ^ ^ )\|\|12.345E+19		\|width="20%"\|PIC (# #. # # #^ ^ ^ ^ )\|\|12.345E+19
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (# # . # # ^ ^ ^ ^ ^)\|\|12.35E+019		\|width="20%"\|PIC (# # . # # ^ ^ ^ ^ ^)\|\|12.35E+019
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (. # # # # # # ^ ^ ^ ^ )\|\|.12345E+21		\|width="20%"\|PIC (. # # # # # # ^ ^ ^ ^ )\|\|.12345E+21
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (ZZZ.# # ^ ^ ^ ^)\|\|123.45E+18		\|width="20%"\|PIC (ZZZ.# # ^ ^ ^ ^)\|\|123.45E+18
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|PIC (# # .^ ^ ^ ^ ^)\|\|2. E+019		\|width="20%"\|PIC (# # .^ ^ ^ ^ ^)\|\|2. E+019
	\|-valign="top"		\|-valign="top"
	\|}		\|}


	;( ~~and~~ )		;Parentheses - ( )
	PIC((ZZZ,ZZZ.##)) now supports parentheses as digit identifiers (left side of the number only) and insertion characters, with the rule that parentheses will be output only if the number is negative. The left parenthesis that is closest to the number but not replaced with a digit will be output when the number is negative.		PIC((ZZZ,ZZZ.##)) now supports parentheses as digit identifiers (left side of the number only) and insertion characters, with the rule that parentheses will be output only if the number is negative. The left parenthesis that is closest to the number but not replaced with a digit will be output when the number is negative.

Gordon.dye: /* Insertion Characters */

2014-12-30T03:31:45Z

Insertion Characters

← Older revision		Revision as of 03:31, 30 December 2014
Line 111:		Line 111:

	===Insertion Characters===		===Insertion Characters===
	Insertion characters are output exactly as they appear in the PIC specification. The five special insertion characters are: B, D, CR, DR and DB. Any keyboard character other than the digit identifiers listed above is treated as an insertion character. The following example shows two typical uses of insertion characters. The first PIC specification in line 20 prints slashes between the month, day and year of a date. The second prints a colon between the hours and minutes of a time, and it prints the letters "AM" after the time.		Insertion characters are output exactly where they appear in the PIC specification. The five special insertion characters are: B, D, CR, DR and DB. Any keyboard character other than the digit identifiers listed above is treated as an insertion character. The following example shows two typical uses of insertion characters. The first PIC specification in line 20 prints slashes between the month, day and year of a date. The second prints a colon between the hours and minutes of a time, and it prints the letters "AM" after the time.
	00010 PRINT USING 20: 102088,1130		00010 PRINT USING 20: 102088,1130
	00020 FORM PIC(ZZ/ZZ/ZZ),PIC(BB##:##AM)		00020 FORM PIC(ZZ/ZZ/ZZ),PIC(BB##:##AM)

Laura at 16:25, 22 September 2014

2014-09-22T16:25:42Z

← Older revision		Revision as of 16:25, 22 September 2014
Line 4:		Line 4:

	PIC may be used with both types of FORM statements (for internal and external files or for display files), and may be used with full screen processing statements. Unlike all other format specifications, PIC has its own set of specifications. These specifications generally fall into two groups: digit identifiers and insertion characters.		PIC may be used with both types of FORM statements (for internal and external files or for display files), and may be used with full screen processing statements. Unlike all other format specifications, PIC has its own set of specifications. These specifications generally fall into two groups: digit identifiers and insertion characters.

			As of 4.3, #PIC can be used to process numeric data from a string variable. Similar to #FMT and #G, #PIC indicates that string data should be processed numerically. This works for [[INPUT FIELDS]] as well as [[GRIDs and LISTs]].

			For example, when used in conjunction with the strings "231.45", "430", etc.:

			#pic($##,##0.00-)

			will be able to use the numeric values.

	===Digit identifiers===		===Digit identifiers===

Laura at 15:29, 8 May 2014

2014-05-08T15:29:53Z

← Older revision		Revision as of 15:29, 8 May 2014
Line 1:		Line 1:
			PIC({Z\|#\|$\|*\|+\|-\|^\|B\|D\|CR\|DR\|DB\|,\|.}[...])

	The '''PIC''' [[format specification]] converts a number into characters according to the "picture" specified within parenthesis. The "pic-spec" parameter consists of '''PIC()''' and one or more characters, which are either insertion characters to be printed as is, or digit identifiers to be replaced with a digit when printed.		The '''PIC''' [[format specification]] converts a number into characters according to the "picture" specified within parenthesis. The "pic-spec" parameter consists of '''PIC()''' and one or more characters, which are either insertion characters to be printed as is, or digit identifiers to be replaced with a digit when printed.

Line 4:		Line 6:

	===Digit identifiers===		===Digit identifiers===
	Digit identifiers indicate that the position they mark should be replaced with digits on output. The symbols that operate as digit identifiers include Z, #, $, *, - and +. In some cases (as noted in the following descriptions), these characters act both as digit identifiers and as insertion characters.		Digit identifiers indicate that the position they mark should be replaced with digits on output. The symbols that operate as digit identifiers include Z, #, $, *, -, +, ^, ( and ). In some cases (as noted in the following descriptions), these characters act both as digit identifiers and as insertion characters.

	;Z		;Z

Laura: /* Other */

2014-05-06T20:16:53Z

Other

← Older revision		Revision as of 20:16, 6 May 2014
Line 161:		Line 161:
	[[Category:Field Specifications]]		[[Category:Field Specifications]]
	[[Category:Format Specifications]]		[[Category:Format Specifications]]
			[[Category:All Parameters]]
	</noinclude>		</noinclude>

John at 18:55, 24 February 2014

2014-02-24T18:55:49Z

← Older revision		Revision as of 18:55, 24 February 2014
Line 1:		Line 1:
	The PIC format specification converts a number into characters according to the "picture" specified within parenthesis. The "pic-spec" parameter consists of '''PIC()''' and one or more characters, which are either insertion characters to be printed as is, or digit identifiers to be replaced with a digit when printed.		The '''PIC''' [[format specification]] converts a number into characters according to the "picture" specified within parenthesis. The "pic-spec" parameter consists of '''PIC()''' and one or more characters, which are either insertion characters to be printed as is, or digit identifiers to be replaced with a digit when printed.

	PIC may be used with both types of FORM statements (for internal and external files or for display files), and may be used with full screen processing statements. Unlike all other format specifications, PIC has its own set of specifications. These specifications generally fall into two groups: digit identifiers and insertion characters.		PIC may be used with both types of FORM statements (for internal and external files or for display files), and may be used with full screen processing statements. Unlike all other format specifications, PIC has its own set of specifications. These specifications generally fall into two groups: digit identifiers and insertion characters.

John: moved PIC to Pic

2014-02-24T18:55:39Z

moved PIC to Pic

← Older revision	Revision as of 18:55, 24 February 2014
(No difference)

Laura at 22:56, 6 January 2014

2014-01-06T22:56:45Z

← Older revision		Revision as of 22:56, 6 January 2014
Line 85:		Line 85:
	\|-valign="top"		\|-valign="top"
	\|}		\|}


	;( and )		;( and )

Laura at 22:56, 6 January 2014

2014-01-06T22:56:03Z

@@ Line 85: / Line 85: @@
 |-valign="top"
 |}
 ===Insertion Characters===
@@ Line 137: / Line 150: @@
 Conversion errors on G, N, and PIC formats can now be avoided on output to display files when the CONV=parameter is used in the OPEN DISPLAY statement. Also when CONV=is used, PIC processing will first try removing the commas from the output if doing so will prevent an overflow condition.
-PIC((ZZZ,ZZZ.##)) now supports parentheses as digit identifiers (left side of the number only) and insertion characters, with the rule that parentheses will be output only if the number is negative. The left parenthesis that is closest to the number but not replaced with a digit will be output when the number is negative.
+====Other====
 See the [[OPEN DISPLAY]] statement for more information.