C---------------------------------------------------------------------- subroutine ftpcls(ounit,colnum,frow,felem,nelem,sray,status) C write an array of character string values to the specified column of C the table. C The binary or ASCII table column being written to must have datatype 'A' C ounit i fortran unit number C colnum i number of the column to write to C frow i first row to write C felem i first element within the row to write C nelem i number of elements to write C sray c array of data values to be written C status i output error status C C written by Wm Pence, HEASARC/GSFC, June 1991 integer ounit,colnum,frow,felem,nelem,status character*(*) sray(*) C COMMON BLOCK DEFINITIONS:-------------------------------------------- integer nf,nb,ne parameter (nb = 20) parameter (nf = 3000) parameter (ne = 512) integer bufnum,chdu,hdutyp,maxhdu,hdstrt,hdend,nxthdr,dtstrt integer nxtfld logical wrmode common/ft0001/bufnum(199),chdu(nb),hdutyp(nb),maxhdu(nb), & wrmode(nb),hdstrt(nb,ne),hdend(nb),nxthdr(nb),dtstrt(nb),nxtfld integer tfield,tstart,tbcol,rowlen,tdtype,trept,tnull,heapsz integer theap double precision tscale,tzero common/ft0002/tfield(nb),tstart(nb),tbcol(nf),rowlen(nb), & tdtype(nf),trept(nf),tscale(nf),tzero(nf),tnull(nf),heapsz(nb) & ,theap(nb) C END OF COMMON BLOCK DEFINITIONS----------------------------------- integer bstart,strlen,c1,c2,repeat,twidth integer ibuff,i1,ntodo,rstart,estart,nchars,clen,tcode character sbuff*80,blank*80,messge*80 logical small,fill if (status .gt. 0)return ibuff=bufnum(ounit) if (frow .lt. 1)then write(messge,1001)frow 1001 format('Starting row number is out of range: ',i10) call ftpmsg(messge) status = 307 return else if (felem .lt. 1)then write(messge,1002)felem 1002 format('Starting element number is out of range: ',i10) call ftpmsg(messge) status = 308 return else if (nelem .lt. 0)then write(messge,1003)nelem 1003 format('Negative no. of elements to read or write: ',i10) call ftpmsg(messge) status = 306 return else if (nelem .eq. 0)then C just return if zero rows to write return end if C if HDU structure is not defined then scan the header keywords if (dtstrt(ibuff) .lt. 0)call ftrdef(ounit,status) if (colnum .lt. 1 .or. colnum .gt. tfield(ibuff))then write(messge,1004)colnum 1004 format('Specified column number is out of range: ',i10) call ftpmsg(messge) status = 302 return end if blank=' ' i1=1 C column must be character string data type tcode=tdtype(colnum+tstart(ibuff)) if (tcode .eq. 16)then C for ASCII columns, TNULL actually stores the field width twidth=tnull(colnum+tstart(ibuff)) ntodo=nelem rstart=frow-1 repeat=trept(colnum+tstart(ibuff)) estart=felem-1 if (estart .ge. repeat)then C illegal element number write(messge,1005)felem 1005 format( & 'Starting element number is greater than repeat: ',i10) call ftpmsg(messge) status = 308 return end if bstart=dtstrt(ibuff)+rstart*rowlen(ibuff) & +tbcol(colnum+tstart(ibuff))+estart*twidth else if (tcode .eq. -16)then C this is a variable length descriptor field C the length of the output string is defined by nelem twidth=nelem ntodo=1 repeat=1 C write the number of string length and the starting offset: call ftpdes(ounit,colnum,frow,twidth, & heapsz(ibuff),status) C calc the i/o pointer position for the start of the string bstart=dtstrt(ibuff)+heapsz(ibuff)+theap(ibuff) C increment the empty heap starting address: heapsz(ibuff)=heapsz(ibuff)+twidth else C error: not a character string column status=309 return end if C move the i/o pointer to the start of the sequence of pixels call ftmbyt(ounit,bstart,.true.,status) C is the input string short enough to completely fit in buffer? strlen=len(sray(1)) if (strlen .gt. 80 .and. twidth .gt. 80)then small=.false. else small=.true. end if C do we need to pad the FITS string field with trailing blanks? if (twidth .gt. strlen)then fill=.true. else fill=.false. end if C process one string at a time 20 continue nchars=min(strlen,twidth) if (small)then C the whole input string fits in the temporary buffer sbuff=sray(i1) C output the string call ftpcbf(ounit,nchars,sbuff,status) else C have to write the string in several pieces c1=1 c2=80 30 sbuff=sray(i1)(c1:c2) C output the string clen=c2-c1+1 call ftpcbf(ounit,clen,sbuff,status) nchars=nchars-clen if (nchars .gt. 0)then c1=c1+80 c2=min(c2+80,c1+nchars-1) go to 30 end if end if C pad any remaining space in the column with blanks if (fill)then nchars=twidth-strlen 40 clen=min(nchars,80) call ftpcbf(ounit,clen,blank,status) nchars=nchars-80 if (nchars .gt. 0)go to 40 end if if (status .gt. 0)then write(messge,1006)i1 1006 format('Error writing element',i9, & ' of input string array (FTPCLS).') call ftpmsg(messge) return end if C find number of pixels left to do, and quit if none left ntodo=ntodo-1 if (ntodo .gt. 0)then C increment the pointers i1=i1+1 estart=estart+1 if (estart .eq. repeat)then estart=0 rstart=rstart+1 bstart=dtstrt(ibuff)+rstart*rowlen(ibuff)+ & tbcol(colnum+tstart(ibuff)) C move the i/o pointer call ftmbyt(ounit,bstart,.true.,status) end if go to 20 end if end