KUPDATE Function

Inserts, deletes, and replaces character value contents.
Category: DBCS
Syntax
Details
See Also

Syntax

KUPDATE(argument,position,n<, characters-to-replace> )
KUPDATE(argument,position<,n> , characters-to-replace)

Required Arguments

argument
specifies a character variable.
position
specifies a numeric expression that is the beginning character position.
n
specifies a numeric expression that is the length of the substring to be replaced.
Restrictions:n cannot be larger than the length of the expression that remains in argument after position.

n is optional, but you cannot omit both n and characters-to-replace from the function.

Tip:If you omit n, SAS uses all of the characters in characters-to-replace to replace the values of argument.
characters-to-replace
specifies a character expression that replaces the contents of argument.
Restriction:characters-to-replace is optional, but you cannot omit both characters-to-replace and n from the function.
Tip:Enclose a literal string of characters in quotation marks.

Details

SeeInternationalization Compatibility for SAS String Functions for restrictions and more information.
The KUPDATE function replaces the value of argument with the expression in characters-to-replace. KUPDATE replaces n characters starting at the character you specify in position.
Note: If you set the NLSCOMPATMODE system option to on, parameter, characters-to-replace, processes the data based on previous SAS releases. If NLSCOMPATMODE is off, then characters-to-replace uses the 9.2 functionality. See the following table for examples.
Statements
Results 
NLSCOMPATEMODE
kkupdate("123456", 2,3); 
 
156
 
NLSCOMPATEMODE
kupdate("123456", 2,3,"abcd"); 
 
1abcd56
 
NONLSCOMPATEMODE
kupdate("123456", 2,3); 
 
1   56
 
NONLSCOMPATEMODE
kupdate("123456", 2,3,"abcd"); 
 
1abc56

See Also

Functions:
KUPDATEB Function
System Options:
NLSCOMPATMODE System Option: z/OS
Copyright © SAS Institute Inc. All rights reserved.