Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: RGUT

RGUT.m

Go to the documentation of this file.
  1. RGUT ;CAIRO/DKM - General purpose utilities;17-Sep-1998 14:14;DKM
  1. ;;2.1;RUN TIME LIBRARY;;Mar 22, 1999
  1. ;=================================================================
  1. ; Replaces delimited arguments in string, returning result
  1. MSG(%RGTXT,%RGDLM) ;
  1. N %RGZ1,%RGZ2
  1. I $$NEWERR^%ZTER N $ET S $ET=""
  1. S:$G(%RGDLM)="" %RGDLM="%"
  1. S %RGZ2="",%RGTXT=$TR(%RGTXT,"~","^"),@$$TRAP^RGZOSF("M1^RGUT")
  1. F Q:%RGTXT="" D
  1. .S %RGZ2=%RGZ2_$P(%RGTXT,%RGDLM),%RGZ1=$P(%RGTXT,%RGDLM,2),%RGTXT=$P(%RGTXT,%RGDLM,3,999)
  1. .I %RGZ1="" S:%RGTXT'="" %RGZ2=%RGZ2_%RGDLM
  1. .E X "S %RGZ2=%RGZ2_("_%RGZ1_")"
  1. M1 Q %RGZ2
  1. ; Case-insensitive string comparison
  1. ; Returns 0: X=Y, 1: X>Y, -1: X<Y
  1. STRICMP(X,Y) ;
  1. S X=$$UP^XLFSTR(X),Y=$$UP^XLFSTR(Y)
  1. Q $S(X=Y:0,X]]Y:1,1:-1)
  1. ; Output an underline X bytes long
  1. UND(X) Q $$REPEAT^XLFSTR("-",$G(X,$G(IOM,80)))
  1. ; Truncate a string if > Y bytes long
  1. TRUNC(X,Y) ;
  1. Q $S($L(X)'>Y:X,1:$E(X,1,Y-3)_"...")
  1. ; Formatting for singular/plural
  1. SNGPLR(RGNUM,RGSNG,RGPLR) ;
  1. N RGZ
  1. S RGZ=RGSNG?.E1L.E,RGPLR=$G(RGPLR,RGSNG_$S(RGZ:"s",1:"S"))
  1. Q $S('RGNUM:$S(RGZ:"no ",1:"NO ")_RGPLR,RGNUM=1:"1 "_RGSNG,1:RGNUM_" "_RGPLR)
  1. ; Convert code to external form from set of codes
  1. SET(RGCODE,RGSET) ;
  1. N RGZ,RGZ1
  1. F RGZ=1:1:$L(RGSET,";") D Q:RGZ1'=""
  1. .S RGZ1=$P(RGSET,";",RGZ),RGZ1=$S($P(RGZ1,":")=RGCODE:$P(RGZ1,":",2),1:"")
  1. Q RGZ1
  1. ; Replace each occurrence of RGOLD in RGSTR with RGNEW
  1. SUBST(RGSTR,RGOLD,RGNEW) ;
  1. N RGP,RGL1,RGL2
  1. S RGNEW=$G(RGNEW),RGP=0,RGL1=$L(RGOLD),RGL2=$L(RGNEW)
  1. F S RGP=$F(RGSTR,RGOLD,RGP) Q:'RGP D
  1. .S RGSTR=$E(RGSTR,1,RGP-RGL1-1)_RGNEW_$E(RGSTR,RGP,9999)
  1. .S RGP=RGP-RGL1+RGL2
  1. Q RGSTR
  1. ; Trim leading (Y=-1)/trailing (Y=1)/leading & trailing (Y=0) spaces
  1. TRIM(X,Y) ;
  1. N RGZ1,RGZ2
  1. S Y=+$G(Y),RGZ1=1,RGZ2=$L(X)
  1. I Y'>0 F RGZ1=1:1 Q:$A(X,RGZ1)'=32
  1. I Y'<0 F RGZ2=RGZ2:-1 Q:$A(X,RGZ2)'=32
  1. Q $E(X,RGZ1,RGZ2)
  1. ; Format a number with commas
  1. FMTNUM(RGNUM) ;
  1. N RGZ,RGZ1,RGZ2
  1. S:RGNUM<0 RGNUM=-RGNUM,RGZ2="-"
  1. F RGZ=$L(RGNUM):-3:1 S RGZ1=$E(RGNUM,RGZ-2,RGZ)_$S($D(RGZ1):","_RGZ1,1:"")
  1. Q $G(RGZ2)_$G(RGZ1)
  1. ; Convert X to base Y padded to length L
  1. BASE(X,Y,L) ;
  1. Q:(Y<2)!(Y>62) ""
  1. N RGZ,RGZ1
  1. S RGZ1="",X=$S(X<0:-X,1:X)
  1. F S RGZ=X#Y,X=X\Y,RGZ1=$C($S(RGZ<10:RGZ+48,RGZ<36:RGZ+55,1:RGZ+61))_RGZ1 Q:'X
  1. Q $S('$G(L):RGZ1,1:$$REPEAT^XLFSTR(0,L-$L(RGZ1))_$E(RGZ1,1,L))
  1. ; Convert a string to its SOUNDEX equivalent
  1. SOUNDEX(RGVALUE) ;
  1. N RGCODE,RGSOUND,RGPREV,RGCHAR,RGPOS,RGTRANS
  1. S RGCODE="01230129022455012623019202"
  1. S RGSOUND=$C($A(RGVALUE)-(RGVALUE?1L.E*32))
  1. S RGPREV=$E(RGCODE,$A(RGVALUE)-64)
  1. F RGPOS=2:1 S RGCHAR=$E(RGVALUE,RGPOS) Q:","[RGCHAR D Q:$L(RGSOUND)=4
  1. .Q:RGCHAR'?1A
  1. .S RGTRANS=$E(RGCODE,$A(RGCHAR)-$S(RGCHAR?1U:64,1:96))
  1. .Q:RGTRANS=RGPREV!(RGTRANS=9)
  1. .S RGPREV=RGTRANS
  1. .S:RGTRANS'=0 RGSOUND=RGSOUND_RGTRANS
  1. Q $E(RGSOUND_"000",1,4)
  1. ; Display formatted title
  1. TITLE(RGTTL,RGVER,RGFN) ;
  1. I '$D(IOM) N IOM,IOF S IOM=80,IOF="#"
  1. S RGVER=$G(RGVER,"1.0")
  1. S:RGVER RGVER="Version "_RGVER
  1. U $G(IO,$I)
  1. W @IOF,$S(IO=IO(0):$C(27,91,55,109),1:""),*13,$$^RGCVTDT(+$H_","),?(IOM-$L(RGTTL)\2),RGTTL,?(IOM-$L(RGVER)),RGVER,!,$S(IO=IO(0):$C(27,91,109),1:$$UND),!
  1. W:$D(RGFN) ?(IOM-$L(RGFN)\2),RGFN,!
  1. Q
  1. ; Create a unique 8.3 filename
  1. UFN(Y) N X
  1. S Y=$E($G(Y),1,3),X=$$BASE($R(100)_$J_$TR($H,","),36,$S($L(Y):8,1:11))_Y
  1. Q $E(X,1,8)_"."_$E(X,9,11)
  1. ; Return formatted SSN
  1. SSN(X) Q $S(X="":X,1:$E(X,1,3)_"-"_$E(X,4,5)_"-"_$E(X,6,12))
  1. ; Performs security check on patient access
  1. DGSEC(Y) N DIC
  1. S DIC(0)="E"
  1. D ^DGSEC
  1. Q $S(Y<1:0,1:Y)
  1. ; Displays spinning icon to indicate progress
  1. WORKING(RGST,RGP,RGS) ;
  1. Q:'$D(IO(0))!$D(ZTQUEUED) 0
  1. N RGZ
  1. S RGZ(0)=$I,RGS=$G(RGS,"|/-\"),RGST=+$G(RGST)
  1. S RGST=$S(RGST<0:0,1:RGST#$L(RGS)+1)
  1. U IO(0)
  1. W:'$G(RGP) *8,$S(RGST:$E(RGS,RGST),1:" ")
  1. R *RGZ:0
  1. U RGZ(0)
  1. Q RGZ=94
  1. ; Ask for Y/N response
  1. ASK(RGP,RGD,RGZ) ;
  1. S RGD=$G(RGD,"N")
  1. S RGZ=$$GETCH(RGP_"? ","YN")
  1. S:RGZ="" RGZ=$E(RGD)
  1. W !
  1. Q $S(RGZ[U:"",1:RGZ="Y")
  1. ; Pause for user response
  1. PAUSE(RGP,RGX,RGY) ;
  1. Q $$GETCH($G(RGP,"Press RETURN or ENTER to continue..."),U,.RGX,.RGY)
  1. ; Single character read
  1. GETCH(RGP,RGV,RGX,RGY,RGT,RGD) ;
  1. N RGZ,RGC
  1. W:$D(RGX)!$D(RGY) $$XY($G(RGX,$X),$G(RGY,$Y))
  1. W $G(RGP)
  1. S RGT=$G(RGT,$G(DTIME,999999999999)),RGD=$G(RGD,U),RGC=""
  1. S:$D(RGV) RGV=$$UP^XLFSTR(RGV)_U
  1. F D Q:'$L(RGZ)
  1. .R RGZ#1:RGT
  1. .E S RGC=RGD Q
  1. .W *8
  1. .Q:'$L(RGZ)
  1. .S RGZ=$$UP^XLFSTR(RGZ)
  1. .I $D(RGV) D
  1. ..I RGV[RGZ S RGC=RGZ
  1. ..E W *7,*32,*8 S RGC=""
  1. .E S RGC=RGZ
  1. W !
  1. Q RGC
  1. ; Position cursor
  1. XY(DX,DY) ;
  1. D:$G(IOXY)="" HOME^%ZIS
  1. S DX=$S(+$G(DX)>0:+DX,1:0),DY=$S(+$G(DY)>0:+DY,1:0),$X=0
  1. X IOXY
  1. S $X=DX,$Y=DY
  1. Q ""
  1. ; Parameterized calls to date routines
  1. %DT(RGD,RGX) ;
  1. N %D,%P,%C,%H,%I,%X,%Y,RGZ
  1. D DT^DILF($G(RGX),RGD,.RGZ)
  1. W:$D(RGZ(0)) RGZ(0),!
  1. Q $G(RGZ,-1)
  1. %DTC(X1,X2) ;
  1. N X3
  1. S X2=$$%DTF(X1)+X2,X1=X1\1,X3=X2\1,X2=X2-X3
  1. S:X2<0 X3=X3-1,X2=X2+1
  1. Q $$FMADD^XLFDT(X1,X3)+$J($$%DTT(X2),0,6)
  1. %DTD(X1,X2) ;
  1. Q $$FMDIFF^XLFDT(X1\1,X2\1)+($$%DTF(X1)-$$%DTF(X2))
  1. %DTF(X) S X=X#1*100
  1. Q X\1*3600+(X*100#100\1*60)+(X*10000#100)/86400
  1. %DTT(X) S X=X*86400
  1. Q X\3600*100+(X#3600/3600*60)/10000
  1. ; THE FOLLOWING ENTRY POINTS WILL BE PHASED OUT IN FAVOR OF
  1. ; THEIR EQUIVALENTS WITHIN KERNEL
  1. ; Normalize global root
  1. GBL(RGGBL) ;
  1. Q $$CREF^DILF(RGGBL)
  1. ; Convert lower to upper case
  1. UPCASE(X) Q $TR(X,"abcdefghijklmnopqrstuvwxyz","ABCDEFGHIJKLMNOPQRSTUVWXYZ")
  1. ; Convert upper to lower case
  1. LOCASE(X) Q $TR(X,"ABCDEFGHIJKLMNOPQRSTUVWXYZ","abcdefghijklmnopqrstuvwxyz")
  1. ; Return a string of X repeated Y times
  1. RPT(X,Y) Q $$REPEAT^XLFSTR(X,Y)
  1. %DTDW(X) Q $$DOW^XLFDT(X)
  1. %DTDOW(X) ;
  1. Q $$DOW^XLFDT(X,1)
  1. %DTNOW() Q $$NOW^XLFDT
  1. %DTH(X) Q $$FMTH^XLFDT(X)
  1. %DTYX(X) Q $$HTFM^XLFDT(X)