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