Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

IBP command (Proc) (m618403+ibp.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

IBP

Prompts for and accepts input from the terminal keeping the input data a single parameter and retaining embedded blanks.

Syntax

IBP{char{bufferRef}}

Syntax Elements

char An optional prompt character. If included, it remains in effect until reset with an IBN, IBP, IN, IP or PROMPT command.

If char is not included, it defaults to the last prompt character specified or to colon (:) if the Proc was invoked from TCL.

bufferRef A direct or indirect reference to a buffer or select register where the input data is to be placed. The prompt character char is required if a reference is specified.

Operation

The IBP command functions the same as the IP command except that the input string is placed in the buffer as a single parameter and all blanks remain intact.

Use the IP command if you want leading and trailing blanks removed and embedded blanks replaced with single attribute marks.

IBP and IBPc place input data in the active input buffer, replacing the parameter pointed to by the buffer pointer.

IBPcr places input data in the buffer or select register specified by r.

Pressing RETURN only in response to the input prompt creates a null parameter.

The input buffer pointer does not change position after an IBP command.

Note: The IBP command does not read stacked input the way an INPUT statement in DataBasic does. All input commands in Proc ignore stacked data.

Example 1

Command Input	PIB Before	PIB After
`IBP? 3-93`	`UPDATE^INV` ↑	`UPDATE^INV^3-93` ↑

Example 2

Command Input	PIB Before	PIB After
`IBP? XXX Y Z`	`DISP^PO^333` ↑	`DISP^XXX Y Z^333` ↑

Example 3

Command Input	PIB Before	PIB After
`IBP?RETURN`	`ABC^DEF^GHI` ↑	`ABC^^GHI` ↑

Example 4

Command Input	File Buffer 1 Before	File Buffer 1 After
`IBP:&1.1 DOUG JONES`	`000 AB-221 001 BOB SMITH 002 2500 003 C`	`000 AB-221 001 DOUG JONES 002 2500 003 C`

Example 5

Command Input	File Buffer 2 Before	File Buffer 2 After
`IBP:&2.2 RETURN`	`000 AB-221 001 3311 002 2900 003 FF`	`000 AB-221 001 3311 002 003 FF`