Você está na página 1de 154

Listagem das funes do TOTVS

Funes ADVPL Genricas


EVAL
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
!VA" # $ b%&oco ' ( ) * + ,,' -&tVa&or%&oco
.ar/0etros
Arg10ento 2i3o 4escri5o
b%&oco 6o7e,%&oc8 $b%&oco' 9 o b&oco 7e c:7igo a ser ava&ia7o.
$"istaArg%&oco' #;1a&<1er+
$"istaArg%&oco' 9 10a &ista 7e arg10entos a ser
envia7a ao b&oco 7e c:7igo antes <1e e&e se=a ava&ia7o.
Retorno
2i3o 4escri5o
#;1a&<1er+
!VA"#+ retorna o va&or 7a >&ti0a e3ressao 7entro 7o b&oco. -0 b&oco 7e
c:7igo 3o7e retornar 10 va&or 7e <1a&<1er ti3o.
4escri5o
!VA"#+ 9 10a ?1n5ao 7e trata0ento 7e b&ocos 7e c:7igo. !&a 9 o 7is3ositivo 0ais
b@sico no siste0a A7v3& 3ara ava&iar b&ocos 7e c:7igo. -0 b&oco 7e c:7igo 9 10 va&or
7e 7a7os es3eciais <1e se re?ere a 10a 3arte 7o c:7igo 7e 3rogra0a co03i&a7o. .ara
0aiores in?or0a5oes sobre b&ocos 7e c:7igo( cons1&te o ca3At1&o 6onceitos %@sicos
neste &ivro.
.ara eec1tar o1 ava&iar 10 b&oco 7e c:7igo( voc 3o7e cBa0ar !VA"#+ co0 o va&or 7e
b&oco e <1ais<1er 3ar/0etros. Cs 3ar/0etros sao Dorneci7os ao b&oco <1an7o e&e 9
eec1ta7o. %&ocos 7e c:7igo 3o7e0 ser 10a s9rie 7e e3ressoes se3ara7as 3or vArg1&as.
;1an7o 10 b&oco 7e c:7igo 9 ava&ia7o( o va&or retorna7o 9 o va&or 7a >&ti0a e3ressao
no b&oco.
-0 b&oco 7e c:7igo gera&0ente 9 co03i&a7o e0 te03o 7e co03i&a5ao 3e&o co03i&a7or
7o A7v3&. !iste0( 3or90( ocasioes e0 te03o 7e eec15ao <1an7o 3o7e ser necess@rio
<1e voc co03i&e 10 b&oco 7e c:7igo a 3artir 7e 10a ca7eia 7e caracteres. Esto 3o7e ser
?eito 1ti&iFan7o,se o o3era7or 0acro #G+.
!VA"#+ 9 ?re<1ente0ente 1ti&iFa7o 3ara criar ?1n5oes iterator. !stas ?1n5oes a3&ica0
10 b&oco 3ara ca7a 0e0bro 7e 10a estr1t1ra 7e 7a7os. A!VA"#+( ASCR2#+(
AS6AH#+( e 4%!VA"#+ sao ?1n5oes iterator. A!VA"#+( 3or ee03&o( a3&ica 10 b&oco
3ara ca7a e&e0ento 7entro 7e 10 vetor.
GETREMOTETPE
Reviso: 19/11/200I
Abrangncia
Verso 8.11
Sintae
J!2R!KC2!2L.! # + ,,' nR0t2M3e
Retorno
2i3o 4escri5o
H109rico nR0t2M3e corres3on7e No n>0ero corres3on7ente N inter?ace 1ti&iFa7a.
4escri5o
Atrav9s 7a ?1n5o JetRe0ote2M3e#+( 9 3ossAve& i7enti?icar sob <1a& inter?ace o
3rogra0a at1a& est@ e0 eec15o.
!sta ?1n5o est@ 7is3onAve& a 3artir 7o .rotBe1s 8( %1i&7 7.00.0I0O08a
.o7e,se 1ti&iFar as constantes abaio( 3ara ava&iar o retorno 7a ?1n5o.
HCPR!KC2! ,1 // Qob( Reb o1 Ror8ing 2Brea7 # Se0 re0ote +
R!KC2!P;2PREHO2 1 // Re0ote e0 a0biente Rin7oSs
R!KC2!P;2P"EH-T 2 // Re0ote e0 a0biente -ni/"in1
!SSRV"#!$
Reviso: 12/06/200O
Abrangncia
Verso 6.09 Verso 7.10
Sintae
ESSRV-HET # + ,,' &is-ni
Retorno
2i3o 4escri5o
":gico
Se .2. o servi7or est@ sen7o eec1ta7o e0 a0biente -ni#r+ o1 "in1#r+
Se .D. o servi7or est@ sen7o eec1ta7o e0 a0biente Rin7oSs#r+
4escri5o
En?or0a se o servi7or A7vance7 .rotBe1s est@ sen7o eec1ta7o e0 a0biente -HET o1
"in1.
MS%R%&'
Reviso: 0O/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Sintae
KS6R6O2 # $ cString ' + ,,' n6R6
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
String 7e on7e ser@ ca&c1&a7o 10 6R6O2( 9 garanti7o <1e
3ara a 0es0a string se03re se obter@ 10 0es0o n>0ero(
3or90( no 9 garanti7o <1e 3ara strings 7i?erentes( os
n>0eros se=a0 se03re 7i?erentes.
Retorno
2i3o 4escri5o
H109rico
-0 n>0ero inteiro ( co0 at9 10 #7eF+ 7Agitos ( corres3on7ente ao 6R6 7a
string in?or0a7a co0o 3ar/0etro.
4escri5o
6a&c1&a 10 6R6 7e 10a string. A ?1n5o KS6R6O2#+ ca&c1&a 10 6R6 7e 10a string
in?or0a7a e retorna 10 n>0ero co0 esse c@&c1&o.
Hote <1e strings ig1ais retorna0 6R6 ig1ais( 3or90( ne0 se03re strings 7i?erentes
retorna0 6R6 7i?erentes.
MS%R%&'STR
Reviso: 02/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Sintae
KS6R6O2S2R # $ cString ' + ,,' c6R6O2
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
String a 3artir 7a <1a& ser@ ca&c1&a7o o 6R6O2. U garanti7o
<1e 3ara a 0es0a string se03re ser@ obti7o 10 0es0o
6R6 ( 0as no 9 garanti7o <1e 3ara strings 7i?erentes os
6R6s se=a0 se03re 7i?erentes.
Retorno
2i3o 4escri5o
6aracter -0a string co0 o 6R6 7a string in?or0a7a.
4escri5o
KS6R6O2S2R#+ ca&c1&a 10 6R6 7e 10a string in?or0a7a ( retornan7o 10a string co0
esse c@&c1&o.
Hote <1e strings ig1ais retorna0 6R6 ig1ais( 3or90 ne0 se03re strings 7i?erentes
retorna0 6R6 7i?erentes.
RA#DOM!(E
Reviso: 11/12/200O
Abrangncia
Verso 6.09 Verso 7.10
Sintae
RAH4CKEV! # $ nKini0o ' ( $ nKai0o ' + ,,' nA&eatorio
.ar/0etros
Arg10ento 2i3o 4escri5o
nKini0o H109rico 6orres3on7e ao 0enor n10ero a ser gera7o 3e&a ?1n5o.
nKai0o H109rico
6orres3on7e ao 0aior n>0ero # 0enos 10 + a ser gera7o
3e&a ?1n5o.
Retorno
2i3o 4escri5o
H109rico
H10ero ran7W0ico ( co03reen7i7o no interva&o entre #nKini0o+ e
#nKai0o,1+ : C n10ero gera7o 3o7e ser 0aior o1 ig1a& N nKini0o e
0enor o1 ig1a& a nKai0o,1 .
4escri5o
Atrav9s 7a ?1n5o ran7o0iFe#+ ( gera0os 10 n10ero inteiro a&eat:rio( co03reen7i7o
entre a ?aia in?erior e s13erior recebi7a atrav9s 7os 3ar/0etros nKini0o e nKai0o(
res3ectiva0ente.
Observao :
C &i0ite in?erior recebi7o atrav9s 7o 3ar/0etro nKini0o 9 X0aior o1 ig1a& a X( 3o7en7o
ser sortea7o e ?aFer 3arte 7o retornoY 3or90 o &i0ite s13erior 9 X0enor <1eX( 7e 0o7o a
n1nca ser@ atingi7o o1 7evo&vi7o no res1&ta7o. .or ee03&o ( a cBa0a7a 7a ?1n5o
ran7o0iFe#1(2+ se03re retornar@ 1 .
SE#DTOFORE
Reviso: 1I/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Sintae
S!H42CDCR! # + ,,' Hi&
Retorno
2i3o 4escri5o
#H-"C+ !sta ?1n5o no retorna va&or
4escri5o
!sta ?1n5o torna a a3&ica5o 7o Re0ote ?oregro1n7 na esta5o e0 <1e est@ sen7o
eec1ta7o.
DaF co0 <1e a =ane&a ativa 7o Re0ote ?i<1e aci0a 7e to7as as =ane&as 7e o1tras
a3&ica5es eec1ta7as na esta5o.
!tre0a0ente 7e3en7ente 7o siste0a o3eraciona& e0 1so( as veFes 3o7e ?a&Bar 7evi7o
ao siste0a o3eraciona& no s13ortar o co0an7o o1 7evi7o a carga ecessiva 7o siste0a(
o siste0a o3eraciona& 3o7e ignorar o co0an7o.
$MLERROR
Reviso: 16/07/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
TK"!RRCR # + ,,' nT0&Stat1s
Retorno
2i3o 4escri5o
6aracter
Retorna o stat1s 7a 1&ti0a o3era5o 7e 6ria5o 7e Cb=eto TK" rea&iFa7o
3e&o co0an7o 6R!A2! oT0& ...
4escri5o
A ?1ncao T0&!rror#+ retorna 10 stat1s 7a eec15o 7a 1&ti0a rotina 7e cria5o 7e
Cb=eto TK" rea&iFa7a 3e&o co0an7o 6R!A2! oTK". .o7e0os 1ti&iFar,nos 7as
constantes 7e?ini7as no ar<1ivo ZEH6"-4! XT0&D1n.6[X 3ara rea&iFar o trata0ento
7e erro. Vi7e tabe&as 7e constantes abaio :
,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
6onstante Va&or
,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
T!RRCRPCH"LDERS2HC4! ,1
T!RRCRPS-66!SS 0
T!RRCRPDE"!PHC2PDC-H4 1
T!RRCRPC.!HP!RRCR 2
T!RRCRPEHVA"E4PTK" O
,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Funes TOTVS de )anco de Dados
AL!AS
Reviso: 25/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A"EAS # ) nArea2raba&Bo * + ,,' cA&ias
.ar/0etros
Arg10ento 2i3o 4escri5o
nArea2raba&Bo H109rico
$nArea2raba&Bo' 9 o n>0ero 7a @rea 7e traba&Bo a ser
veri?ica7a.
Retorno
2i3o 4escri5o
6aracter
A"EAS#+ retorna o a&ias 7a @rea 7e traba&Bo es3eci?ica7a na ?or0a 7e 10a
ca7eia 7e caracteres( e0 &etra 0ai>sc1&a. 6aso $nArea2raba&Bo' nao se=a
es3eci?ica7a( 9 retorna7o o a&ias 7a @rea 7e traba&Bo corrente. Se nao
Bo1ver nenB10 ar<1ivo 7e banco 7e 7a7os e0 -So na @rea 7e traba&Bo
es3eci?ica7a( A"EAS#+ retorna 10a ca7eia 7e caracteres n1&a #XX+.
4escri5o
A"EAS#+ 9 10a ?1n5ao 7e banco 7e 7a7os 1ti&iFa7a 3ara 7eter0inar o a&ias 7a @rea 7e
traba&Bo es3eci?ica7a. A&ias 9 o no0e atrib1i7o a 10a @rea 7e traba&Bo <1an7o 10
ar<1ivo 7e banco 7e 7a7os est@ e0 1so. C no0e rea& atrib1i7o 9 o no0e 7o ar<1ivo 7e
banco 7e 7a7os( o1 10 no0e <1e ?oi e3&icita0ente atrib1i7o atrav9s 7a c&@1s1&a
A"EAS 7o co0an7o -S!.
A"EAS#+ 9 o inverso 7a ?1n5ao S!"!62#+. A"EAS#+ retorna o a&ias atrav9s 7o n>0ero
7a @rea 7e traba&Bo( e S!"!62#+ retorna o n>0ero 7a @rea 7e traba&Bo atrav9s 7o a&ias.
)TV%A#OPE#
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
%2V6AHC.!H # $ cHo0e ' ( ) cEn7ice * + ,,' &Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
cHo0e 6aracter Ho0e 7a tabe&a a ser testa7a.
cEn7ice 6aracter Ho0e 7o ar<1ivo 7e An7ice 7a tabe&a a ser testa7a.
Retorno
2i3o 4escri5o
#H-"C+
Retorna ?a&so se no ?oi 3ossAve& abrir a tabe&a a ser testa7a. .rinci3ais
0otivos: Ho eiste o ar<1ivo 7a tabe&a o1
7o An7ice ?isica0enteY o1 as 7e?ini5es 7a tabe&a o1 An7ice e0 <1esto no
?ora0 encontra7as.
Retorna ver7a7eiro se a tabe&a testa7a 3o7e ser aberta.
4escri5o
%2V6CHC.!H#+ 9 10a ?1n5o <1e veri?ica se a tabe&a 7e?ini7a 3e&o 3ar/0etro cHo0e
3o7e ser aberta e( se eistir( o 3ar/0etro cEn7ice veri?ica( ta0b90( se o An7ice 3o7e ser
aberto. .ara tanto( 9 testa7o se os ar<1ivos envo&vi7os eiste0 ?isica0ente( caso
a?ir0ativo( 9 veri?ica7o se as 7e?ini5es envo&vi7as so encontra7as nos ar<1ivos 7o
44D\s.
!e03&o
// !ste ee03&o 7e0onstra o 1so tA3ico 7e %2V6anC3en#+.
Se no ?a&Bar( a tabe&a e o An7ice testa7os sero abertos. Se ?a&Bar(
10a 0ensage0 9 a3resenta7a.
ED ]%2V6anC3en#X^7a7osa7v^aa1990.7atX(X^7a7osa7v^in71.in7X+
Kessagebo#XHo 9 3ossAve& abrir a tabe&a testa7aX(X!rroX( 0+
!"S!
-se X^7a7osa7v^aa1990.7atX S[AR!4 H!R
Cr7"istA77#X^7a7osa7v^in71.in7X+
!H4ED
)TV%REATEDDFS
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
%2V6R!A2!44DS # $ a2abe&as ' ( $ c4iretorio ' + ,,' &Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
a2abe&as ArraM Ho0es 7as tabe&as e os res3ectivos 7iret:rios.
c4iretorio 6aracter
Ho0e 7o 7iret:rio #abaio 7o root+ on7e sero cria7os os
novos 44D\s.
Retorno
2i3o 4escri5o
#H-"C+
Retorna ?a&so se no conseg1i1 gerar os novos ar<1ivos 7e 7e?ini5o.
.rinci3ais erros: R44 no 9 %trieveY 7iret:rio no est@ 7entro 7o .rotBe1sY
no 3o7e carregar as in?or0a5es 7e 7e?ini5o
o1 no 3o7e gravar os novos ar<1ivos 7e 7e?ini5o.
Retorna ver7a7eiro se a trans?or0a5o 7e 7e?ini5es ocorri7a co0 s1cesso.
4escri5o
%2V6R!A2!44DS#+ 9 10a ?1n5o <1e trans?or0a as in?or0a5es ar0aFena7as nos
ar<1ivos 44D\s 3ara o 3a7ro 1ti&iFa7o 3or o1tras ?erra0entas( 3rinci3a&0ente 3ara
gera5o 7e re&at:rios. Sen7o <1e 3o7e0 ser se&eciona7as a3enas as tabe&as 7e interesse
atrav9s 7o 3ar/0etro a2abe&as.
!: a2abe&as :_ ``XAAO990X( X6:^4A4CSXa(`XAAI990X(X6:^4A4CS1Xa(
`XAA5990Xaa
Se o 7iret:rio no ?or es3eci?ica7o( ser@ 1ti&iFa7o o 7iret:rio 7e?ini7o no ar<1ivo
DE"!.%2V.
Cs novos ar<1ivos 7e 7e?ini5o( DE"!.44D( DE!"4.44D e EH4!T.44D( so
gera7os no 7iret:rio es3eci?ica7o 3e&o 3ar/0etro c4iret:rio( se e&e
?or o0iti7o( sero gera7os no 0es0o 7iret:rio 7os STs.
!e03&o:
// !ste ee03&o 7e0onstra o 1so tA3ico 7e %2V6reate44Ds#+.
Se no ?a&Bar( sero gera7os os novos ar<1ivos 7e 7e?ini5o. Se ?a&Bar(
10a 0ensage0 9 a3resenta7a.
b:_ ``XAAO990Xa( `XSA1990X( Xc:^3rotBe1s507^7a7osa7vXaa
ED ]%2V6reate44Ds#b(X^te03X+
Kessagebo#XHo ?oi 3ossAve& 0ontar o arraM co0 os no0es 7as tabe&asX(X!rroX( 0+
!H4ED
)TVDROP!D$S
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
%2V4RC.E4TS # + ,,' &Ret
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no conseg1i1 a3agar os An7ices. .rinci3ais erros: R44
no 9 %trieve( no acBo1 as 7e?ini5es no 44D( o ar<1ivo no est@
ec&1sivoY
Retorna Ver7a7eiro se a 7e&e5o 7e An7ices ocorri7a co0 s1cessoY
4escri5o
%2V4ro3E7s#+ a3aga os An7ices 7a tabe&a corrente( co0 ece5o 7o An7ice interno(
a3enas se o 0es0o ?or %trieve e estiver aberto ec&1sivo. .ara tanto e&a eec1ta os
seg1intes 3assos:
, DecBa to7os os An7icesY
, A3aga as 7e?ini5es 7os An7ices nos ar<1ivos 7o 7iret:rio 44DY
, A3aga os An7ices 7o ar<1ivo 7a tabe&a corrente. 2o7os os An7ices cria7os 7e
?or0a 3er0anente ?ica0 g1ar7a7os na estr1t1ra 7a tabe&a. ;1an7o a tabe&a
?or aberta( to7os os An7ices cria7os 7e ?or0a 3er0anente e o An7ice interno
sero abertos ta0b90. .or isso( 9 reco0en7a7a a cria5o 7e An7ices 7e
?or0a te03or@ria.
!e03&o:
// !ste ee03&o 7e0onstra o 1so tA3ico 7e %2V4ro3E7s#+. Se no ?a&Bar( os An7ices so
a3aga7os e o 3rocesso contin1a. Se ?a&Bar( 10a 0ensage0 9 a3resenta7a.
-S! 6&ientes S[AR!4 H!R
ED ]%2V4ro3E7s#+
Kessagebo#XHo ?oi 3ossAve& 7e&etar os An7ices 7a tabe&a correnteX(X!rroX(
0+
!H4ED
)TVTA)LES
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
%2V2A%"!S # + ,,' a2ab&es
Retorno
2i3o 4escri5o
ArraM
Retorna HE" se no conseg1i1 0ontar o arraM. .rinci3ais erros: R44 no 9
%trieve o1 no conseg1i1 rec13erar as in?or0a5es correta0ente 7o
ar<1ivo DE"!.%2V 7o 44Ds.
Retorna 10 ArraM co0 a &ista co0 os no0es 7as tabe&as etraA7as 7o 44D.
4escri5o
%2V2A%"!S retorna arraM co03osto 3or no0es 7as tabe&as 7e?ini7as no 44D 7o
.rotBe1s. .ara tanto veri?ica to7os os no0es 7as tabe&as ar0aFena7os no ar<1ivo
DE"!.%2V 7o 44D e retorna 10 arraM co0 to7os e&es. 2o7a tabe&a cria7a 3oss1i o
no0e acrescenta7o neste ar<1ivo 7e 7e?ini5es.
!e03&o:
// !ste ee03&o 7e0onstra o 1so tA3ico 7e %2V2ab&es#+. Se no ?a&Bar( 9 0onta7o 10
arraM co0 os no0es 7as tabe&as e esses no0es so 0ostra7os no servi7or. Se ?a&Bar(
10a 0ensage0 9 a3resenta7a.
a:_ %2V2ab&es#+
ED a_Hi&
Kessagebo#XHo ?oi 3ossAve& 0ontar o arraM co0 os no0es 7as tabe&asX(X!rroX( 0+
!"S!
DCR i:_ 1 to "!H#a+
6onC1t#a)i*+
H!T2
!H4ED
%TREEDEL!D$S
Reviso: 26/08/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
62R!!4!"E4TS # + ,,' &Ret
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no conseg1i1 7e&etar os An7ices. .rinci3ais
erros: R44 no 9 6tree( no ?ecBo1 a tabe&a( no a3ago1 o ar<1ivo 7e
An7ice o1 no at1a&iFo1 as in?or0a5es 7a tabe&aY no abri1 a tabe&a
nova0ente.
Retorna Ver7a7eiro se a 7e&e5o 7e An7ices ocorri7a co0 s1cesso.
4escri5o
6tree4e&E7s#+ a3aga os An7ices 7a tabe&a corrente( co0 ece5o 7o An7ice interno(
a3enas se o 0es0o ?or 62ree e estiver ec&1siva. .ara tanto( e&a eec1ta os seg1intes
3assos:
, DecBa os An7ices abertosY
, DecBa a tabe&aY
, 4e&eta os ar<1ivos 7e An7ice ?isica0enteY
, At1a&iFa as in?or0a5es 7a tabe&a( re0oven7o os An7ices 7e s1a estr1t1raY
, Abre nova0ente a tabe&a.
2o7os os An7ices cria7os 7e ?or0a 3er0anente ?ica0 g1ar7a7os na estr1t1ra
7a tabe&a. .ortanto( no a7ianta 7e&etar os ar<1ivos 7e An7ices( 3ois <1an7o a tabe&a ?or
aberta( to7os os An7ices cria7os 7e ?or0a 3er0anente e o An7ice interno sero recria7os
?isica0ente #se no eistire0+Y caso contr@rio( a tabe&a no ser@ aberta. .or isso( 9
reco0en7a7a a cria5o 7e An7ices 7e ?or0a te03or@ria.
E03ortante: A3:s a re0o5o 7os An7ices a tabe&a ser@ 3osiciona7a no 3ri0eiro registro.
!e03&o:
// !ste ee03&o 7e0onstra o 1so tA3ico 7e 6tree4e&E7s#+. Se no ?a&Bar(
os An7ices so a3aga7os e o 3rocesso contin1a. Se ?a&Bar( 10a 0ensage0
9 a3resenta7a.
-S! 6&ientes S[AR!4 H!R
ED ]6tree4e&E7s#+
Kessagebo#\Ho ?oi 3ossAve& 7e&etar os An7ices 7a tabe&a corrente\(\!rro\(0+
!H4ED
%TREEDEL!#T
Reviso: 22/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
62R!!4!"EH2 # $ cHCK! ' + ,,' &Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
cHCK! 6aracter
!s3eci?ica o no0e 7a tabe&a c1=o An7ice interno 7eve ser
7e&eta7o.
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no conseg1i1 7e&etar o An7ice interno. .rinci3ais
erros: tabe&a no est@ 7entro 7o 7iret:rio 7o .rotBe1s( no abri1 a tabe&a o1
no 7e&eto1 o ar<1ivo 7e An7ice interno.
Retorna Ver7a7eiro se a 7e&e5o 7o An7ice interno ocorri7a co0 s1cesso.
4escri5o
62R!!4!"EH2#+ a3aga o An7ice interno 7e tabe&a 6tree( estan7o a 0es0a ?ecBa7a.
.ara tanto( so eec1ta7os os seg1intes 3roce7i0entos:
, Abre a tabe&a es3eci?ica7a 3e&o 3ar/0etro cHo0eY
, Veri?ica o no0e 7o ar<1ivo 7o An7ice interno na tabe&aY
, DecBa a tabe&aY
, 4e&eta ?isica0ente o ar<1ivo 7o An7ice interno.
A tabe&a 7eve ser a3aga7a a3:s a cBa0a7a 7esta ?1n5o( 3ois a tabe&a 62ree no 3o7e
ser aberta se0 An7ice interno.
!e03&o:
// !ste ee03&o 7e0onstra o 1so tA3ico 7e 6tree4e&Ent#+. Sen7o <1e a tabe&a
\^7a7osa7v^sa1990.7tc\ 7eve estar ?ecBa7a. Se no ?a&Bar( o An7ice interno 9 a3aga7o e o
3rocesso contin1a. Se ?a&Bar( 10a 0ensage0 9 a3resenta7a.
ED ]6tree4e&Ent#\^7a7osa7v^sa1990.7tc\+
Kessagebo#\Ho ?oi 3ossAve& 7e&etar o An7ice 7a tabe&a\(\!rro\( 0+
!H4ED
?!rase#\^7a7osa7v^sa1990.7tc\+
D)APPE#D
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%A..!H4 # ) &"ibera%&o<1eios * + ,,' 1Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
&"ibera%&o<1eios ":gico
Se o va&or ?or .2.( &ibera to7os os registros b&o<1ea7os
anterior0ente #&oc8s+. Se ?or .D.( to7os os b&o<1eios
anteriores so 0anti7os. Va&or 7e?a1&t: .2.
Retorno
2i3o 4escri5o
#H-"C+ Retorno n1&o.
4escri5o
4%A..!H4#+ acrescenta 0ais 10 registro e0 branco no ?ina& 7a tabe&a corrente. Se
no Bo1ver erro 7a R44( o registro 9 acrescenta7o e b&o<1ea7o.
D)%LEARALLF!LTER
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"!ARA""DE"2!R # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"!ARA""DE"2!R#+ sa&va as at1a&iFa5es rea&iFa7as e 3en7entes 7e to7as as
tabe&as e 7e3ois &i03a as con7i5es 7e ?i&tro 7e to7as as tabe&as.
D)%LEARALLF!LTER
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"!ARA""DE"2!R # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"!ARA""DE"2!R#+ sa&va as at1a&iFa5es rea&iFa7as e 3en7entes 7e to7as as
tabe&as e 7e3ois &i03a as con7i5es 7e ?i&tro 7e to7as as tabe&as.
D)%LEARF!LTER
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"!ARDE"2!R # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"!ARDE"2!R#+ sa&va as at1a&iFa5es rea&iFa7as e 3en7entes na tabe&a corrente e
7e3ois &i03a to7as as con7i5es 7e ?i&tro 7a or7e0 ativa no 0o0ento. Se1
?1nciona0ento 9 o3osto ao co0an7o S!2 DE"2!R.
D)%LEAR!#DE$
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"!AREH4!T # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"!AREH4!T#+ sa&va as at1a&iFa5es 3en7entes na tabe&a corrente e ?ecBa to7os os
ar<1ivos 7e An7ice 7a @rea 7e traba&Bo. .or conse<bncia( &i03a to7as as or7ens 7a &ista.
Se1 ?1nciona0ento 9 o3osto ao co0an7o S!2 EH4!T.
D)%LOSEALL
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"CS!A"" # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"CS!A""#+ sa&va as at1a&iFa5es 3en7entes( &ibera to7os os registros
b&o<1ea7os e ?ecBa to7as as tabe&as abertas #@reas 7e traba&Bo+ co0o se
cBa0asse 4%6"CS!AR!A 3ara ca7a @rea 7e traba&Bo.
!e03&o
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%6"CS!A"" 3ara ?ecBar a @rea
7e traba&Bo at1a&.
-S! 6&ientes H!R
4%S!2EH4!T#XHo0eX+ // Abre o ar<1ivo 7e An7ice XHo0eX
-S! Dornece7ores H!R
4%S!2EH4!T#XE7a7eX+ // Abre o ar<1ivo 7e An7ice XE7a7eX
...
4%6"CS!A""#+ //DecBa to7as as @reas 7e traba&Bo( to7os os in7ices e or7ens
D)%LOSEAREA
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6"CS!AR!A # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6"CS!AR!A#+ sa&va as at1a&iFa5es 3en7entes na tabe&a corrente( &ibera to7os os
registros b&o<1ea7os e ?ecBa a tabe&a corrente #@rea 7e traba&Bo+.
Se1 ?1nciona0ento 9 se0e&Bante ao co0an7o 6"CS! e 9 o3osto N ?1n5o
4%-S!AR!A e ao co0an7o -S!.
D)%OMM!T
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6CKKE2 # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6CKKE2#+ sa&va e0 7isco to7as as at1a&iFa5es 3en7entes na @rea 7e
traba&Bo corrente.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%6CKKE2 3ara sa&var to7as as
a&tera5es rea&iFa7as na @rea 7e traba&Bo at1a&.
-S! 6&ientes H!R
4%JC2C#100+
Ho0e :_ XQoseX
-S! Dornece7ores H!R
4%JC2C#168+
Ho0e :_ XQoaoX
4%6CKKE2#+ // Sa&va e0 7isco a3enas as a&tera5es rea&iFa7as na tabe&a Dornece7ores
D)%OMM!TALL
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6CKKE2A"" # + ,,' 1Ret
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6CKKE2A""#+ sa&va e0 7isco to7as as at1a&iFa5es 3en7entes e0 to7as
as @reas 7e traba&Bo.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%6CKKE2A"" 3ara sa&var to7as
as a&tera5es rea&iFa7as nas @reas 7e traba&Bo abertas no 0o0ento.
-S! 6&ientes H!R
4%JC2C#100+
Ho0e :_ XQoseX
-S! Dornece7ores H!R
4%JC2C#168+
Ho0e :_ XQoaoX
4%6CKKE2A""#+
// Sa&va e0 7isco as a&tera5es rea&iFa7as nas tabe&as 6&ientes e Dornece7ores
D)%REATE
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6R!A2! # $ cHCK! ' ( $ a!S2R-2-RA ' ( ) cc4REV!R * + ,,' 1Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
cHCK! 6aracter
Ho0e 7o ar<1ivo 7a tabe&a a ser cria7a #abaio 7o
XRoot.atBX+.
a!S2R-2-RA ArraM
"ista co0 as in?or0a5es 7os ca03os 3ara ser cria7a a
tabe&a.
c4REV!R 6aracter
Ho0e 7o R44 a ser 1ti&iFa7o 3ara a cria5o 7a tabe&a. Se
?or o0iti7o ser@ cria7a co0 o corrente.
Retorno
2i3o 4escri5o
6aracter HenB10
4escri5o
4%6R!A2!#+ 9 1ti&iFa7a 3ara criar 10 novo ar<1ivo 7e tabe&a c1=o no0e
est@ es3eci?ica7o atrav9s 7o 3ri0eiro 3ar/0etro #cHo0e+ e estr1t1ra atrav9s 7o seg1n7o
#a!str1t1ra+.
A estr1t1ra 9 es3eci?ica7a atrav9s 7e 10 arraM co0 to7os os ca03os(
on7e ca7a ca03o 9 e3resso atrav9s 7e 10 arraM conten7o `Ho0e( 2i3o( 2a0anBo(
4eci0aisa( co0o visto no ee03&o a seg1ir.
!e03&o:
// !ste ee03&o 0ostra co0o se 3o7e criar novo ar<1ivo 7e tabe&a atrav9s 7a ?1n5o
4%6R!A2!:
"C6A" a!str1t1ra :_``6o7(H(O(0a(`Ho0e(6(10(0a(`E7a7e(H(O(0a(`Hasc(4(8(0a
(`.agto(H(7(2aa
4%6R!A2!#X^teste^a0igos.X(a!str1t1ra+
// 6ria a tabe&a co0 o R44 corrente
-S! X^teste^a0igos.X VEA X4%D64TX H!R
D)%REATE!#DE$
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%6R!A2!EH4!T # $ cHCK! ' ( $ c!T.6[AV! ' ( ) b!T.6[AV! * (
) &-HE6C * + ,,' 1Ret
.ar/0etros
Arg10ento 2i3o 4escri5o
cHCK! 6aracter Ho0e 7o ar<1ivo 7e An7ice a ser cria7o.
c!T.6[AV! 6aracter
!3resso 7as cBaves 7o An7ice a ser cria7o na ?or0a 7e
string.
b!T.6[AV! 6o7e,%&oc8
!3resso 7as cBaves 7o An7ice a ser cria7o na ?or0a
eec1t@ve&.
&-HE6C ":gico 6ria An7ice co0o >nico #o 3a7ro 9 .D.+.
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%6R!A2!EH4!T#+ 9 1ti&iFa7a 3ara criar 10 novo ar<1ivo 7e An7ice co0 o no0e
es3eci?ica7o atrav9s 7o 3ri0eiro 3ar/0etro( sen7o <1e se o 0es0o eistir 9 7e&eta7o e
cria7o o novo. .ara tanto so eec1ta7os os 3assos a seg1ir:
, Sa&va ?isica0ente as a&tera5es ocorri7as na tabe&a correnteY
, DecBa to7os os ar<1ivos 7e An7ice abertosY
, 6ria o novo An7iceY
, Seta o novo An7ice co0o a or7e0 correnteY
, .osiciona a tabe&a corrente no 3ri0eiro registro 7o An7ice.
6o0 ece5o 7o R44 6tree( a tabe&a corrente no 3recisa estar aberta e0 0o7o
ec&1sivo 3ara a cria5o 7e An7ice( 3ois na cria5o 7e An7ices no 6tree 9 a&tera7a a
estr1t1ra 7a tabe&a( 3recisan7o 3ara isto a tabe&a estar aberta e0 0o7o ec&1sivo.
!e03&o:
// !ste ee03&o 0ostra co0o se 3o7e criar novo ar<1ivo 7e An7ice crian7o a or7e0
sobre os ca03os Ho0e e !n7 e no aceitar@ 713&ica5o:
-S! 6&iente VEA X4%D64TX H!R
4%6R!A2!EH4!T#X^teste^in72.c7X(XHo0ed!n7X(` ee Ho0ed!n7 a(.2.+
D)DELETE
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%4!"!2! # + ,,' 1Ret
Retorno
2i3o 4escri5o
6aracter HenB10
4escri5o
4%4!"!2!#+ 0arca o ar<1ivo corrente co0o 7e&eta7o. .ara ?i&trar os ar<1ivos
0arca7os 3o7e,se 1ti&iFar o co0an7o S!2 4!"!2!4 e 3ara 7e&et@,&os ?isica0ente
3o7e,se 1ti&iFar o co0an7o .A6f.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar a ?1n5o 4%4!"!2!#+ 3ara 0arcar
a&g1ns registros co0o 7e&eta7os e o .A6f 3ara 7e&et@,&os ?isica0ente.
-S! 6&ientes H!R
4%JC2C#100+
4%4!"!2!#+
4%JC2C#105+
4%4!"!2!#+
4%JC2C#110+
4%4!"!2!#+
.A6f
D)EVAL
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%!VA" # $ b%"C6C ' ( ) bDCR6CH4 * ( ) bR[E"!6CH4 * ( ) n.RCTR!JS * (
) nR!6HC * ( ) &R!S2AH2! * + ,,' 1R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
b%"C6C 6o7e,%&oc8
!3resso na ?or0a eec1t@ve& a ser reso&vi7a 3ara ca7a
registro 3rocessa7o.
bDCR6CH4 6o7e,%&oc8
!3resso na ?or0a eec1t@ve& a ser reso&vi7a 3ara
veri?icar se o registro e0 <1esto est@ 7entro 7o esco3o
7e?ini7o.
bR[E"!6CH4 6o7e,%&oc8
!3resso na ?or0a eec1t@ve& a ser reso&vi7a 3ara
veri?icar at9 <1a& registro ser@ 3rocessa7o #at9 o b&oco
retornar .D.+.
n.RCTR!JS H109rico
H>0ero 7e registros a ser 3rocessa7o a 3artir 7o registro
corrente.
nR!6HC H109rico
E7enti?ica5o 7e 7eter0ina7o registro a ser reso&vi7a a
e3resso #recno+.
&R!S2AH2! ":gico .rocessa o restante 7os registro.
Retorno
2i3o 4escri5o
6aracter Retorno n1&o.
4escri5o
4%!VA"#+ 9 1ti&iFa7a 3ara eec1tar 10a e3resso 7e?ini7a 3e&o b&oco
7e c:7igo 7o 3ri0eiro 3ar/0etro 3ara ca7a registro <1e est@ 7entro 7o
esco3o 7e?ini7o atrav9s 7os b&ocos 7e con7i5o 7e X?orX e XSBi&eX.
C n>0ero 7e registros a ser eec1ta7o ser@ 7e?ini7o co0 o 3ar/0etro
n.roRegs o1 se seta7o o 3ar/0etro &Restante sero eec1ta7os to7os
os registros a 3artir 7o registro corrente at9 o ?ina& 7a tabe&a corrente.
Se ?or es3eci?ica7o o 3ar/0etro nRecno a3enas o registro co0 o recno es3eci?ica7o ser@
3rocessa7o. Se ?ore0 o0iti7os os b&ocos 7e X?orX e XSBi&eX(
os 0es0os sero consi7era7os .2. co0o 3a7ro( esto assi0 to7os os registros 7entro
7o esco3o. Se o 3ar/0etro &Restante ?or o0iti7o a tabe&a inicia o 3rocessa0ento 7os
registros a 3artir 7o to3o 7a tabe&a( caso contr@rio sero 3rocessa7os os registros a 3artir
7o 3osiciona0ento corrente 7a tabe&a.
!e03&o:
// !ste ee03&o 0ostra co0o se 3o7e 1sar o 4%!VA" 3ara contar <1antos registros
esto 7entro 7o esco3o es3eci?ica7o e0 to7a a tabe&a( 3ois co0o o 3ar/0etro &Restante
?oi o0iti7o a tabe&a ir@ 3ara o to3o antes 7e iniciar a 3rocessar os registros. S13on7o
<1e a tabe&a est@ sobre 10 An7ice no ca03o i7a7e( sero 3rocessa7os registros co0 o
Ho0e c1=a or7e0 a&?ab9tica 9 0aior <1e XDDDDDX e at9 encontrar a&g10 registro 7e
i7a7e ig1a& a I0:
-S! 6&iente VEA X4%D64TX H!R
"C6A" n6o1nt :_ 0Y
4%JC2C#100+
4%!VA"# `ee n6o1ntdda( `ee Ho0e ' XDDDDDXa( `ee E7a7e $ I0a+
// !ste ee03&o 0ostra co0o se 3o7e 1sar o 4%!VA" 3ara contar <1antos registros
esto 7entro 7o esco3o es3eci?ica7o #co0o o ee03&o anterior+ a 3artir 7o registro at1a&
#100+:
-S! 6&iente VEA X4%D64TX H!R
"C6A" n6o1nt :_ 0Y
4%JC2C#100+
4%!VA"# `ee n6o1ntdda( `ee Ho0e ' XDDDDDXa( `ee E7a7e $ I0a(((.2.+
// !ste ee03&o 0ostra co0o se 3o7e 1sar o 4%!VA" 3ara co&ocar n10a vari@ve& 10
no0e inicia& <1e est@ 7e?ini7o e0 10 registro 7e recno 7e?ini7o #100+:
-S! 6&iente VEA X4%D64TX H!R
"C6A" cHo0eEni :_ XX
4%!VA"# `ee cHo0eEni :_ Ho0ea((((100+
// !ste ee03&o 0ostra co0o se 3o7e 1sar o 4%!VA" 3ara veri?icar <1a& 9 o recno 7o
79ci0o registro a 3artir 7o corrente 7entro 7o esco3o 7e?ini7o:
-S! 6&iente VEA X4%D64TX H!R
"C6A" nRecno :_ 0Y
4%JC2C#100+
4%!VA"# `ee nRecno :_ R!6HC#+a( `ee Ho0e ' XDDDDDXa( `ee E7a7e $ I0a(10((.2.+
D)F
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%D # + ,,' cA&ias
Retorno
2i3o 4escri5o
6aracter
Retorna o A&ias corrente. 6aso no eista A&ias corrente retorna XX #String
vaFia+.
4escri5o
4%D#+ veri?ica <1a& 9 o A&ias 7a @rea 7e traba&Bo corrente. C A&ias 9 7e?ini7o
<1an7o a tabe&a 9 aberta atrav9s 7o 3ar/0etro corres3on7ente #4%-S!AR!A#++. !sta
?1n5o 9 o inverso 7a ?1n5o S!"!62#+( 3ois nesta 9 retorna7o o n>0ero 7a @rea 7e
traba&Bo 7o A&ias corres3on7ente.
!e03&o:
// !ste ee03&o 0ostra co0o o 4%D corrente 3o7e ser 0ostra7o 3ara o 1s1@rio.
7b-seArea# .2.(X7b?c7a7sX( X^7a7osa7v609^sa1990.7b?X(XSSSX(.2.( .D. +
Kessage%o#XC A&ias corrente 9: Xd4%D#+(XA&iasX( 0+ //Res1&ta7o: XC A&ias corrente 9:
SSSX
D)F!ELD!#FO
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%DE!"4EHDC # $ nEHDC2E.C ' ( $ n6AK.C ' + ,,' EHDC
.ar/0etros
Arg10ento 2i3o 4escri5o
nEHDC2E.C H109rico
2i3o 7e in?or0a5o a ser veri?ica7a #4%SP4!6(
4%SP"!H e 4%SP2L.!+.
n6AK.C H109rico .osi5o 7o ca03o a ser veri?ica7o.
Retorno
2i3o 4escri5o
#;1a&<1er+
Retorna HE" se no B@ tabe&a corrente o1 a 3osi5o 7o ca03o
es3eci?ica7o est@ inv@&i7a.
En?or0a5o 7o ca03o En?or0a5o re<1isita7a 3e&o 1s1@rio #3o7e ser 7e
ti3o n109rico se ?or ta0anBo o1 casas 7eci0ais( ti3o caracter se ?or no0e
o1 ti3o+.
4escri5o
4%DE!"4EHDC#+ 9 1ti&iFa7a 3ara obter in?or0a5es sobre 7eter0ina7o ca03o 7a
tabe&a corrente. C ti3o 7e in?or0a5o #3ri0eiro arg10ento+ 9 esco&Bi7o 7e acor7o co0
as constantes abaio:
4%SP4!6 , H>0ero 7e casas 7eci0ais #ti3o n109rico+
4%SP"!H , 2a0anBo #ti3o n109rico+
4%SP2L.! , 2i3o #ti3o caracter+
A 3osi5o 7o ca03o no &eva e0 consi7era5o os ca03os internos 7o .rotBe1s #recno e
7e&ete7+.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%DE!"4EHDC 3ara obter as
in?or0a5es 7o 3ri0eiro ca03o 7a tabe&a 6&ientes.
-S! 6&ientes H!R
4%DE!"4EHDC#4%SPHAK!(1+ // Retorno: Ho0e
4%DE!"4EHDC#4%SP2L.!(1+ // Retorno: 6
4%DE!"4EHDC#4%SP"!H(1+ // Retorno: 10
4%DE!"4EHDC#4%SP4!6(1+ // Retorno: 0
D)F!LTER
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%DE"2!R # + ,,' c!T.DE"2RC
Retorno
2i3o 4escri5o
6aracter
Retorna a e3resso 7o ?i&tro ativo na @rea 7e traba&Bo at1a&. 6aso no
eista ?i&tro ativo retorna XX #String vaFia+.
4escri5o
4%DE"2!R#+ 9 1ti&iFa7a 3ara veri?icar a e3resso 7e ?i&tro ativo na @rea 7e traba&Bo
corrente.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%DE"2!R 3ara veri?icar a
e3resso 7o ?i&tro corrente.
-S! 6&iente EH4!T En71 H!R
S!2 DE"2!R 2C Ho0e ' XQoseX
4%DE"2!R#+ // retorna: Ho0e ' XQoseX
S!2 DE"2!R 2C H10 $ 1000
4%DE"2!R#+ // retorna: H10 $ 1000
D)GO)OTTOM
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%JC%C22CK # + ,,' 1R!2
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%JC%C22CK#+ 9 1ti&iFa7a 3ara 3osicionar a tabe&a corrente no >&ti0o registro
&:gico. A se<bncia &:gica 7e3en7e 7a or7e0 e 7o ?i&tro ativo sobre a tabe&a corrente(
3ortanto o >&ti0o registro &:gico 3o7e no ser o >&ti0o registro ?Asico.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%JC%C22CK 3ara 3osicionar no
>&ti0o registro ?Asico.
-S! 6&iente
4%JC%C22CK#+ // .osiciona no >&ti0o registro ?Asico( 3ois no B@ or7e0 ativa
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%JC%C22CK 3ara 3osicionar no
>&ti0o registro &:gico.
-S! 6&iente EH4!T En71 H!R
4%JC%C22CK#+ // .osiciona no >&ti0o registro &:gico #>&ti0o registro na se<bncia
gera7a 3e&o An7ice+
D)GOTOP
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%JC2C. # + ,,' 1R!2
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%JC2C.#+ 9 1ti&iFa7a 3ara 3osicionar a tabe&a corrente no 3ri0eiro registro &:gico. A
se<bncia &:gica 7e3en7e 7a or7e0 e 7o ?i&tro ativo sobre a tabe&a corrente( 3ortanto o
3ri0eiro registro &:gico 3o7e no ser o 3ri0eiro registro ?Asico.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%JC%C2C. 3ara 3osicionar no
3ri0eiro registro ?Asico.
-S! 6&iente
4%JC2C.#+ // .osiciona no 3ri0eiro registro ?Asico( 3ois no B@ or7e0 ativa
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%JC2C. 3ara 3osicionar no
3ri0eiro registro &:gico.
-S! 6&iente EH4!T En71 H!R
4%JC2C.#+ // .osiciona no 3ri0eiro registro &:gico #3ri0eiro registro na segbncia
gera7a 3e&o An7ice+
D)GOTO
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%JC2C # + ,,' 1R!2
Retorno
2i3o 4escri5o
#H-"C+ Retorno n1&o.
4escri5o
4%JC2C#+ 9 1ti&iFa7o 3ara 3osicionar a tabe&a corrente e0 7eter0ina7o registro(
seg1n7o a or7e0 ?Asica #se<bncia sobre o recno+.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%JC2C 3ara 3osicionar a tabe&a
corrente e0 7eter0ina7o registro.
-S! 6&iente EH4!T En71 H!R
4%JC2C#100+ // .osiciona no registro 7e recno 100
D)!#FO
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%EHDC # $ nEHDC2E.C ' + ,,' EHDC
.ar/0etros
Arg10ento 2i3o 4escri5o
nEHDC2E.C H109rico 2i3o 7e in?or0a5o a ser veri?ica7a.
Retorno
2i3o 4escri5o
#;1a&<1er+
En?or0a5o 7a 2abe&a En?or0a5o re<1isita7a 3e&o 1s1@rio #o ti3o 7e3en7e
7a in?or0a5o re<1isita7a+. Se no Bo1ver tabe&a corrente retorna HE".
4escri5o
4%EHDC#+ 9 1ti&iFa7a 3ara obter in?or0a5es sobre a tabe&a corrente. C ti3o 7e
in?or0a5o #3ri0eiro arg10ento+ 9 esco&Bi7o 7e acor7o co0 as constantes abaio:
4%EPJ!2R!6SEV! , 2a0anBo 7o registro e0 n>0ero 7e bMtes si0i&ar a R!6SEV!
#ti3o n109rico+
4%EP2A%"!!T2 , !tenso 7o ar<1ivo 7a tabe&a corrente #ti3o caracter+
4%EPD-"".A2[ , Ho0e 7a tabe&a corrente co0 ca0inBo co03&eto #ti3o caracter+
4%EP%CD , Veri?ica se est@ 3osiciona7a no inAcio 7a tabe&a si0i&ar a %CD #ti3o &:gico+
4%EP!CD , Veri?ica se est@ 3osiciona7a no ?ina& 7a tabe&a si0i&ar a !CD #ti3o &:gico+
4%EPDC-H4 , Veri?ica se a tabe&a est@ 3osiciona7a a3:s 10a 3es<1isa si0i&ar a
DC-H4 #ti3o &:gico+
4%EPD6C-H2 , H>0ero 7e ca03os na estr1t1ra 7a tabe&a corrente si0i&ar a D6C-H2
#ti3o n109rico+
4%EPA"EAS , Ho0e 7o A&ias 7a @rea 7e traba&Bo corrente si0i&ar a A"EAS #ti3o
caracter+
4%EP"AS2-.4A2! , Veri?ica a 7ata 7a >&ti0a 0o7i?ica5o si0i&ar a "-.4A2! #ti3o
7ata+
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%EHDC 3ara obter as in?or0a5es
7a tabe&a corrente #6&ientes+.
-S! 6&ientes H!R
4%EHDC#4%EPD-"".A2[+ // Retorno: 6:^2este^6&ientes.7b?
4%EHDC#4%EPD6C-H2+ // Retorno: 12
4%JC2C.#+
4%EHDC#4%EP%CD+ // Retorno: .D.
4%SfE.#,1+
4%EHDC#4%EP%CD+ // Retorno: .2.
D)ORDER!#FO
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%CR4!REHDC # $ nEHDC2E.C ' + ,,' EHDC
.ar/0etros
Arg10ento 2i3o 4escri5o
nEHDC2E.C H109rico Ho0e 7o ar<1ivo 7e An7ice.
Retorno
2i3o 4escri5o
6aracter
Retorna a in?or0a5o 7a Cr7e0 re<1isita7a 3e&o 1s1@rio #3o7e ser 7e ti3o
n109rico se ?or n>0ero 7e or7ens no An7ice( ti3o caracter se ?or no0e 7o
ar<1ivo 7e An7ice+. 6aso no eista or7e0 corrente o1 a 3osi5o 7a or7e0
es3eci?ica7a est@ inv@&i7a retorna HE".
4escri5o
4%CR4!REHDC#+ 9 1ti&iFa7a 3ara obter in?or0a5es sobre 7eter0ina7a or7e0.
A es3eci?ica5o 7a or7e0 3o7e ser rea&iFa7a atrav9s 7e se1 no0e o1 s1a
3osi5o 7entro 7a &ista 7e or7ens( 0as se e&a no ?or es3eci?ica7a sero
obti7as in?or0a5es 7a or7e0 corrente.
C ti3o 7e in?or0a5o #3ri0eiro arg10ento+ 9 esco&Bi7o 7e acor7o co0
as constantes abaio:
4%CEP%AJHAK! , Ho0e 7o ar<1ivo 7e An7ice ao <1a& a or7e0 3ertence #ti3o
caracter+.
4%CEPD-"".A2[ , Ho0e 7o ar<1ivo 7e An7ice #co0 se1 7iret:rio+ ao <1a& a or7e0
3ertence #ti3o caracter+
4%CEPCR4!R6C-H2 , H>0ero 7e or7ens eistentes no ar<1ivo 7e An7ice
es3eci?ica7o
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%CR4!REHDC 3ara obter
in?or0a5es sobre o no0e 7o ar<1ivo 7e An7ice 7a or7e0 corrente.
4%CR4!REHDC#4%CEP%AJHAK!+ // retorna: En7
4%CR4!REHDC#4%CEPD-"".A2[+ // retorna: 6:^A.6^2este^En7.c7
D)ORDER#!%*#AME
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%CR4!RHE6fHAK! # $ cA.!"E4C ' + ,,' &R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
cA.!"E4C 6aracter Ho0e 7o a3e&i7o 7a or7e0 a ser seta7a.
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no conseg1i1 tornar a or7e0 ativa. .rinci3ais erros: Ho
eiste tabe&a ativa o1 no ?oi encontra7a a or7e0 co0 o a3e&i7o.
Retorna Ver7a7eiro se a or7e0 ?oi seta7a co0 s1cesso.
4escri5o
4%CR4!RHE6fHAK!#+ 9 1ti&iFa7a 3ara se&ecionar a or7e0 ativa atrav9s 7e se1
a3e&i7o. !sta or7e0 9 a res3ons@ve& se<bncia &:gica 7os registros 7a tabe&a corrente.
!e03&o:
//!ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%CR4!RHE6fHAK! 3ara setar
nova or7e0.
-S! 6&iente H!R
S!2 EH4!T 2C Ho0e( E7a7e
ED ]4%CR4!RHE6fHAK!#XEn7Ho0eX+
Kessagebo#XRegistro no encontra7oX(X!rroX( 0+
!H4ED
D)RE%ALL
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R!6A"" # + ,,' 1R!2
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%R!6A""#+ 9 1ti&iFa7a 3ara retirar a 0arca 7e registro 7e&eta7o 7o registro at1a&.
.ara ser eec1ta7a o registro at1a& 7eve estar b&o<1ea7o o1 a tabe&a 7eve estar aberta e0
0o7o ec&1sivo. Se o registro at1a& no estiver 7e&eta7o( esta ?1n5o no ?aF na7a. !&a 9
o o3osto 7a ?1n5o 4%4!"!2! <1e 0arca o registro at1a& co0o 7e&eta7o.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%R!6A"" 3ara retornar o esta7o
7o registro at1a& 3ara nor0a&.
-S! 6&iente
4%JC2C#100+
4%4!"!2!#+
4!"!2!4#+ // Retorna: .2.
4%R!6A""#+
4!"!2!4#+ // Retorna: .D.
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%R!6A"" 3ara 7es?aFer to7as as
7e&e5es 7a tabe&a corrente.
-S! 6&iente
4%JC2C.#+
R[E"! ]!CD#+
4%R!6A""#+
4%SfE.#+
!H44C
D)RE%ORD!#FO
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R!6CR4EHDC # $ nEHDC2E.C ' ( ) nR!JES2RC * + ,,' EHDC
.ar/0etros
Arg10ento 2i3o 4escri5o
nEHDC2E.C H109rico 2i3o 7e in?or0a5o a ser veri?ica7a.
nR!JES2RC H109rico H>0ero 7o registro a ser veri?ica7o.
Retorno
2i3o 4escri5o
#;1a&<1er+
Ho B@ tabe&a corrente o1 registro inv@&i7o.
En?or0a5o 7o Registro. En?or0a5o re<1isita7a
3e&o 1s1@rio #o ti3o 7e3en7e 7a in?or0a5o re<1isita7a+.
4escri5o
4%R!6CR4EHDC#+ 9 1ti&iFa7a 3ara obter in?or0a5es sobre o registro es3eci?ica7o
3e&o seg1n7o arg10ento #recno+ 7a tabe&a corrente( se esta in?or0a5o ?or o0iti7a ser@
veri?ica7o o registro corrente. C ti3o 7e in?or0a5o
#3ri0eiro arg10ento+ 9 esco&Bi7o 7e acor7o co0 as constantes abaio:
4%REP4!"!2!4 , !sta7o 7e 7e&eta7o si0i&ar a 4!"!2!4 #ti3o &:gico+
4%REPR!6SEV! , 2a0anBo 7o registro si0i&ar a R!6SEV! #ti3o n109rico+
4%REP-.4A2!4 , Veri?ica se o registro ?oi a&tera7o e ain7a no ?oi at1a&iFa7o
?isica0ente si0i&ar a -.4A2!4 #ti3o &:gico+
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%R!6CR4EHDC 3ara se obter as
in?or0a5es sobre registros 7a tabe&a corrente.
-S! 6&ientes H!R
4%JC2C#100+
4%R!6CR4EHDC#4%REP4!"!2!4+ // Retorno: .D.
4%4!"!2!#+
4%R!6CR4EHDC#4%REP4!"!2!4+ // Retorno: .D.
4%R!6A""#+
4%R!6CR4EHDC#4%REPR!6SEV!+ // Retorno: 2O0
HCK! :_ XQCACX
4%JC2C#200+
4%R!6CR4EHDC#4%REP-.4A2!4+ // Retorno: .D.
4%R!6CR4EHDC#4%REP-.4A2!4(100+ // Retorno: .2.
D)RE!#DE$
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R!EH4!T # + ,,' 1R!2
Retorno
2i3o 4escri5o
#H-"C+ HenB10
4escri5o
4%R!EH4!T#+ reconstr:i to7os os An7ices 7a @rea 7e traba&Bo corrente e 3osiciona as
tabe&as no 3ri0eiro registro &:gico.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%R!EH4!T 3ara reconstr1ir os
An7ices 7e3ois <1e 10 novo An7ice ?oi gera7o.
-S! 6&ientes H!R
4%S!2EH4!T#XEn7Ho0eX+
4%R!EH4!T#+
D)RLO%*
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R"C6f # ) nR!JES2RC * + ,,' &R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
nR!JES2RC H109rico H>0ero 7o registro a ser b&o<1ea7o.
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no conseg1i1 b&o<1ear o registro. .rinci3a& 0otivo: o
registro =@ ?oi b&o<1ea7o 3or o1tro 1s1@rio.
Retorna Ver7a7eiro se o registro ?oi b&o<1ea7o co0 s1cesso
4escri5o
4%R"C6f#+ 9 1ti&iFa7a <1an7o se te0 10a tabe&a aberta e co03arti&Ba7a e se 7ese=a
b&o<1ear 10 registro 3ara <1e o1tros 1s1@rios no 3ossa0 a&ter@,&o.
Se a tabe&a =@ est@ aberta e0 0o7o ec&1sivo( a ?1n5o no a&tera se1 esta7o.
C 1s1@rio 3o7e esco&Ber o registro a ser b&o<1ea7o atrav9s 7o 3ar/0etro
#recno+( 0as se este ?or o0iti7o ser@ b&o<1ea7o o registro corrente co0o na ?1n5o
R"C6f#+.
!sta ?1n5o 9 o o3osto N 4%R-H"C6f( <1e &ibera registros b&o<1ea7os.
!e03&o
// !ste ee03&o 0ostra 71as varia5es 7o 1so 7e 4%R"C6f.
4%-S!AR!A# .2.(X7b?c7a7sX( X^7a7osa7v609^sa1990.7b?X(XSSSX(.2.( .D. +
4%JC2C#100+
4%R"C6f#+ // %&o<1eia o registro at1a& #100+
4%R"C6f#110+ // %&o<1eia o registro 7e n>0ero 110
D)RLO%*L!ST
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R"C6f"ES2 # + ,,' aR!2
Retorno
2i3o 4escri5o
ArraM
Retorna HE" se no eiste tabe&a corrente o1 no eiste nenB10
registro &oca7o.
Retorna a &ista co0 os recnos 7os registros &oca7os na tabe&a corrente.
4escri5o
4%R"C6f"ES2#+ 9 1ti&iFa7a 3ara veri?icar <1ais registros esto &oca7os na tabe&a
corrente. .ara tanto( 9 retorna7a 10a tabe&a 1ni7i0ensiona& co0 os n>0eros 7os
registros.
!e03&o:
// !ste ee03&o 0ostra co0o 9 1ti&iFa7a a ?1n5o 4%R"C6f"ES2 3ara veri?icar <1ais
registros esto b&o<1ea7os na tabe&a corrente:
4%-S!AR!A# .2.(X7b?c7a7sX( X^7a7osa7v609^sa1990.7b?X(XSSSX(.2.( .D. +
4%JC2C.#+
4%R"C6f#+ // %&o<1eia o 3ri0eiro registro
4%R"C6f#110+ // %&o<1eia o registro 7e n>0ero 110
4%R"C6f#100+ // %&o<1eia o registro 7e n>0ero 100
4%R"C6f"ES2#+ // Retorna: `1(100(110a
D)R"#LO%*
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%R-H"C6f # ) nR!JES2RC * + ,,' 1R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
nR!JES2RC H109rico H>0ero 7o registro a ser 7esb&o<1ea7o.
Retorno
2i3o 4escri5o
#H-"C+ Se0 retorno.
4escri5o
4%R-H"C6f#+ 9 1ti&iFa7a 3ara &iberar 7eter0ina7o registro b&o<1ea7o. C 1s1@rio
3o7e esco&Ber o registro a ser 7esb&o<1ea7o atrav9s 7o 3ar/0etro
#recno+( 0as se este ?or o0iti7o ser@ 7esb&o<1ea7o o registro corrente co0o na ?1n5o
4%-H"C6f#+.
!sta ?1n5o 9 o o3osto N 4%R"C6f( <1e b&o<1ea os registros.
!e03&o:
// !ste ee03&o 0ostra 71as varia5es 7o 1so 7e 4%R-H"C6f.
4%-S!AR!A# .2.(X7b?c7a7sX( X^7a7osa7v609^sa1990.7b?X(XSSSX(.2.( .D. +
4%JC2C#100+
4%R-H"C6f#+ //4esb&o<1eia o registro at1a& #100+
4%R-H"C6f#110+ // 4esb&o<1eia o registro 7e n>0ero 110
D)SEE*
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S!!f # $ !T. ' ( ) &SCD2S!!f * ( ) &-"2EKC * + ,,' &R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
!T. #;1a&<1er+
Va&or 7e cBave a ser encontra7o 7o ti3o caracter #to7os os
ti3os 7e e3resso 7e An7ice co0 ece5o 7o An7ice co0
a3enas 10 ca03o 7o ti3o n109rico+.
&SCD2S!!f ":gico
.osiciona no 3ri0eiro registro co0 e3resso 7e cBave
0aior <1e o va&or 3roc1ra7o. C 3a7ro 9 .D.
&-"2EKC ":gico
.roc1ra a >&ti0a ocorrncia 7o va&or 3roc1ra7o. C 3a7ro
9 .D.
Retorno
2i3o 4escri5o
":gico
Retorna Da&so se no ?oi encontra7o nenB10 registro co0 o va&or
es3eci?ica7o.
Retorna Ver7a7eiro se ?oi encontra7o 10 registro co0 o va&or es3eci?ica7o
4escri5o
4%S!!f#+ 9 1ti&iFa7a 3ara encontrar 10 registro co0 7eter0ina7o va&or 7a e3resso
7e cBave 7e An7ice. Antes 7a cBa0a7a 7o 4%S!!f 7eve,se certi?icar 7e <1e eiste 10a
or7e0 ativa no 0o0ento co0 os ca03os <1e se 7ese=a 3es<1isar o va&or. Se a e3resso
3oss1ir a3enas 10a ca03o n109rico( o 3ri0eiro 3ar/0etro 7eve ser 7o ti3o n109rico(
0as nos 7e0ais casos 7eve,se 1ti&iFar 10 va&or 7o ti3o caracter 3ara este 3ar/0etro
#0es0o se ?ore0 a3enas 7ois ca03os n109ricos o1 7o ti3o 7ata+.
;1an7o o seg1n7o 3ar/0etro ?or es3eci?ica7o co0o .2. #so?tsee8+( 0es0o
<1e a e3resso 3es<1isa7a no encontrar nenB10 registro co0 este va&or(
a tabe&a ser@ 3osiciona7a no 3r:i0o va&or 0aior <1e o es3eci?ica7o no
3ri0eiro 3ar/0etro( 0as 0es0o 3osicionan7o no 3r:i0o va&or esta ?1n5o
retornar@ .D. #3ois no encontro1+.
;1an7o no ?or es3eci?ica7o este va&or o1 estiver .D. e ?a&Bar o va&or 7e 3es<1isa( a
tabe&a ser@ 3osiciona7a e0 "AS2R!6 d 1 e ser@ seta7a a ?&ag 7e !CD.
Se o terceiro 3ar/0etro ?or es3eci?ica7o co0 va&or .2. a ?1n5o 3osiciona a tabe&a no
>&ti0o registro co0 o va&or 3roc1ra7o( caso no se=a es3eci?ica7o
o1 ?or .D.( ser@ 3osiciona7a na 3ri0eira ocorrncia.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!!f 3ara b1sca 7e va&ores
n109ricos.
-S! 6&ientes H!R
CR4"ES2A44 #X/teste/in71.c7X+ // !3resso 9 H10 #ca03o n109rico+
4%S!!f#100+ // Retorna: .D.
!CD#+ // Retorna: .2.
4%S!!f#100(.2.+ // Retorna: .D.
!CD#+ // Retorna: .D. #3ois o so?tsee8 3osiciono1 no 3r:i0o registro+
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!!f 3ara 3ercorrer to7os os
registros 7e 6&ientes co0 o no0e =oao e venci0entos a 3artir 7e =aneiro 7e 2001.
-S! 6&ientes H!R
CR4"ES2A44 #X/teste/in72.c7X+ // !3resso 9 Ho0edVenc #ca03o caracter d 7ata+
4%S!!f#X=oao200101X(.2.+ // .roc1ra a 3ri0eira ocorrncia 7e Ho0e X=oaoX e
venci0ento 0aior <1e Qaneiro 7e 2001
R[E"! ]!CD#+ .AH4. Ho0e __ X=oaoX
4%SfE.#+
!H44C
D)SETDR!VER
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S!24REV!R # ) cHCVCR44 * + ,,' c-"2EKCR44
.ar/0etros
Arg10ento 2i3o 4escri5o
cHCVCR44 6aracter Hovo no0e 7o R44 a ser 7e?ini7o co0o 3a7ro.
Retorno
2i3o 4escri5o
6aracter Ho0e 7o R44 3a7ro corrente
4escri5o
4%S!24REV!R#+ 3o7e ser 1ti&iFa7a a3enas 3ara veri?icar <1a& o R44 <1e est@
7e?ini7o co0o 3a7ro <1an7o ?or o0iti7o se1 3ar/0etro.
!&a ta0b90 3o7e ser 1ti&iFa7a 3ara es3eci?icar o1tro R44 co0o 3a7ro(
es3eci?ican7o,o atrav9s 7o 3ar/0etro.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!24REV!R 3ara a&terar o va&or
7o R44 3a7ro.
4%S!24REV!R#X62R!!64TX+ // Retorna: 4%D64T
4%S!24REV!R#+ // Retorna: 62R!!64T
D)SETF!LTER
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S!2DE"2!R # $ cb6CH4E6AC ' ( $ cc6CH4E6AC ' + ,,' 1R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
b6CH4E6AC 6o7e,%&oc8 !3resso 7o ?i&tro na ?or0a eec1t@ve&.
c6CH4E6AC 6aracter !3resso 7o ?i&tro na ?or0a 7e string.
Retorno
2i3o 4escri5o
#H-"C+ Se0 retorno.
4escri5o
4%S!2DE"2!R 9 1ti&iFa7a 3ara setar 10 ?i&tro nos registros 7a tabe&a corrente
es3eci?ica7o atrav9s 7o b&oco 7e c:7igo no 3ri0eiro 3ar/0etro. ;1an7o 10 registro no
est@ 7entro 7o ?i&tro seta7o e&e contin1a eistin7o ?isica0ente( 0as no &ogica0ente #nas
?1n5es 7e 0ani31&a5o 7e banco 7e 7a7os co0o 4%JC2C.( 4%S!!f( 4%SfE.( etc+.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!2DE"2!R 3ara ?i&trar to7os os
c&ientes co0 0enos 7e I0 anos.
-S! 6&iente H!R
4%S!2DE"2!R# `eeE7a7e $ I0a( XE7a7e $ I0X +
4%JC2C.#+
D)SET!#DE$
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S!2EH4!T # $ ccAR;EH4E6! ' + ,,' 1R!2
.ar/0etros
Arg10ento 2i3o 4escri5o
cAR;EH4E6! 6aracter Ho0e 7o ar<1ivo 7e An7ice( co0 o1 se0 7iret:rio
Retorno
2i3o 4escri5o
#H-"C+ Se0 retorno.
4escri5o
4%S!2EH4!T#+ 9 1ti&iFa7a 3ara acrescentar 10a o1 0ais or7ens 7e 7eter0ina7o
An7ice na &ista 7e or7ens ativas 7a @rea 7e traba&Bo. ;1an7o o ar<1ivo 7e An7ice 3oss1i
a3enas 10a or7e0( a 0es0a 9 acrescenta7a N &ista e torna,se ativa. ;1an7o o An7ice
3oss1i 0ais 7e 10a or7e0( to7as so acrescenta7as N &ista e a 3ri0eira torna,se ativa.
.ara se 1ti&iFar ar<1ivos 7e etenso 3a7ro 7o R44( este 7a7o 3o7e ser o0iti7o no
3ri0eiro 3ar/0etro( 0as caso contr@rio 7eve ser es3eci?ica7o.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!2EH4!T 3ara acrescentar
novos An7ices N &ista 7e or7ens.
-S! 6&iente H!R
4%S!2EH4!T#XEn71X+
4%S!2EH4!T#X^teste^En72.c7X+
D)SET#!%*#AME
Reviso: O0/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S!2HE6fHAK! # $ cEH4E6! ' ( ) cA.!"E4C * + ,,' cA.!"E4C
.ar/0etros
Arg10ento 2i3o 4escri5o
cEH4E6! 6aracter Ho0e 7a or7e0 <1e 7eve receber o a3e&i7o.
cA.!"E4C 6aracter Ho0e 7o a3e&i7o 7a or7e0 a ser seta7a.
Retorno
2i3o 4escri5o
6aracter
Retorna XX #String vaFia+ se no conseg1i1 encontrar a or7e0 es3eci?ica7a(
no conseg1i1 setar o a3e&i7o o1 no Bavia a3e&i7o.
Retorna o a3e&i7o corrente.
4escri5o
4%S!2HE6fHAK! 9 1ti&iFa7a 3ara co&ocar 10 a3e&i7o e0 7eter0ina7a or7e0
es3eci?ica7a 3e&o 3ri0eiro 3ar/0etro. 6aso se=a o0iti7o o no0e 7o a3e&i7o a ser 7a7o(
a ?1n5o a3enas veri?ica o a3e&i7o corrente.
!e03&o:
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar o 4%S!2HE6fHAK! 3ara setar 10
novo a3e&i7o e veri?icar <1a& o a3e&i7o at1a&.
-S! 6&iente H!R
4%S!2HE6fHAK!#XEn7Ho0eX+ // retorna: XX
4%S!2HE6fHAK!#XEn7Ho0eX(XHCK!X+ // retorna: XX
4%S!2HE6fHAK!#XEn7Ho0eX+ // retorna: XHCK!X
D)SETORDER
Reviso: 09/0I/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
4%S!2CR4!R # $ nCr7e0 ' + ,,' HE"
.ar/0etros
Arg10ento 2i3o 4escri5o
nCr7e0 H109rico
nCr7e0 corres3on7e ao n>0ero 7a 3osi5o 7a or7e0 na
&ista 7e or7ens ativas.
Retorno
2i3o 4escri5o
#H-"C+ !sta ?1n5o se03re retorna HE".
4escri5o
!sta ?1n5o 9 1ti&iFa7a 3ara se&ecionar a or7e0 ativa 7a @rea 7e traba&Bo. !sta or7e0 9 a
res3ons@ve& se<bncia &:gica 7os registros 7a tabe&a corrente.
!e03&o:
// Este exemplo demonstra como se pode utilizar o DBSETORDER
para selecionar a ordem corrente.
USE Cliente NEW
SET INDE TO Nome!Cep
DBSETORDER"#$
6aso se=a seta7a a or7e0 0 ( a tabe&a corrente na area 7e traba&Bo ser@ co&oca7a na
or7e0 nat1ra& ( isto 9( a or7e0 na <1a& os registros ?ora0 acrescenta7os( 3or90 os
in7ea7ores so 0anti7os abertos. Va&e sa&ientar <1e ( <1an7o a&tera0os a or7e0 at1a&
7e 10a 7eter0ina7a tabe&a ( o registro at1a& no 9 7es3osiciona7o.
D)S*!P
Reviso: 07/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%SfE. # ) HR!JES2RCS * + ,,' HE"
.ar/0etros
Arg10ento 2i3o 4escri5o
HR!JES2RCS H109rico
H>0ero 7e registros a ser 7es&oca7o a 3artir 7o corrente.
Se ?or 3ositivo( 7es&oca e0 7ire5o ao ?ina& 7a tabe&a. Se
?or negativo( ao inAcio 7a tabe&a. Va&or 7e?a1&t: 1.
Retorno
2i3o 4escri5o
6aracter Se0 retorno.
4escri5o
4es&oca 3ara o1tro registro na tabe&a corrente. !sta ?1n5o 9 1ti&iFa7a 3ara 7es&ocar 3ara
o1tro registro a 3artir 7o registro at1a&. C 7es&oca0ento 9 &:gico( o1 se=a( &eva e0
consi7era5o or7e0 no An7ice e ta0b90 ?i&tro #se eistir+.
6aso 3asse 7o inAcio 7a tabe&a( 3osiciona no 3ri0eiro registro e seta %CD. 6aso 3asse
7o ?ina& 7a tabe&a( 3osiciona no registro X"astRec#+d1X e seta !CD. Heste >&ti0o caso(
se a R44 ?or 2o36onnect( o Recno#+ retorna7o ser@ 3or conven5o X"astRec#+ d 5000X.
D)STR"%T
Reviso: 08/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%S2R-62 # + ,,' aStr14%
Retorno
2i3o 4escri5o
ArraM
ArraM co0 a estr1t1ra 7os ca03os. 6a7a e&e0ento 9 10 s1barraM conten7o
Ho0e( 2i3o( 2a0anBo e 4eci0ais.
4escri5o
Retorna a estr1t1ra 7a tabe&a corrente. !sta ?1n5o 9 1ti&iFa7a 3ara veri?icar a estr1t1ra
7a tabe&a corrente 7a 0es0a ?or0a <1e 9 1ti&iFa7a 3ara criar a tabe&a co0 a ?1n5o
4%6R!A2!. .ara isto e&a cria 10 arraM 3ara gravar as in?or0a5es e as retorna.
Ve=a 2a0b90
ADie&7s# +
D)"#LO%*
Reviso: 08/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%-H"C6f # + ,,' HE"
Retorno
2i3o 4escri5o
6aracter Se0 retorno.
4escri5o
Retira b&o<1eios 7e registros e 7e ar<1ivo 7a tabe&a corrente.
D)"#LO%*ALL
Reviso: 08/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4%-H"C6fA"" # + ,,' HE"
Retorno
2i3o 4escri5o
6aracter Se0 retorno.
4escri5o
Retira o b&o<1eio 7e to7os os registros e ar<1ivos 7e to7as as tabe&as abertas. !sta
?1n5o 9 1ti&iFa7a 3ara &iberar to7os os registros b&o<1ea7os e 9 e<1iva&ente a eec1tar
4%-H"C6f 3ara to7as as tabe&as 7a @rea 7e traba&Bo.
DELETED
Reviso: 09/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4!"!2!4 # + ,,' &4e&ete7
Retorno
2i3o 4escri5o
":gico
Se ?or .2. o registro te0 a 0arca 7e ec&1A7o( se ?or .D.( o registro no te0
a 0arca #o1 no B@ @rea e0 1so+.
4escri5o
Veri?ica se o registro est@ co0 0arca 7e ec&1A7o. ;1an7o o registro 9 ec&1A7o(
3er0anece ?isica0ente na tabe&a( 0as ?ica 0arca7o co0o ec&1A7o. !sta ?1n5o veri?ica
este esta7o. Se nenB10a @rea est@ se&eciona7a( retorna .D.. ;1an7o 9 eec1ta7a a ?1n5o
4%.A6f to7os os registros 0arca7os co0o 7e&eta7os so a3aga7os ?isica0ente. A
?1n5o 4%R!6A"" retira to7as as 0arcas.
!e03&o
// !ste ee03&o veri?ica se 7eter0ina7o registro est@ 7e&eta7o( caso 3ositivo( 0ostra
10a 0ensage0:
-S! X^4A4CSA4V^AA1990.4%DX S[AR!4 H!R
4%JC2C#100+
ED 4!"!2!4#+
Kessagebo#XC registro at1a& ?oi 7e&eta7oX(X!rroX( 0+
!H4ED
F!ELD)LO%*
Reviso: 12/06/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DE!"4%"C6f # $ c6a03o ' + ,,' b%&oco
.ar/0etros
Arg10ento 2i3o 4escri5o
c6a03o 6aracter Ho0e 7o ca03o a ser retorna7o o b&oco 7e c:7igo.
Retorno
2i3o 4escri5o
6o7e,%&oc8 %&oco 7e c:7igo 3ara o ca03o es3eci?ica7o na tabe&a corrente.
4escri5o
Retorna 10 b&oco 7e c:7igo 3ara 10 ca03o 7eter0ina7o 7a tabe&a corrente. !sta
?1n5o 9 1ti&iFa7a 3ara retornar 10 b&oco 7e c:7igo eec1t@ve& co0 o ca03o
es3eci?ica7o. ;1an7o o b&oco res1&tante 9 eec1ta7o se0 3ar/0etro( rec13era o va&or
ar0aFena7o no ca03o. ;1an7o 9 eec1ta7o co0 10 va&or( seta este va&or no
7eter0ina7o ca03o.
.ortanto( o b&oco retorna7o 9 si0i&ar a: G#X`eVa&ore ED#Va&or__HE"( 6a03o(
6a03o:_Va&or+aX+
Sen7o: 6a03o _ 3ar/0etro 7a ?1n5o DE!"4%"C6f#+
Va&or _ va&or eec1ta7o no b&oco 7e c:7igo
!e03&o
// !ste ee03&o 0ostra co0o se 3o7e 1sar o DE!"4%"C6f 3ara criar o b&oco 7e
c:7igo 3ara o ca03o \Ho0e\ 7a tabe&a corrente na vari@ve& b%&oco:
USE Cliente %&I%S Cliente NEW 'I% (DB)CD(
*Bloco +, )IE&DB&OC-"(NO.E($
+EADER
Reviso: 0O/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
[!A4!R # + ,,' n%Mtes
Retorno
2i3o 4escri5o
6aracter
[!A4!R#+ retorna a <1anti7a7e 7e bMtes no cabe5a&Bo 7o ar<1ivo 7e
banco 7e 7a7os corrente na ?or0a 7e 10 va&or n109rico inteiro.
4escri5o
[!A4!R#+ 9 10a ?1n5ao 7e trata0ento 7e banco 7e 7a7os 1ti&iFa7o co0 "AS2R!6#+(
R!6SEV!#+( e 4ESfS.A6!#+ 3ara criar rotinas 7e c:3ia 7e seg1ran5a 7e ar<1ivos.
C 3a7rao 9 <1e a ?1n5ao [!A4!R#+ o3ere na @rea 7e traba&Bo corrente0ente
se&eciona7a. .o7e,se ?aF,&a o3erar e0 10a @rea 7e traba&Bo nao se&eciona7a se esta ?or
es3eci?ica7a e0 10a e3resso a&ias.
L"PDATE
Reviso: 19/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
"-.4A2! # + ,,' 7"ast-37ate
Retorno
2i3o 4escri5o
4ata
Retorna 10 va&or 7o ti3o 4ata ( in7ican7o a 7ata 7a 1&ti0a 0o7i?ica5o e
?ecBa0ento 7a 2abe&a. 6aso no Ba=a tabe&a se&eciona7a na @rea 7e
traba&Bo at1a& ( a ?1n5o retornar@ 10a 7ata vaFia #cto7 #XX++ .
4escri5o
Veri?ica a 7ata 7a >&ti0a 0o7i?ica5o 7a tabe&a corrente. !sta ?1n5o veri?ica <1a& a
7ata 7a >&ti0a 0o7i?ica5o e ?ecBa0ento 7a tabe&a corrente( caso no eista tabe&a
corrente 9 retorna7a 10a 7ata e0 branco.
!e03&o :
// .ostra a data da /ltima modi0ica12o da ta*ela corrente!
d.odi0icacao +, &Update"$
I) "E.3T4"d.odi0icacao$$
CONOUT"(N2o 56 ta*ela corrente($
E&SE
CONOUT""(Data da ultima modi0icacao + ( 7 DTOS"d.odi0icacao$$$
ENDI)
SELE%T
Reviso: 2I/02/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
S!"!62 # ) cA&ias * + ,,' nArea2raba&Bo
.ar/0etros
Arg10ento 2i3o 4escri5o
cA&ias 6aracter $cA&ias' 9 o no0e 7a @rea 7e traba&Bo a ser veri?ica7a.
Retorno
2i3o 4escri5o
H109rico
S!"!62#+ retorna a @rea 7e traba&Bo 7o a&ias es3eci?ica7o na ?or0a 7e 10
va&or n109rico inteiro.
4escri5o
S!"!62#+ 9 10a ?1n5ao 7e trata0ento 7e bancos 7e 7a7os <1e 7eter0ina o n>0ero 7a
@rea 7e traba&Bo 7e 10 a&ias. C n>0ero retorna7o 3o7e variar 7e Fero a 250. Se
$cA&ias' no ?or es3eci?ica7o( 9 retorna7o o n>0ero 7a @rea 7e traba&Bo corrente. 6aso
$cA&ias' se=a es3eci?ica7o e o a&ias nao eistir( S!"!62#+ retorna Fero.
Exemplos
g C ee03&o a seg1ir i&1stra co0o 1ti&iFar S!"!62#+ 3ara 7eter0inar <1a& @rea 7e
traba&Bo o co0an7o -S!...H!R se&eciono1:
USE Sales NEW
SE&ECT 8
conout"SE&ECT"(Sales($$ // Resulta+ 9
g .ara re,se&ecionar o va&or retorna7o 7a ?1n5ao S!"!62#+( 1se o co0an7o S!"!62
co0 a sintae S!"!62 #$i7VarKe0'+( 7esta ?or0a:
USE Sales NEW
nWor:%rea +, SE&ECT"$
USE Customer NEW
SE&ECT "nWor:%rea$
T%GE#,R
Reviso: 25/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
26J!H;RL # ) .ar1 * ( ) .ar2 * ( $ c;1erM ' + ,,' XX
.ar/0etros
Arg10ento 2i3o 4escri5o
.ar1 #;1a&<1er+
.ar/0etros a3enas 3ara co03atibi&iFa5o. Ho te0
?1n5o
.ar2 #;1a&<1er+
.ar/0etros a3enas 3ara co03atibi&iFa5o. Ho te0
?1n5o
c;1erM 6aracter 6ont90 a e3resso 7a <1erM <1e ser@ aberta.
Retorno
2i3o 4escri5o
6aracter Se03re retorna 10a string vaFia.
4escri5o
4e?ine a eec15o 7e 10a ;1erM. !sta ?1n5o 7eter0ina <1e a 3r:i0a cBa0a7a N
4%-seArea ser@ a abert1ra
7e 10a ;1erM e no 7e tabe&a.
!e03&o
c;1erM :_ \S!"!62 T2P6[AV! 6[AV!( RP!P6PHPCP R!6HC ?ro0 ST2990\
c;1erM :_ 6Bange;1erM#c;1erM+
7b-seArea#.2.( \2C.6CHH\( 26Jen;rM#((c;1erM+(\2R%\( .D.( .2.+
SBi&e ]!o?#+
cono1t#2R%,'6[AV!+
7bS8i3#+
en77o
7b6&oseArea#+
"SED
Reviso: 09/07/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Verses Anteriores
Sintae
-S!4 # + ,,' &4b?-se7
Retorno
2i3o 4escri5o
":gico
-S!4#+ retorna ver7a7eiro #.2.+ caso Ba=a 10 ar<1ivo 7e banco 7e 7a7os
e0 1soY caso contr@rio( retorna ?a&so #.D.+.
4escri5o
-S!4#+ 9 10a ?1n5ao 7e trata0ento 7e banco 7e 7a7os 1ti&iFa7a 3ara 7eter0inar se B@
10 ar<1ivo 7e banco 7e 7a7os e0 1so e0 10a @rea 7e traba&Bo es3ecA?ica. C 3a7rao 9
<1e -S!4#+ o3ere na @rea 7e traba&Bo corrente0ente se&eciona7a. .o7e,se ?aF,&a
o3erar e0 10a @rea 7e traba&Bo nao se&eciona7a se esta ?or es3eci?ica7a e0 10a
e3ressao a&ias.
--D)PA%*
Reviso: 09/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
PP4%.A6f # + ,,' -R!2
Retorno
2i3o 4escri5o
#H-"C+ Retorno n1&o.
4escri5o
Re0ove to7os os registros co0 0arca 7e ec&1A7o 7a tabe&a. !sta ?1n5o a3aga
#?isica0ente+ to7os os registros Xec&1A7osX 7a tabe&a corrente.
!e03&o
// !ste ee03&o 7e0onstra co0o se 3o7e 1ti&iFar a ?1n5o 4%4!"!2!#+ 3ara 0arcar
a&g1ns registros co0o 7e&eta7os e o co0an7o .A6f 3ara 7e&et@,&os ?isica0ente.
-S! 6&ientes H!R
4%JC2C#100+
4%4!"!2!#+
4%JC2C#105+
4%4!"!2!#+
4%JC2C#110+
4%4!"!2!#+
// Se a ec&1so ?or con?ir0a7a:
PP4%.A6f#+
Funes TOTVS de disco e ar.ui/os0
AD!R
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A4ER # ) * ( ) * ( ) * ( ) * ( ) * ( ) * + ,,' nAr<1ivos
.ar/0etros
Arg10ento 2i3o 4escri5o
$c!s3ecAr<' 6aracter
$c!s3ecAr<' 9 a es3eci?ica5ao 7os ar<1ivos a sere0
inc&1i7os na 3es<1isa 7o 7iret:rio 3a7rao. U 10a
es3eci?ica5ao 7e ar<1ivo 3a7rao <1e 3o7e inc&1ir os
caracteres coringa 7o ti3o g e h( be0 co0o re?erncia a
7iret:rio e 3atB. 6aso nao se=a es3eci?ica7o( o 3a7rao
ass10i7o 9 g.g.
$aHo0esAr<' ArraM
$aHo0esAr<' 9 o vetor a ser 3reencBi7o co0 os no0es 7e
ar<1ivo <1e corres3on7e0 a $c!s3ecAr<'. 6a7a e&e0ento
cont90 o no0e 7o ar<1ivo e etensao na ?or0a 7e 10a
ca7eia 7e caracteres e0 &etras 0ai>sc1&as.
$a2a0anBos' ArraM
$a2a0anBos' 9 o vetor a ser 3reencBi7o co0 os ta0anBos
7os ar<1ivos corres3on7entes no vetor $aHo0esAr<'.
6a7a e&e0ento 9 n109rico.
$a4atas' ArraM
$a4atas' 9 o vetor a ser 3reencBi7o co0 as 7atas 7os
ar<1ivos corres3on7entes no vetor $aHo0esAr<'. 6a7a
e&e0ento 9 10a 7ata.
$a[oras' ArraM
$a[oras' 9 o vetor a ser 3reencBi7o co0 as Boras 7os
ar<1ivos corres3on7entes no vetor $aHo0esAr<'. 6a7a
e&e0ento 3reencBi7o cont90 10a ca7eia 7e caracteres 7a
?or0a: BB:00:ss.
$aAtrib1tos' ArraM
$aAtrib1tos' 9 o vetor a ser 3reencBi7o co0 os atrib1tos
7os ar<1ivos corres3on7entes no vetor $aDi&ena0es'. 6a7a
e&e0ento 9 10a ca7eia 7e caracteres. 6aso $aAtrib1tos'
se=a es3eci?ica7o( os ar<1ivos 7e 7iret:rio( siste0a( e
escon7i7os sao inc&1i7os( assi0 co0o os ar<1ivos nor0ais.
Se $aAtrib1tos' nao ?or es3eci?ica7o( so0ente os ar<1ivos
nor0ais sao inc&1i7os.
Retorno
2i3o 4escri5o
H109rico
A4ER#+ retorna a <1anti7a7e 7e ar<1ivos <1e corres3on7e0 ao es<1e&eto
7e 7iret:rio es3eci?ica7o.
4escri5o
A4ER#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e eec1ta 71as o3era5oes b@sicas.
.ri0eiro( e&e retorna a <1anti7a7e 7e ar<1ivos <1e corres3on7e0 N es3eci?ica5ao 7e
ar<1ivo. Seg1n7o( 3reencBe 10a s9rie 7e vetores co0 no0es 7e ar<1ivos( ta0anBos(
7atas( Boras e atrib1tos.
A4ER#+ 9 10a ?1n5ao 7e co03atibi&i7a7e e 3ortanto 7esaconse&Ba7a. !&e est@ s13era7o
3e&a ?1n5ao 4ER!62CRL#+( <1e retorna to7as as in?or0a5oes 7e ar<1ivo e0 10 vetor
01&ti,7i0ensiona&.
C%S!RVAijC
4iret:rios: 6aso o arg10ento $aAtrib1tos' se=a es3eci?ica7o e $c!s3ecAr<' se=a
es3eci?ica7o co0o g.g( os 7iret:rios serao inc&1i7os e0 $aHo0esAr<'. Ho vetor
$aAtrib1tos'( os 7iret:rios sao in7ica7os co0 10 va&or atrib1to 7e X4.X Se A4ER#+ ?or
eec1ta7o 7entro 7e 10 s1b7iret:rio( as 71as 3ri0eiras entra7as 7o vetor
$aHo0esAr<' sao X.X e X..X( os Xa&iasX 7os 7iret:rios corrente e raiF. A 7ata e Bora 7a
>&ti0a at1a&iFa5ao sao in?or0a7as 3ara 7iret:rios( 0as o ta0anBo 7e 10 7iret:rio 9
se03re Fero.
%PS'T
Reviso: 19/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
6.LS22 # $ cCrige0 ' ( $ c4estino ' ( ) &6o03acta * + ,,' &S1cess
.ar/0etros
Arg10ento 2i3o 4escri5o
cCrige0 6aracter
Ho0e#s+ 7os ar<1ivos a sere0 co3ia7os( aceita a3enas
ar<1ivos
no servi7or( Ri&76ar7s # g e h + so aceitos nor0a&0ente.
c4estino 6aracter 4iret:rio co0 o 7estino 7os ar<1ivos no 6&ient # Re0ote +
&6o03acta ":gico
En7ica se a c:3ia 7eve ser ?eita co03actan7o o ar<1ivo
antes 7o envio.
Retorno
2i3o 4escri5o
":gico
&S1cess retorna .2. caso o ar<1ivo se=a co3ia7o co0 s1cesso ( o1 .D. e0
caso 7e ?a&Ba na c:3ia.
4escri5o
6o3ia 10 ar<1ivo( 7o servi7or 3ara o c&iente # Re0ote +. .6aso a co03acta5o se=a
Babi&ita7a #&6o03acta +( os 7a7os sero trans0iti7os 7e 0aneira co03acta7a e
7esco03acta7os antes 7o 1so.
!e03&o :
Cp;S#T" (<B-3<.%NU%&.DOC(! (C+<TE.3(! .T. $ // Copia ar=ui>os do
ser>idor para o remote local! compactando antes de transmitir
Cp;S#T" (<B-3<.%NU%&.DOC(! (C+<TE.3(! .). $ // Copia ar=ui>os do
ser>idor para o remote local! sem compactar antes de transmitir
%PT'S
Reviso: 19/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
6.L22S # $ cCrige0 ' ( $ c4estino ' ( ) &6o03acta * + ,,' &S1cess
.ar/0etros
Arg10ento 2i3o 4escri5o
cCrige0 6aracter
Ho0es 7os ar<1ivos a sere0 co3ia7os( aceita a3enas
ar<1ivos &ocais # 6&iente +( Ri&76ar7s # g e h + so aceitos
nor0a&0ente.
c4estino 6aracter 4iret:rio co0 o 7estino 7os ar<1ivos no Servi7or
&6o03acta ":gico
&6o03acta in7ica se o#s+ ar<1ivo#s+ 7eve#0+ ser envia7os
e0 ?or0ato co03acta7o.
Retorno
2i3o 4escri5o
":gico
&S1cess in7ica ( caso ver7a7eiro ( <1e a c:3ia ?oi rea&iFa7a co0 s1cesso.
6aso retorne .D. ( Bo1ve erro na co3ia 7o ar<1ivo.
4escri5o
6o3ia 10 ar<1ivo( 7o c&iente # Re0ote + 3ara o servi7or(. 6aso a co03acta5o se=a
Babi&ita7a # &6o03acta +( os 7a7os sero trans0iti7os 7e 0aneira co03acta e
7esco03acta7os antes 7o 1so.
!e03&o
Cp;T#S" (C+<TE.3<.%NU%&.DOC(!(<B-3(! .T. $ // Copia ar=ui>os do
cliente" remote $ para o Ser>idor compactando antes de transmitir
Cp;T#S" (C+<TE.3<.%NU%&.DOC(! (<B-3( $ // Copia ar=ui>os do
cliente" remote $ para o Ser>idor sem compactar.
%"RD!R
Reviso: 28/0I/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
6-R4ER # ) cHovo.atB * + ,,' c.atBAt1a&
.ar/0etros
Arg10ento 2i3o 4escri5o
cHovo.atB 6aracter
6a0inBo re&ativo ( co0 o novo 7iret:rio <1e ser@ a=1sta7o
co0o corrente.
Retorno
2i3o 4escri5o
6aracter 4iret:rio corrente( se0 a 3ri0eira barra.
4escri5o
Retorna o 7iret:rio corrente 7o servi7or. C ca0inBo retorna7o 9 se03re re&ativo No
Root.atB 7e?ini7o na con?ig1ra5o 7o !nviron0ent no .EHE 7o .rotBe1s Server.
Enicia&0ente ( o 7iret:rio at1a& 7a a3&ica5o 9 o constante na cBave Start.atB ( ta0b90
7e?ini7o na con?ig1ra5o 7o !nviron0ent no .EHE 7o .rotBe1s Server.
6aso se=a 3assa7o o 3ar/0etro cHovo.atB ( este 3atB 9 ass10i7o co0o sen7o o .atB
at1a&. 6aso o 3atB recebi7o co0o 3ark0etro no eista ( se=a inv@&i7o ( o1 se=a 10 3atB
abso&1to # inicia7o co0 10a &etra 7e 7rive o1 cai0nBo 7e re7e + ( a ?1n5o no ir@ setar
o novo 3atB ( 0anten7o o at1a& .
D!RE%TOR
Reviso: 17/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
4ER!62CRL # $ c4irS3ec ' ( ) * + ,,' a4iretorio
.ar/0etros
Arg10ento 2i3o 4escri5o
c4irS3ec 6aracter
$c4irS3ec' es3eci?ica o 7rive( 7iret:rio e ar<1ivo 3ara a
3es<1isa no 7iret:rio. 6aracteres 7o ti3o coringa sao
3er0iti7os na es3eci?ica5ao 7e ar<1ivos. 6aso $c4irS3ec'
se=a o0iti7o( o va&or 3a7rao 9 g.g.
C ca0inBo es3eci?ica7o 3o7e estar na esta5o #re0ote+ ( o1
no servi7or ( obe7ecen7o Ns 7e?inices 7e .atB Abso&1to /
Re&ativo 7e acesso
$cAtrib1tos' 6aracter
$cAtrib1tos' es3eci?ica <1e ar<1ivos co0 atrib1tos
es3eciais 7eve0 ser inc&1i7os na in?or0a5ao retorna7a.
$cAtrib1tos' consiste e0 10a ca7eia 7e caracteres <1e
cont90 10 o1 0ais 7os seg1intes caracteres( conti7os na
tabe&a a7iciona& A ( es3eci?ica7a abaio:
Retorno
2i3o 4escri5o
ArraM
4ER!62CRL#+ retorna 10 vetor 7e s1b,vetores( sen7o <1e ca7a s1b,vetor
cont90 in?or0a5oes sobre ca7a ar<1ivo <1e aten7a a $c4irS3ec'.Ve=a
0aiores 7eta&Bes na 2abe&a %( abaio 7iscri0ina7a.
4escri5o
4ER!62CRL#+ 9 10a ?1n5ao 7e trata0ento 7e a0biente <1e retorna in?or0a5oes a
res3eito 7os ar<1ivos no 7iret:rio corrente o1 es3eci?ica7o. U se0e&Bante a A4ER#+(
3or90 retorna 10 >nico vetor ao inv9s 7e a7icionar va&ores a 10a s9rie 7e vetores
eistentes 3assa7os 3or re?erncia.
4ER!62CRL#+ 3o7e ser 1ti&iFa7a 3ara rea&iFar o3era5oes e0 con=1ntos 7e ar<1ivos.
!0 co0bina5ao co0 A!VA"#+( voc 3o7e 7e?inir 10 b&oco <1e 3o7e ser a3&ica7o a
to7os os ar<1ivos <1e aten7a0 a $c4irS3ec' es3eci?ica7a.
.ara tornar as re?erncias aos v@rios e&e0entos 7e ca7a s1b,vetor 7e ar<1ivo 0ais
&egAveis( 9 ?orneci7o o ar<1ivo Bea7er 4irectrM.cB( <1e cont90 os Z7e?ines 3ara os
s1barraM s1bscri3ts.
TABELA A: Atributos de DIRECTORY()
Atrib1to Signi?ica7o
[ Enc&1ir ar<1ivos oc1&tos
S Enc&1ir ar<1ivos 7e siste0a
4 Enc&1ir 7iret:rios
V .roc1ra 3e&o vo&10e 4CS e ec&1i o1tros ar<1ivos
Ar<1ivos nor0ais sao se03re inc&1i7os na 3es<1isa( a nao ser <1e V se=a es3eci?ica7o.
TABELA B: Estrutura dos Subvetores de DIRECTORY()
.osi5ao KetasA0bo&o 4irectrM.cB
1 cHo0e DPHAK!
2 c2a0anBo DPSEV!
O 74ata DP4A2!
I c[ora DP2EK!
5 cAtrib1tos DPA22
D!RREMOVE
Reviso: 01/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4ERR!KCV! # $ c4iretorio ' + ,,' &S1cesso
.ar/0etros
Arg10ento 2i3o 4escri5o
c4iretorio 6aracter Ho0e 7o 7iret:rio a ser re0ovi7o.
Retorno
2i3o 4escri5o
":gico
&S1cesso ser@ .2. caso o 7iret:rio tenBa si7o e&i0ina7o ( o1 .D. caso no
se=a 3ossAve& ec&1ir o 7iret:rio. ;1an7o a ?1n5o 4irRe0ove retornar .D. (
9 3ossAve& obter 0ais 7eta&Bes 7a ocorrncia rec13eran7o o c:7igo 7o !rro
atrav9s 7a ?1n5o D!rror#+.
4escri5o
4ERR!KCV!#+ e&i0ina 10 7iret:rio es3eci?ico. 6aso es3eci?i<1e0os 10 3atB se0 a
1ni7a7e 7e 7isco ( e&e ser@ consi7era7o no a0biente 7o Servi7or ( a 3artir 7o Root.atB
7o a0biente # caso o 3atB co0e5e co0 ^ + ( o1 a 3artir 7o 7iret:rio corrente # caso o 3atB
no se=a inicia7o co0 ^ + . ! ( <1an7o es3eci?ica7o 10 3atB abso&1to # co0 1ni7a7e 7e
7isco 3reencBi7a + ( a ?1n5o ser@ eec1ta7a na esta5o on7e est@ sen7o eec1ta7o o
.rotBe1s Re0ote. ;1an7o eec1ta0os a ?1n5o 4irRe0ove#+ e0 QC% # 3rocesso
iso&a7o no Server ( se0 inter?ace + ( no 9 3ossAve& es3eci?icar 10 .atB abso&1to 7e
7isco. 6aso isto se=a rea&iFa7o ( a ?1n5o retornar@ .D. e D!rror#+ retornar@ ,1 # SMnta
!rror + .
#ote .ue necess1rio ter direitos suficientes 2ara remo/er um diret3rio4 e o
diret3rio a ser e5iminado 2recisa estar /a6io4 sem su7diret3rios ou ar.ui/os dentro
do mesmo0
D!S*SPA%E
Reviso: 01/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4ESfS.A6! # ) n4rive * + ,,' n%MtesDree
.ar/0etros
Arg10ento 2i3o 4escri5o
n4rive H109rico
H>0ero 7o 7rive( on7e 0 9 o es3a5o na 1ni7a7e 7e 7isco
corrente( e 1 9 o 7rive A: 7o c&iente( 2 9 o 7rive %: 7o
c&iente( etc.
Retorno
2i3o 4escri5o
H109rico H>0ero 7e bMtes 7is3onAveis no 7isco in?or0a7o co0o 3ar/0etro.
4escri5o
4ESfS.A6!#+ 9 10a ?1n5o 7e a0biente <1e 7eter0ina <1antos bMtes esto
7is3onAveis e0 10a 7eter0ina7a 1ini7a7e 7e 7isco. !sta ?1n5o obt90 a in?or0a5o
se03re re&ativa N esta5o on7e est@ sen7o eec1ta7o o .rotBe1s Re0ote. Atrav9s 7o
3ar/0etro n4Rive ( se&eciona0os <1a& a 1ni7a7e 7e 7isco <1e 7ese=a0os obter a
in?or0a5o 7o es3a5o &ivre ( on7e:
0 : -ni7a7e 7e 7isco at1a& 7a esta5o #4!DA-"2+.
1 : 4rive A: 7a esta5o re0ota.
2 : 4rive %: 7a esta5o re0ota.
O : 4rive 6: 7a esta5o re0ota.
I : 4rive 4: 7a esta5o re0ota ... e assi0 3or 7iante.
%aso a fun8o Dis9S2ace se:a e;ecutada atra/s de um <o7 = 2rocesso iso5ado no
Ser/idor 4 sem interface Remota > 4 ou se:a 2assado um argumento de unidade de
disco ine;istente ou indis2on?/e5 4 a fun8o D!S*SPA%E=> retornar1 @A
F%LOSE
Reviso: 09/0I/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
D6"CS! # $ n[an7&e ' + ,,' &!rror
.ar/0etros
Arg10ento 2i3o 4escri5o
n[an7&e H109rico
$n[an7&e' 9 o Ban7&e 7o ar<1ivo obti7o 3revia0ente
atrav9s 7e DC.!H#+ o1 D6R!A2!#+.
Retorno
2i3o 4escri5o
":gico
D6"CS!#+ retorna ?a&so #.D.+ se ocorre 10 erro en<1anto os b1??ers estao
sen7o escritosY 7o contr@rio( retorna ver7a7eiro #.2.+.
4escri5o
D6"CS!#+ 9 10a ?1n5ao 7e trata0ento 7e ar<1ivos 7e baio nAve& 1ti&iFa7a 3ara ?ecBar
ar<1ivos bin@rios e ?or5ar <1e os res3ectivos b1??ers 7o 4CS se=a0 escritos no 7isco.
6aso a o3era5ao ?a&Be( D6"CS!#+ retorna ?a&so #.D.+. D!RRCR#+ 3o7e entao ser 1sa7o
3ara 7eter0inar a raFao eata 7a ?a&Ba. .or ee03&o( ao tentar,se 1sar D6"CS!#+ co0
10 Ban7&e #trata0ento 7a7o ao ar<1ivo 3e&o siste0a o3eraciona&+ inv@&i7o retorna ?a&so
#.D.+ e D!RRCR#+ retorna erro 6 7o 4CS( inva&i7 Ban7&e. 6ons1&te D!RRCR#+ 3ara
obter 10a &ista co03&eta 7os c:7igos 7e erro.
A/iso
!sta ?1n5ao 3er0ite acesso 7e baio nAve& aos ar<1ivos e 7is3ositivos 7o 4CS. !&a 7eve
ser 1ti&iFa7a co0 etre0o c1i7a7o e eige <1e se conBe5a a ?1n7o o siste0a o3eraciona&
1ti&iFa7o.
!e03&os
C ee03&o a seg1ir 1ti&iFa D6"CS!#+ 3ara ?ecBar 10 ar<1ivo bin@rio rec90 cria7o e
eibe 10a 0ensage0 7e erro caso o ?ecBa0ento ?a&Be:
?include ()ileio.c5(
n@andle +, )CRE%TE"(Test0ile(! )CANOR.%&$
I0 B)C&OSE"n@andle$
conout" (Erro ao 0ec5ar ar=ui>o! erro numero+ (! )ERROR"$ $
EndI0
F%REATE
Reviso: 01/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
D6R!A2! # $ cAr<1ivo ' ( ) nAtrib1to * + ,,' n[an7&e
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr<1ivo 6aracter
Ho0e 7o ar<1ivo a ser cria7o ( 3o7en7o ser es3eci?ica7o
10 3atB abso&1to o1 re&ativo ( 3ara criar ar<1ivos no
a0biente &oca& # Re0ote + o1 no Servi7or (
res3ectiva0ente .
nAtrib1to H109rico
Atrib1tos 7o ar<1ivo a ser cria7o #Vi7e 2abe&a 7e
atrib1tos abaio+. 6aso no es3eci?ica7o ( o 4!DA-"2 9
D6PHCRKA".
Retorno
2i3o 4escri5o
H109rico
A ?1n5o retornar@ o [an7&e 7o ar<1ivo 3ara ser 1sa7o nas 7e0ais ?1n5es
7e 0an1ten5o 7e ar<1ivo. C [an7&e ser@ 0aior o1 ig1a& a Fero. 6aso no
se=a 3ossAve& criar o ar<1ivo ( a ?1n5o retornar@ o Ban7&e ,1 ( e ser@
3ossAve& obter 0aiores 7eta&Bes 7a ocorrencia atrav9s 7a ?1n5o D!Rror#+
4escri5o
D6R!A2!#+ 9 10a ?1n5o 7e baio,nAve& <1e 3er0ite a 0ani31&a5o 7ireta 7os
ar<1ivos tetos co0o bin@rios. Ao ser eec1ta7a D6R!A2!#+ cria 10 ar<1ivo o1
e&i0ina o se1 conte>7o( e retorna o Ban7&e #0ani31&a7or+ 7o ar<1ivo( 3ara ser 1sa7o nas
7e0ais ?1n5es 7e 0an1ten5o 7e ar<1ivo. A3:s ser 1ti&iFa7o ( o Ar<1ivo 7eve ser
?ecBa7o atrav9s 7a ?1n5o D6"CS!#+.
Ha tabe&a abaio ( esto 7escritos os atrib1tos 3ara cria5o 7o ar<1ivo ( 7e?ini7os no
ar<1ivo Bea7er fi5eio0cB
6onstante Va&or 4escri5o
D6PHCRKA" 0 6ria5o nor0a& 7o Ar<1ivo #7e?a1&t/3a7ro+.
D6PR!A4CH"L 1 6ria o ar<1ivo 3rotegi7o 3ara grava5o.
D6P[E44!H 2 6ria o ar<1ivo co0o oc1&to.
D6PSLS2!K I 6ria o ar<1ivo co0o siste0a.
6aso 7ese=e0os es3eci?icar 0ais 7e 10 atrib1to ( basta so0@,&os . .or ee03&o ( 3ara
criar 10 ar<1ivo 3rotegiro contra grava5o e escon7i7o ( 3assa0os co0o atrib1to
D6PR!A4CH"L d D6P[E44!H .
ATE#CDO E %aso o ar.ui/o :1 e;ista 4 o conteFdo do mesmo ser1 EL!M!#ADO 4
e seu tamanBo ser1 truncado 2ara G = (ERO > 7Htes0
FERASE
Reviso: 01/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
D!RAS! # $ cAr<1ivo ' + ,,' nStat1s
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr<1ivo 6aracter
Ho0e 7o ar<1ivo a ser a3aga7o . .o7e ser es3eci?ica7o 10
3atB abso&1to o1 re&ativo ( 3ara a3agar ar<1ivos na esta5o
&oca& # Re0ote + o1 no Servi7or ( res39ctiva0ente .
Retorno
2i3o 4escri5o
H109rico
A ?1n5o retornar@ 0 caso o ar<1ivo3 se=a a3aga7o co0 s1cesso ( e ,1 caso
no se=a 3ossAve& a3agar o ar<1ivo. 6aso a ?1n5o retorne ,1 ( 9 3ossAve&
obter 0a1ires 7eta&Bes 7a ocorrncia atrav9s 7a ?1n5o ?!rror#+
4escri5o
Atrav9s 7a ?1n5o Derase ( 9 3ossAve& a3agar 10 ar<1ivo no 7isco . C Ar<1ivo 3o7e
estar no Servi7or o1 na esta5o &oca& #Re0ote+.
C Ar<1ivo 3ara ser a3aga7o 7eve estar ?ecBa7o. Ho 9 3er0iti7o a 1ti&iFa5o 7e
caracteres coringa #Si&7car7s+.
F!LE
Reviso: 0I/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DE"! # $ cAr<1ivo ' + ,,' &!iste
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr<1ivo 6aracter
Ho0e 7o ar<1ivo ( 3o7en7o ser es3eci?ica7o 10 3atB
#ca0inBo + . 6a0inBos &ocais #Re0ote+ o1 ca0inBos 7e
servi7or so aceitos ( be0 co0o Si&7car7s # 6aracteres g
e h +
Retorno
2i3o 4escri5o
":gico
C retorno ser@ .2. caso o ar<1ivo es3eci?ica7o eista. 6aso o 0es0o no
eista no 3atB es3eci?ica7o ( a ?1n5o retorna .D.
4escri5o
Veri?ica se eiste 10 ar<1ivo o1 10 3a7ro 7e ar<1ivos( no 7iret:rio. .or7e0os
es3eci?icar ca0inBos abso&1tos # ar<1ivos na esta5o , Re0ote + o1 re&ativos # A 3artir
7o Root.atB 7o .rotBe1s Server+ . Cs caracteres g e h # Si&7car7s+. so aceitos.
FOPE#
Reviso: 05/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
DC.!H # $ cAr< ' ( ) nKo7o * + ,,' nRet
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr< 6aracter
Ho0e 7o ar<1ivo a ser aberto <1e inc&1i o 3atB caso Ba=a
10.
nKo7o H109rico
Ko7o 7e acesso 4CS so&icita7o <1e in7ica co0o o
ar<1ivo aberto 7eve ser acessa7o. C acesso 9 7e 10a 7as
categorias re&aciona7as na tabe&a A e as restri5es 7e
co03arti&Ba0ento re&aciona7a na 2abe&a %. C 0o7o
3a7rao 9 Fero( so0ente 3ara &eit1ra( co0
co03arti&Ba0ento 3or 6o03atibi&i7a7e. Ao 7e?inir0os o
0o7o 7e acesso ( 7eve0os so0ar 10 e&e0ento 7a 2abe&a
A co0 10 e&e0ento 7a 2abe&a %.
Retorno
2i3o 4escri5o
H109rico
DC.!H#+ retorna o Ban7&e 7e ar<1ivo aberto na ?aia 7e Fero a 65.5O5.
6aso ocorra 10 erro( DC.!H#+ retorna ,1.
4escri5o
Abre 10 ar<1ivo bin@rio.
DC.!H#+ 9 10a ?1n5ao 7e trata0ento 7e ar<1ivo 7e baio nAve& <1e abre 10 ar<1ivo
bin@rio eistente 3ara <1e este 3ossa ser &i7o e escrito( 7e3en7en7o 7o arg10ento
$nKo7o'. 2o7a veF <1e Bo1ver 10 erro na abert1ra 7o ar<1ivo( D!RRCR#+ 3o7e ser
1sa7o 3ara retornar o c:7igo 7e erro 7o Siste0a C3eraciona&. .or ee03&o( caso o
ar<1ivo nao eista( DC.!H#+ retorna ,1 e D!RRCR#+ retorna 2 3ara in7icar <1e o
ar<1ivo nao ?oi encontra7o. Ve=a D!RRCR#+ 3ara 10a &ista co03&eta 7os c:7igos 7e
erro.
6aso o ar<1ivo es3eci?ica7o se=a aberto( o va&or retorna7o 9 o Ban7&e #0ani31&a7or+ 7o
Siste0a C3eraciona& 3ara o ar<1ivo. !ste va&or 9 se0e&Bante a 10 a&ias no siste0a 7e
banco 7e 7a7os( e e&e 9 eigi7o 3ara i7enti?icar o ar<1ivo aberto 3ara as o1tras ?1n5oes
7e trata0ento 7e ar<1ivo. .ortanto( 9 i03ortante se03re atrib1ir o va&or <1e ?oi
retorna7o a 10a vari@ve& 3ara 1so 3osterior( co0o 0ostra o ee03&o 7esta ?1n5o.
Aviso
!sta ?1n5ao 3er0ite acesso 7e baio nAve& a ar<1ivos e 7is3ositivos. !&a 7eve ser
1ti&iFa7a co0 etre0o c1i7a7o e eige <1e se conBe5a a ?1n7o o siste0a o3eraciona&
1ti&iFa7o.
#otas
DC.!H 3roc1ra o ar<1ivo no 7iret:rio corrente e nos 7iret:rios con?ig1ra7os na
vari@ve& 7e 3es<1isa 7o Siste0a C3eraciona&( a nao ser <1e 10 3atB se=a
7ec&ara7o e3&icita0ente co0o 3arte 7o arg10ento $cAr<'.
.or sere0 eec1ta7as e0 10 a0biente c&iente,servi7or( as ?1n5es 7e
trata0ento 7e ar<1ivos 3o7e0 traba&Bar e0 ar<1ivos &oca&iFa7os no c&iente
#esta5o+ o1 no servi7or. C A4V." i7enti?ica o &oca& on7e o ar<1ivo ser@
0ani31&a7o atrav9s 7a eistncia o1 no 7a &etra 7o 7rive no no0e 7o ar<1ivo
3assa7o e0 $cAr<'. C1 se=a( se o ar<1ivo ?or es3eci?ica7o co0 a &etra 7o 7rive(
ser@ aberto na esta5o. 6aso contr@rio( ser@ aberto no servi7or co0 o 7iret:rio
con?ig1ra7o co0o root3atB sen7o o 7iret:rio raAF 3ara &oca&iFa5o 7o ar<1ivo.
Ta7e5a AE Modos de Acesso a Ar.ui/os )in1rios
Ko7o 6onstante #?i&eio.cB+ C3era5o
0 DCPR!A4 Aberto 3ara &eit1ra #3a7ro ass10i7o+
1 DCPRRE2! Aberto 3ara grava5o
2 DCPR!A4RRE2! Aberto 3ara &eit1ra e grava5o
Ta7e5a )E Modos de Acesso de %om2arti5Bamento a Ar.ui/os )in1rios
Ko7o
6onstante
#?i&eio.cB+
C3era5o
0 DCP6CK.A2 Ko7o 7e 6o03atibi&i7a7e #4e?a1&t+
16 DCP!T6"-SEV! Acesso tota& ec&1sivo
O2 DCP4!HLRRE2!
Acesso b&o<1ean7o a grava5o 7e o1tros 3rocessos ao
ar<1ivo.
I8 DCP4!HLR!A4 Acesso b&o<1ean7o a &eit1ra 7e o1tros 3rocessos ao ar<1ivo.
6I DCP4!HLHCH!
Acesso co03arti&Ba7o. .er0ite a &eit1ra e grava5o 3or
o1tros 3rocessos ao ar<1ivo..
6I DCPS[AR!4 Eg1a& N DCP4!HLHCH!
FREAD
Reviso: 19/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DR!A4 # $ n[anv&e ' ( $ c%1??er ' ( $ n;t7%Mtes ' + ,,' n%Mtes"i7os
.ar/0etros
Arg10ento 2i3o 4escri5o
n[anv&e H109rico
U o 0ani31&a7or #[an7&e+ retorna7o 3e&as ?1n5es
DC.!H#+(
D6R!A2!#+( DC.!H.CR2#+( <1e ?aF re?erncia ao
ar<1ivo a ser &i7o.
c%1??er 6aracter
U o no0e 7e 10a vari@ve& 7o ti3o String ( a ser 1ti&iFa7a
co0o b1??er 7e &eit1ra ( on7e os 7a7os &i7os
7evero ser ar0aFena7os. C ta0anBo 7esta vari@ve& 7eve
ser 0aior o1 ig1a& ao ta0anBo in?or0a7o e0 n;t7%Mtes.
!sta vari@ve& 7eve ser se03re 3assa7a 3or re?erncia. # c
antes 7o no0e 7a vari@ve& +( caso contr@rio os 7a7os &i7os
no sero retorna7os.
n;t7%Mtes H109rico
4e?ine a <1anti7a7e 7e %Mtes <1e 7eve0 ser &i7as 7o
ar<1ivo a 3artor 3osiciona0ento 7o 3onteiro at1a&.
Retorno
2i3o 4escri5o
H109rico
;1anti7a7es 7e bMtes &i7os. 6aso a <1anti7a7e se=a 0enor <1e a so&icita7a(
isto in7ica erro 7e &eit1ra o1 ?ina& 7e ar<1ivo( Veri?i<1e a ?1n5o
D!RRCR#+ 3ara 0aiores 7eta&Bes.
4escri5o
DR!A4#+ & os 7a7os a 3artir 10 ar<1ivo aberto( atrav9s 7e DC.!H#+( D6R!A2!#+
e/o1 DC.!H.CR2#+( e ar0aFena os 7a7os &i7os 3or re?erncia no b1??er in?or0a7o.
DR!A4#+ &er@ at9 o n>0ero 7e bMtes in?or0a7o e0 n;t7%MtesY caso aconte5a a&g10
erro o1 o ar<1ivo cBeg1e ao ?ina&( DR!A4#+ retornar@ 10 n>0ero 0enor <1e o
es3eci?ica7o e0 n;t7%Mtes. DR!A4#+ & nor0a&0ente caracteres 7e contro&e #AS6 128(
AS6 0( etc.+.
A vari@ve& String a ser 1tii&Fa7a co0o b1??er 7e &eit1ra 7eve ser se03re 3r9,a&oca7o e
3assa7o co0o re?erncia. 6aso contr@rio( os 7a7os no 3o7ero ser retorna7os.
DR!A4#+ & a 3artir 7a 3osi5o at1a& 7o 3onteiro at1a& 7o ar<1ivo ( <1e 3o7e ser
a=1sta7o o1 0o7i?ica7o 3e&as ?1n5es DS!!f#+ ( DRRE2!#+ o1 DR!A4S2R#+.
FREADSTR
Reviso: 02/06/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DR!A4S2R # $ n[an7&e ' ( $ n;t7%Mtes ' + ,,' c"i7os
.ar/0etros
Arg10ento 2i3o 4escri5o
n[an7&e H109rico
U o 0ani31&a7or retorna7o 3e&as ?1n5es DC.!H#+(
D6R!A2!#+( DC.!H.CR2#+.
n;t7%Mtes H109rico H>0ero 0@i0o 7e bMtes <1e 7eve0 ser &i7os.
Retorno
2i3o 4escri5o
6aracter
Retorna 10a string conten7o os caracteres
&i7os.
4escri5o
" caracteres 7e 10 ar<1ivo bin@rio.
DR!A4S2R#+ & 7e 10 ar<1ivo aberto( atrav9s 7e DC.!H#+( D6R!A2!#+(
DC.!H.CR2#+.
DR!A4S2R#+ &er@ at9 o n>0ero 7e bMtes in?or0a7o e0 n;t7%Mtes o1 at9 encontrar 10
6[R#0+. 6aso aconte5a a&g10 erro o1 o ar<1ivo cBeg1e ao ?ina&( DR!A4S2R#+
retornar@ 10a string 0enor 7o <1e n;7%Mtes e co&ocar@ o erro e0 D!RRCR#+.
DR!A4S2R#+ & a 3artir 7a 3osi5o at1a& 7o 3onteiro( <1e 3o7e ser a=1sta7o 3e&o
DS!!f#+( DRRE2!# + o1 DR!A4#+.
FRE#AME
Reviso: 11/06/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DR!HAK! # $ cC&7Di&e ' ( $ cHeSDi&e ' + ,,' nStat1s
.ar/0etros
Arg10ento 2i3o 4escri5o
cC&7Di&e 6aracter
Ho0e 7o ar<1ivo ser@ reno0ea7o( aceita ca0inBos 7o
servi7or e ca0inBos 7o c&iente. 6aso no se=a es3eci?ica7o
nenB10a 1ni7a7e 7e 7isco e 3atB( 9 consi7era7o o 3atB
at1a& no servi7or.
cHeSDi&e 6aracter
Hovo no0e 7o ar<1ivo( aceita ta0b90 ca0inBo 7o
servi7or( e ca0inBo 7o c&iente.
Retorno
2i3o 4escri5o
H109rico
Se o stat1s retorna7o ?or ,1 ( ocorre1 a&g10 erro na 017an5a 7e no0e :
Veri?i<1e se os 7ois ca0inBos esto no 0es0o a0biente( veri?i<1e a
eistncia 7o ar<1ivo 7e orige0( se e&e no est@ e0 1so no 0o0ento 3or
o1tro 3rocesso ( e veri?i<1e se o no0e 7o ar<1ivo 7e 7estino =@ no eiste
no 3atB 7e 7estino es3eci?ica7o.
4escri5o
Atrav9s 7a ?1n5o DR!HAK!#+ 9 3ossAve& reno0ear 10 ar<1ivo 3ara o1tro no0e( tanto
no servi7or co0o na esta5o. Ao reno0ear 10 ar<1ivo no es<1e5a <1e esta ar<1ivo
7ever@
estar ?ecBa7o # isto 9 ( no 3o7e estar e0 1so 3or nenB10 o1tro 3rocesso o1 esta5o+.
6aso o ar<1ivo este=a aberto 3or o1tro 3rocesso ( a o3era5o 7e reno0ear o ar<1ivo no
9 3ossAve&. A ?1n5o ?Rena0e#+ no aceita Si&7car7s # g e/o1 h +.
Va&e &e0brar <1e no 9 3ossAve& reno0ear 10 ar<1ivo es3eci?ican7o nos 3ar/0etros
si01&tanea0ente 10 ca0inBo 7e servi7or e 10 7e esta5o re0ota( be0 co0o
es3eci?icar 7ois ar<1ivos re0otos e eec1tar a ?1n5o ?erna0e#+ atrav9s 7e 10 QC%.
6aso isto ocorra( a ?1n5o retornar@ ,1 ( e ?!rror#+ retornar@ ta0b90 ,1.
!m2ortante E ,uando es2ecificamos um 2atB diferente nos ar.ui/os de origem e
destino 4 a fun8o fRename=> rea5i6a a funciona5idade de MOVER o ar.ui/o 2ara o
PatB es2ecificado0
FSEE*
Reviso: 05/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DS!!f # $ n[an7&e ' ( ) nC??Set * ( ) nCrige0 * + ,,' n.os
.ar/0etros
Arg10ento 2i3o 4escri5o
n[an7&e H109rico
Kani31&a7or obti7o atrav9s 7as ?1n5es
D6R!A2!(DC.!H.
nC??Set H109rico
nC??Set corres3on7e ao n>0ero 7e bMtes no 3onteiro 7e
3osiciona0ento 7o ar<1ivo a ser 0ovi7o. .o7e ser 10
n10ero 3ositivo ( Fero o1 negativo( a ser consi7era7o a
3artir 7o 3ar/0etro 3assa7o e0 nCrige0.
nCrige0 H109rico
En7ica a 3artir 7e <1a& 3osi5o 7o ar<1ivo( o nC??set ser@
consi7era7o.
Retorno
2i3o 4escri5o
H109rico
DS!!f#+ retorna a nova 3osi5ao 7o 3onteiro 7e ar<1ivo co0 re&a5ao ao
inAcio 7o ar<1ivo #3osi5ao 0+ na ?or0a 7e 10 va&or n109rico inteiro. !ste
va&or nao &eva e0 conta a 3osi5ao origina& 7o 3onteiro 7e ar<1ivos antes 7a
eec15o 7a ?1n5o DS!!f#+.
4escri5o
DS!!f#+ 3osiciona o 3onteiro 7o ar<1ivo 3ara as 3r:i0as o3era5es 7e &eit1ra o1
grava5o. As 0ovi0enta5es 7e 3onteiros so re&ativas N nCrige0 <1e 3o7e ter os
seg1intes va&ores( 7e?ini7os e0 ?i&eio.cB:
Ta7e5a AE Origem a ser considerada 2ara a mo/imenta8o do 2onteiro de
2osicionamento do Ar.ui/o0
Crige0 6onstante C3era5o
0 DSPS!2 A=1sta a 3artir 7o inicio 7o ar<1ivo. #4e?a1&t+
1 DSPR!"A2EV! A=1ste re&ativo a 3osi5o at1a& 7o ar<1ivo.
2 DSP!H4 A=1ste a 3artir 7o ?ina& 7o ar<1ivo.
FIR!TE
Reviso: 27/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
DRRE2! # $ n[an7&e ' ( $ c%1??er ' ( ) n;t7%Mtes * + ,,' n%Mtes!scritos
.ar/0etros
Arg10ento 2i3o 4escri5o
n[an7&e H109rico
U o 0ani31&a7or 7e ar<1ivo o1 7evice retorna7o 3e&as
?1n5es DC.!H#+( D6R!A2!#+( o1 DC.!H.CR2#+.
c%1??er 6aracter
$c%1??er' 9 a ca7eia 7e caracteres a ser escrita no ar<1ivo
es3eci?ica7o. C ta0anBo 7esta vari@ve& 7eve ser 0aior o1
ig1a& ao ta0anBo in?or0a7o e0 n;t7%Mtes #caso
se=a in?or0a7o o ta0anBo+.
n;t7%Mtes H109rico
$n;t7%Mtes' in7ica a <1anti7a7e 7e bMtes a sere0
escritos a 3artir 7a 3osi5ao corrente 7o 3onteiro 7e
ar<1ivos. 6aso se=a o0iti7o( to7o o conte>7o 7e
$c%1??er' 9 escrito.
Retorno
2i3o 4escri5o
H109rico
DRRE2!#+ retorna a <1anti7a7e 7e bMtes escritos na ?or0a 7e 10 va&or
n109rico inteiro. 6aso o va&or retorna7o se=a ig1a& a $n;t7%Mtes'( a
o3era5ao ?oi be0 s1ce7i7a. 6aso o va&or 7e retorno se=a 0enor <1e
$n%Mtes' o1 Fero( o1 o 7isco est@ cBeio o1 ocorre1 o1tro erro. Heste caso (
1ti&iFe a ?1n5o D!RRCR#+ 3ara obter 0aiores 7eta&Bes 7a ocorrncia.
4escri5o
Voc 3o7e escrever to7o o1 3arte 7o conte>7o 7o b1??er ( &i0itan7o a <1anti7a7e 7e
%Mtes atrav9s 7o 3ar/0etro n;t7%Mtes. A escrita co0e5a a 3artir 7a 3osi5o corrente 7o
3onteiro 7e ar<1ivos( e a ?1n5o DRRE2! retornar@ a <1anti7a7e rea& 7e bMtes escritos.
Atrav9s 7as ?1n5es DC.!H#+( D6R!A2!#+( o1 DC.!H.CR2#+( 3o7e0os abrir o1
criar 10 ar<1ivo o1 abrir 10a 3orta 7e co01nica5o ( 3ara o <1a& sero grava7os o1
envia7os os 7a7os 7o b1??er in?or0a7o. .or tratar,se 7e 10a ?1n5o 7e 0ani31&a5o 7e
conte>7o bin@rio ( so s13orta7os na String c%1??er to7os os caracteres 7a tabe&a
AS6EE ( inc&1sive caracteres 7e contro&e # AS6 0 ( AS6 12 ( AS6 128 ( etc... +.
6aso aconte5a a&g10a ?a&Ba na grava5o ( a ?1n5o retornar@ 10 n>0ero 0enor <1e o
n;t7%Mtes. Heste caso ( a ?1n5o D!RRCR#+ 3o7e ser 1ti&iFa7a 3ara 7eter0inar o erro
es3ecA?ico ocorri7o. A grava5o no ar<1ivo 9 rea&iFa7a a 3artir 7a 3osi5o at1a& 7o
3onteiro ( <1e 3o7e ser a=1sta7o atrav9s 7as ?1n5es DS!!f#+ ( DR!A4#+ o1
DR!A4S2R#+.
GET%L!E#TD!R
Reviso: 0I/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
J!26"E!H24ER # + ,,' c.atB
Retorno
2i3o 4escri5o
6aracter Retona o 3atB on7e est@ insta&a7o o .rotBe1s Re0ote.
4escri5o
Retorna o 7iret:rio co03&eto on7e o Re0ote est@ insta&a7o( in?or0an7o inc&1sive a
1ni7a7e 7e 7isco.
O7ser/a8o E Esta fun8o a2enas retornar1 um resu5t1do /15ido caso se:a
e;ecutada em um 2rograma atra/s do ProtBeus Remote 0 %aso esta fun8o se:a
cBamada em <O) 4 a mesma ocasionar1 um erro de e;ecu8o = Error to
comunicate JitB Remote > 0
GETREMOTE!#!#AME
Reviso: 12/06/200O
Abrangncia
Verso 6.09 Verso 7.10
Sintae
J!2R!KC2!EHEHAK! # + ,,' cAr<6on?
Retorno
2i3o 4escri5o
6aracter .atB e no0e 7o ar<1ivo 7e con?ig1ra5o
4escri5o
Retorna o no0e 7o ar<1ivo 7e con?ig1ra5o 7o A. Re0ote.
GETSRVPROFSTR!#G
Reviso: 0O/09/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
J!2SRV.RCDS2REHJ # $ c6Bave ' ( $ c4e?a1&t ' + ,,' c6onte17o
.ar/0etros
Arg10ento 2i3o 4escri5o
c6Bave 6aracter 6Bave 7o EHE 7o environ0ent a ser &i7a(
c4e?a1&t 6aracter
c4e?a1&t 9 o conte17o 7a cBave a ser retorna7o caso a
cBave no se=a encontra7a no .ini
Retorno
2i3o 4escri5o
6aracter 6onte17o 7a cBave es3eci?ica7a
4escri5o
Atrav9s 7a ?1n5o JetSrv.ro?String ( 3o7e0os obter o conte>7o 7e 10a cBave 7e
con?ig1ra5o 7o environ0ent at1a& e0 1so no ar<1ivo 7e Enicia&iFa5o 7o Server
.rotBe1s # A.Srv.ini + .
MA*ED!R
Reviso: 12/06/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
KAf!4ER # $ cHovo4ir ' + ,,' nRes1&ta7o
.ar/0etros
Arg10ento 2i3o 4escri5o
cHovo4ir 6aracter
Ho0e 7o 7iret:rio a ser cria7o( inc&1in7o o3ciona&0ente o
ca0inBo #3atB+.
Retorno
2i3o 4escri5o
H109rico
Retorno Fero # 0 +(o 7iret:rio ?oi cria7o co0 s1cesso. 6aso contr@rio(
Bo1ve erro na cria5o 7o 7iret:rio.
4escri5o
6ria 10 7iret:rio na esta5o o1 no servi7or A..
6aso o 7iret:rio co0ece co0 10 7rive # !: 6:( T: + o 7iret:rio ser@ cria7o na esta5o(
caso contr@rio ser@ cria7o no servi7or.
.%-EDIR"(c+<teste<um($ // Cria um diretCrio na estacao
nResult +, .%-EDIR"(<teste<um($ // Cria o diretorio no ser>idor
%d>anced prot5eus
I) nResult B, D
Conout" (Impossi>el Criar o diretCrio no ser>idor 3rot5eus(! nResult
$
ENDI)
.%-EDIR" (teste( $ // Exemplo tam*Em >6lido " Criando o diretCrio no
ser>idor $ dentro do diretCrio corrente
MS%OMPRESS
Reviso: 07/05/200O
Abrangncia
Verso 6.09 Verso 7.10
Sintae
KS6CK.R!SS # $ cAr< e aAr<1ivos ' ( ) c4estino * ( ) cSenBa * + ,,' cDi&eHa0e
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr< e aAr<1ivos #;1a&<1er+
Ar<1ivo#s+ a ser#e0+ co03acta7o#s+. .o7e ser 7o ti3o
String ( 3ara es3eci?icar 10 >nico ar<1ivo ( o1 7o ti3o
ArraM ( conten7o 10 o1 0ais ar<1ivo#s+ a ser#e0+
co03ata7o#s+.
c4estino 6aracter
Ho0e 7o Ar<1ivo 7estino( caso a etenso se=a o0iti7a
ser@ ass10i7o .KV.( se no ?or in?or0a7o ass10ir@ o
0es0o no0e 7o cAr< co0 etenso .KV. o1 o no0e 7o
1l. Ar<1ivo no ArraM $aAr<1ivos'.
cSenBa 6aracter
SenBa a ser 1ti&iFa7a 3ara cri3togra?ar o ar<1ivo
co03acta7o.
Retorno
2i3o 4escri5o
6aracter
6aso a co03acta5o se=a eec1ta7a co0 s1cesso ( a ?1n5o retornar@ 10a
sring conten7o o no0e 7o ar<1ivo gera7o . 6aso no se=a 3ossAve& a
co03acta5o ( 3or ?a&ta 7e es3a5o e0 7isco o1 erro 7e acesso a a&g10 7os
ar<1ivos a ser#e0+ co03acta7o#s+( a ?1n5o retornar@ 10a string e0
branco #XX+.
4escri5o
6o03acta 10 o1 v@rios ar<1ivos e0 10 >nico ar<1ivo co0 etenso .KV..
KS6CK.R!SS#+ co03acta os ar<1ivos in?or0a7os e0 10 >nico ar<1ivo co0
etenso 7e?a1&t .KV.. C ?or0ato 9 3ro3riet@rio e 01&ti3&ata?or0a.
6aso a senBa se=a in?or0a7a a3enas co0 a senBa 3o7ere0os 7esco03actar os ar<1ivos.
2anto ar<1ivos no &oca& # Re0ote + co0o no Servi7or so aceitos.
MSDE%OMP
Reviso: 07/05/200O
Abrangncia
Verso 6.09 Verso 7.10
Sintae
KS4!6CK. # $ cAr< ' ( ) c.atB4estino * ( ) cSenBa * + ,,' &S1cess
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr< 6aracter Ho0e 7o Ar<1ivo no ?or0ato KV. a ser 7esco03acta7o.
c.atB4estino 6aracter
.atB 7e 7estino on7e sero grava7os o#s+ ar<1ivo#s+
7esco03acta7o#s+. Hote <1e 3o7e0 ser inc&1A7os ca0inBos
7o servi7or co0o ca0inBos &ocais.
cSenBa 6aracter
6aso o ar<1ivo tenBa si7o co03acta7o co0 senBa ( esta
7eve ser es3eci?ica7a meste 3ar/0etro 3ara ser 3ossYive& a
7esco03acta5o 7o ar<1ivo.
Retorno
2i3o 4escri5o
":gico
6aso a 7esco03acta5o ?oi eec1ta7a co0 s1cesso( a ?1n5o retornar@ .2. (
!0 caso 7e erro 71rante a 7esco03acta5o( a ?1n5o retrornar@ .D.
Veri?i<1e o es3a5o 7is3onAve& na 1ni7a7e 7e 7isco 3ara 7esco03actar o#s+
ar<1ivo#s+ e/o1 se eiste a0g10 ar<1ivo a ser 7esco03acta7o no 3acote
<1e =@ eista na 1ni7a7e 7e 7isco ( atrib1A7o co0o XR!a7,Cn&MX.
4escri5o
KS4!6CK.#+ 7esco03acta o ar<1ivo in?or0a7o e0 10 7iret:rio. C Dor0ato 9
3ro3riet@rio( e 01&ti,3&ata?or0a( s13orta a3enas ar<1ivos co03acta7os 3e&a ?1n5o
KS6CK.R!SS#+.
6aso o ar<1ivo se=a 3rotegi7o 3or senBa( a3enas co0 a senBa 3o7ere0os 7esco03act@,
&o.
2anto ar<1ivos no &oca& # Re0ote + co0o no Servi7or so aceitos.
SPL!TPAT+
Reviso: 05/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
S."E2.A2[ # $ cAr< ' ( ) cc4rive * ( ) cc6a0inBo * ( ) ccHo0e * ( ) cc!t * + ,,'
HE"
.ar/0etros
Arg10ento 2i3o 4escri5o
cAr< 6aracter
Ho0e 7o Ar<1ivo a ser <1ebra7o. C3ciona&0ente( 3o7e
inc&1ir ca0inBo e 7rive.
c4rive 6aracter
Ho0e 7o 4rive. !e03&o # 6: +. 6aso o Ar<1ivo
in?or0a7o no 3oss1a 7rive o1 o ca0inBo re?ira,se ao
servi7or( o retorno ser@ 10a string e0 branco.
c6a0inBo 6aracter
Ho0e 7o 6a0inBo. 6aso o Ar<1ivo in?or0a7o no 3oss1a
ca0inBo( ser@ 10a string e0 branco.
cHo0e 6aracter
Ho0e 7o Ar<1ivo se0 a etenso. 6aso e0 cAr< no se=a
es3eci?ica7o 10 no0e 7o Ar<1ivo( ser@ retorna7a 10a
string e0 branco.
c!t 6aracter
!tenso 7o ar<1ivo in?or0a7o e0 cAr< ( 3re?iFa7a co0
10 3onto X.X. 6aso a etenso e0 cAr< no se=a
es3eci?ica7a ( o retorno ser@ 10a string e0 branco.
Retorno
2i3o 4escri5o
6aracter !sta ?1n5o se03re retorna HE".
4escri5o
A ?1n5o S3&it.atB#+ 7ivi7e 10 ca0inBo co03&eto e0 to7as as s1as s1b3artes # 4rive (
6a0inBo ( Ho0e e !tenso + .
2anto ar<1ivos &ocais # Re0ote + <1anto ar<1ivos no servi7or( 3o7e0 ser in?or0a7os.
C ca0inBo( caso in?or0a7o( inc&1ir@ 10a barra co0o >&ti0o caracter. A etenso (
<1an7o retorna7a ( inc&1i se03re o 3onto # . + antes 7a etenso.
2o7os os 3ar/0etros ( a 3artir 7o seg1n7o ( <1an7o 3assa7os 7eve0 ser 3or re?erncia.
O7ser/a8o E Va5e 5em7rar .ue a fun8o S25itPatB n8o /a5ida a sinta;e do caminBo
eKou ar.ui/o digitados 4 nem a e;istLncia do mesmo 0 Esta fun8o uti5i6ada 2ara
determinar em uma string os e5ementos .ue com2e um caminBo 2ara a
5oca5i6a8o de um ar.ui/o0
IR!TEPPROSTR!#G
Reviso: 05/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
RRE2!..RCS2REHJ # $ cSecao ' ( $ c6Bave ' ( $ c6onte17o ' ( $ cAr<Eni ' + ,,'
&S1cess
.ar/0etros
Arg10ento 2i3o 4escri5o
cSecao 6aracter
cSecao corres3on7e No no0e 7a se5o 7o Ani a ser
1ti&iFa7a. 6aso a se5o no eista ( a 0es0a ser@ cria7a.
c6Bave 6aracter
6Bave 7a se5o 7o ini a ter se1 conte>co a&tera7o . 6aso a
cBave no esista na se5o es3eci?ica7a( a 0es0a ser@
cria7a.
c6onte17o 6aracter
c6onte17o corres3on7e No conte>7o 7a cBave a ser
at1a&iFa7o.
cAr<Eni 6aracter
cAr<Eni corres3on7e ao no0e 7o ar<1ivo 7e inicia&iFa5o a
ser a&tera7o. 6aso o ar<1ivo no eista ( e&e ser@ cria7o .
6aso o 3atB 7o ar<1ivo no se=a in?or0a7o ( o 0es0o ser@
cria7o/at1a&iFa7o no 7iret:rio on7e est@ insta&a7o o
.rotBe1s Server( no servi7or. 6aso es3eci?ica7o 10 3atB
abso&1to ( co0 1ni7a7e 7e 7isco ( o ar<1ivo .ini ser@ cria7o
e/o1 at1a&iFa7o na esta5o re0ota ( no 3atB in?or0a7o.
Retorno
2i3o 4escri5o
":gico
6aso a cBave se=a inc&1i7a e/o1 a&tera7a co0 s1cesso ( a ?1n5o
retornat@ .2. #tr1e+ ( e caso ocorra a&g10a ?a&Ba o1 i03ossibi&i7a7e 7e
acesso ao ar<1ivo .ini ( a ?1n5o retornar@ .D. #?a&se+. 4entre as ca1sas 0ais
co01ns 7e ?a&Ba ( 3o7e0os citar erro 7e sintae no no0e 7o ar<1ivo e/o1
3atB ineistente o1 inacessAve&.
4escri5o
Atrav9s 7a ?1ncao Rrite..roString#+ ( 9 3ossAve& criar e/o1 a&terar 10a se5o / cBave 7e
con?ig1ra5o e0 10 ar<1ivo .ini . 6aso o ar<1ivo no eista ( o 0es0o ser@ cria7o . Ho
no0e 7o ar<1ivo ( 3o7e0os o3ciona&0ente 7e?inir 10 3atB abso&1to ( co0 1ni7a7e 7e
7isco ( 7e 0o7o <1e o ar<1ivo .ini ser@ at1a&iFa7o na esta5o re0ota # on7e est@ sen7o
eec1ta7o o .rotBe1s Re0ote + . 6aso no se=a es3eci?ica7o nenB10 3atB o1 ca0inBo
7o ar<1ivo .ini ( o ca0inBo 7e 7isco consi7era7o ser@ o 3atB no Servi7or on7e est@
insta&a7o o .rotBe1s Server .
Funes de tratamento de caracteres
ALLTR!M
Reviso: 26/02/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A""2REK # $ cString ' + ,,' c2ri0String
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
$cString' 9 a e3ressao caractere c1=os es3a5os e0 branco
serao e&i0ina7os.
Retorno
2i3o 4escri5o
6aracter
A""2REK#+ retorna 10a ca7eia 7e caracteres c1=os es3a5os e0 branco N
7ireita e N es<1er7a ?ora0 re0ovi7os.
4escri5o
A""2REK#+ 9 10a ?1n5o 7e trata0ento 7e 7a7os 7o ti3o caractere <1e re0ove os
es3a5os e0 branco N 7ireita e N es<1er7a 7e 10a ca7eia 7e caracteres. U re&aciona7a a
"2REK#+ e R2REK#+( <1e re0ove0 es3a5os e0 branco N es<1er7a e N 7ireita 7e 10a
ca7eia 7e caracteres( res3ectiva0ente. C inverso 7e A""2REK#+( "2REK#+( e R2REK#+
sao as ?1n5oes .A46#+( .A4R#+( e .A4"#+( as <1ais centra&iFa0( a&inBa0 N 7ireita( o1
a&inBa0 N es<1er7a ca7eias 7e caracteres atrav9s 7a inser5o 7e caracteres 7e
3reencBi0ento.
DES%E#D
Reviso: 08/09/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
4!S6!H4 # $ cString ' + ,,' c4escen7
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
$cString' corres3on7e N se<1ncia 7e caracteres a ser
ana&isa7a.
Retorno
2i3o 4escri5o
6aracter
4!S6!H4#+ retorna a string es3eci?ica7a co0o 3ar/0etro 7e 10a ?or0a
co03&e0enta7a. -0 4!S6!H4#+ 7e 6[R#0+ se03re retorna 6[R#0+.
4escri5o
4!S6!H4#+ 9 10a ?1n5o 7e converso <1e retorna a ?or0a co03&e0enta7a 7a
e3resso string es3eci?ica7a. !sta ?1n5o nor0a&0ente 9 1ti&iFa7a 3ara a cria5o 7e
in7ea7ores e0 Cr7e0 4ecrescente.
LTR!M
Reviso: 26/02/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
"2REK # $ cString ' + ,,' cStringRes1&t
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
$cString' 9 a ca7eia 7e caracteres a ser co3ia7a se0 os
es3a5os e0 branco N es<1er7a.
Retorno
2i3o 4escri5o
6aracter
"2REK#+ retorna 10a c:3ia 7e $cString'( sen7o <1e os es3a5os e0 branco
N es<1er7a ?ora0 re0ovi7os. 6aso $cString' se=a 10a ca7eia 7e caracteres
n1&a #XX+ o1 to7a co03osta 7e es3a5os e0 branco( "2REK#+ retorna 10a
ca7eia 7e caracteres n1&a #XX+.
4escri5o
"2REK#+ 9 10a ?1n5ao 7e trata0ento 7e caracteres 1ti&iFa7a 3ara Dor0atar ca7eias 7e
caracteres <1e 3oss1a0 es3a5os e0 branco N es<1er7a. .o7e ser o caso 7e( 3or ee03&o(
n>0eros converti7os 3ara ca7eias 7e caracteres atrav9s 7a ?1n5ao S2R#+.
"2REK#+ 9 re&aciona7a a R2REK#+( a <1a& re0ove es3a5os e0 branco N 7ireita( e a
A""2REK#+( <1e re0ove es3a5os tanto N es<1er7a <1anto N 7ireita. C contr@rio 7e
A""2REK#+( "2REK#+( e R2REK#+ sao as ?1n5oes .A46#+( .A4R#+( e .A4"#+( as
<1ais centra&iFa0( a&inBa0 N 7ireita( o1 a&inBa0 N es<1er7a as ca7eias 7e caracteres(
atrav9s 7a inser5ao 7e caracteres 7e 3reencBi0ento.
PADL K PADR K PAD%
Reviso: 26/02/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
.A4" / .A4R / .A46 # $ e3 ' ( $ n2a0anBo ' ( ) c6arac.reencB * + ,,'
cString.reencB
.ar/0etros
Arg10ento 2i3o 4escri5o
e3 6aracter
$e3' 9 10 va&or caractere( 7ata( o1 n109rico no <1a&
serao inseri7os caracteres 7e 3reencBi0ento.
n2a0anBo H109rico
$n2a0anBo' 9 o ta0anBo 7a ca7eia 7e caracteres a ser
retorna7a.
c6arac.reencB 6aracter
$c6arac.reencB' 9 o caractere a ser inseri7o e0 $e3'.
6aso nao se=a es3eci?ica7o( o 3a7rao 9 o es3a5o e0
branco.
Retorno
2i3o 4escri5o
6aracter
.A46#+( .A4"#+( e .A4R#+ retorna0 o res1&ta7o 7e $e3' na ?or0a 7e
10a ca7eia 7e caracteres 3reencBi7a co0 $c6arac.reencB'( 3ara tota&iFar
o ta0anBo es3eci?ica7o 3or $n2a0anBo'.
4escri5o
.A46#+( .A4"#+( e .A4R#+ sao ?1n5oes 7e trata0ento 7e caracteres <1e insere0
caracteres 7e 3reencBi0ento e0 va&ores caractere( 7ata o1 n109ricos a ?i0 7e criar 10a
nova ca7eia 7e caracteres 7e ta0anBo es3eci?ica7o. .A46#+ centra&iFa $e3'(
a7icionan7o caracteres 7e 3reencBi0ento N 7ireita e N es<1er7aY .A4"#+ a7iciona
caracteres 7e 3reencBi0ento N es<1er7aY e .A4R#+ a7iciona caracteres 7e
3reencBi0ento N 7ireita. 6aso o ta0anBo 7e $e3' ece7a o arg10ento $n2a0anBo'(
to7as as ?1n5oes .A4#+ tr1nca0 cString.reencB ao $n2a0anBo' es3eci?ica7o.
.A46#+( .A4"#+( e .A4R#+ sao 1ti&iFa7as 3ara eibir ca7eias 7e caracteres 7e ta0anBo
vari@ve& e0 10a @rea 7e ta0anBo ?io. !&as 3o7e0 ser 1sa7as( 3or ee03&o( 3ara
asseg1rar o a&inBa0ento co0 co0an7os hh consec1tivos. C1tra 1ti&iFa5ao 9 eibir tetos
e0 10a te&a 7e ta0anBo ?io( 3ara certi?icar,se 7e <1e o teto anterior ?oi
co03&eta0ente sobreescrito.
.A46#+( .A4"#+( e .A4R#+ sao o contr@rio 7as ?1n5oes A""2REK#+( "2REK#+( e
"2REK#+( as <1ais e&i0ina0 es3a5oes e0 branco N es<1er7a e N 7ireita 7e ca7eias 7e
caracteres.
RTR!M
Reviso: 26/02/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
R2REK # $ cString ' + ,,' c2ri0String
.ar/0etros
Arg10ento 2i3o 4escri5o
cString 6aracter
$cString' 9 a ca7eia 7e caracteres a ser co3ia7a se0 os
es3a5os e0 branco N 7ireita.
Retorno
2i3o 4escri5o
6aracter
R2REK#+ retorna 10a c:3ia 7e $cString'( sen7o <1e os es3a5os e0
branco N 7ireita ?ora0 re0ovi7os. 6aso $cString' se=a 10a ca7eia 7e
caracteres n1&a #XX+ o1 tota&0ente co03osta 3or es3a5os( R2REK#+ retorna
10a ca7eia 7e caracteres n1&a #XX+.
4escri5o
R2REK#+ 9 10a ?1n5ao 7e trata0ento 7e caracteres 1ti&iFa7a 3ara Dor0atar ca7eias 7e
caracteres <1e contenBa0 es3a5os e0 branco N 7ireita. !&a 9 >ti& <1an7o voc 7ese=a
e&i0inar es3a5os e0 branco N 7ireita ao se concatenar ca7eias 7e caracteres. U o caso
tA3ico co0 ca03os 7e banco 7e 7a7os <1e sao ar0aFena7os e0 ?or0ato 7e ta0anBo
?io. .or ee03&o( voc 3o7e 1sar R2REK#+ 3ara concatenar o 3ri0eiro e o >&ti0o
ca03os 7e no0e 3ara ?or0ar 10a ca7eia 7e caracteres 7e no0e.
"2REK#+ 9 re&aciona7a a R2REK#+( <1e re0ove es3a5os e0 branco N 7ireita( e a
A""2REK#+( <1e re0ove es3a5os e0 branco N 7ireita e N es<1er7a. C contr@rio 7e
A""2REK#+( "2REK#+( e R2REK#+ sao as ?1n5oes .A46#+( .A4R#+( e .A4"#+( as
<1ais centra&iFa0( a&inBa0 N 7ireita( o1 a&inBa0 N es<1er7a ca7eias 7e caracteres(
inserin7o caracteres 7e 3reencBi0ento.
FuncMes de Tratamento de Data K +ora
%DOI
Reviso: 0I/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
64CR # $ 7!3 ' + ,,' cHo0e4ia
.ar/0etros
Arg10ento 2i3o 4escri5o
7!3 4ata $7!3' 9 o va&or 7ata a ser converti7o.
Retorno
2i3o 4escri5o
6aracter
64CR#+ retorna o no0e 7o 7ia 7a se0ana na ?or0a 7e 10a ca7eia 7e
caracteres. A 3ri0eira &etra ser@ 0ai>sc1&a e o resto 7os caracteres vir@ e0
0in>sc1&as. .ara 10 va&or 7e 7ata n1&o o1 inv@&i7o( 64CR#+ retorna 10a
ca7eia 7e caracteres vaFia #XX+.
4escri5o
64CR#+ 9 10a ?1n5o 1ti&iFa7a 3ara obter( a 3artir 7e 10a 7ata( a ca7eia 7e caracteres
conten7o o 7ia 7a se0ana corres3on7ente.
%MO#T+
Reviso: 0I/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
6KCH2[ # $ 74ata ' + ,,' cKs
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 a 7ata a converter.
Retorno
2i3o 4escri5o
6aracter
6KCH2[#+ retorna o no0e 7o 0s a 3artir 7e 10a 7ata co0o sen7o 10a
ca7eia 7e caracteres co0 a 3ri0eira &etra 0ai>sc1&a e o restante 7a string
e0 &etras 0in>sc1&as. .ara 10a 7ata n1&a( 6KCH2[#+ retornar@ 10a
string n1&a #XX+.
4escri5o
6KCH2[#+ 9 10a ?1n5o 7e converso 7e 7atas <1e ( a 3artir 7e 10a 7ata ( retorna
10a ca7eia 7e caracteres corres3on7en7o ao no0e 7o 0s corres3on7ente.
DATE
Reviso: 0I/08/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
4A2! # + ,,' 7Siste0a
Retorno
2i3o 4escri5o
4ata 4A2!#+ retorna a 7ata 7o siste0a co0o sen7o 10 va&or 7o ti3o 7ata.
4escri5o
Retorna a 7ata 7o siste0a.
4A2!#+ 9 a ?1n5o <1e retorna a 7ata 7o at1a& siste0a. C ?or0ato 7e
saA7a 9 contro&a7o 3e&o co0an7o S!2 4A2!. C ?or0ato 3a7ro 9 00/77/MM.
DA
Reviso: 22/09/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
4AL # $ 74ata ' + ,,' n4ia
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 a 7ata a converter.
Retorno
2i3o 4escri5o
H109rico
4AL#+ retorna 10 n>0ero na ?aia 7e 0 at9 O1( sen7o este 10 va&or
n109rico inteiro. 6aso o 0s se=a Devereiro( os anos bissetos sao
consi7era7os. Se o arg10ento 7e 7ata 9 29 7e Devereiro e o ano nao 9
bisseto( 4AL#+ retornar@ Fero. Se o arg10ento 7e 7ata 9 vaFio( 4AL#+
ta0b90 retornar@ Fero.
4escri5o
Retorna o 7ia 7o 0s co0o va&or n109rico. 4AL#+ 9 10a ?1n5ao 7e conversao 7e 7atas
1ti&iFa7a 3ara converter 10 va&or 7o ti3o 7ata 3ara o 7ia 7o 0s corres3on7ente. !sta
?1n5o 9 1sa7a e0 con=1nto co0 6KCH2[#+ e L!AR#+ 3ara ?or0atar 7atas. A&90
7isso( 9 gera&0ente 1sa7a e0 c@&c1&os <1e envo&va0 7atas.
DOI
Reviso: 1O/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
4CR # $ 74ata ' + ,,' n4ia
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 o va&or 7ata <1e ser@ converti7o.
Retorno
2i3o 4escri5o
H109rico
4CR#+ retorna o 7ia 7a se0ana na ?or0a 7e 10 n>0ero entre Fero e sete.
C 3ri0eiro 7ia 7a se0ana 9 10 #4o0ingo+ e o >&ti0o 9 sete #S@ba7o+. Se
$74ata' estiver vaFio( 4CR#+ retorna Fero.
4escri5o
4CR#+ 9 10a ?1n5ao 7e conversao 7e 7atas <1e converte 10 va&or 7ata 3ara 10
n>0ero <1e i7enti?ica o 7ia 7a se0ana. !&a 9 >ti& <1an7o voc 7ese=a c@&c1&os 7e 7ata
e0 10a base se0ana&. 4CR#+ 9 se0e&Bante a 64CR#+( a <1a& retorna o 7ia 7a se0ana
na ?or0a 7e 10a ca7eia 7e caracteres ao inv9s 7e 10 n>0ero.
DTO%
Reviso: 1O/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
42C6 # $ 74ata ' + ,,' c4ata
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 o va&or 7ata <1e ser@ converti7o.
Retorno
2i3o 4escri5o
6aracter
42C6#+ retorna 10a ca7eia 7e caracteres <1e re3resenta 10a 7ata. C va&or
7e retorno 9 ?or0ata7o 7e acor7o co0 o ?or0ato 7e 7atas corrente. C
?or0ato 3a7rao 9 00/77/aa. -0a 7ata n1&a retorna 10a ca7eia 7e
caracteres e0 branco ig1a& e0 ta0anBo ao ?or0ato 7e 7ata corrente.
4escri5o
42C6#+ 9 10a ?1n5ao 7e conversao 7e 7atas 1ti&iFa7a 3or 0otivos 7e Dor0ata5ao
<1an7o voc 7ese=a eibir a 7ata no ?or0ato S!2 4A2! e 9 necess@ria 10a e3ressao
caractere. 6aso voc 3recise 7e 10 ?or0ato 7e 7ata es3ecA?ico( voc 3o7e 1ti&iFar
2RAHSDCRK#+ o1 10a e3ressao c1sto0iFa7a.
Se voc estiver EH4!Tan7o 10a 7ata =1nta0ente co0 10a ca7eia 7e caracteres( 1se
42CS#+ ao inv9s 7e 42C6#+ 3ara converter o va&or 7ata 3ara 10a ca7eia 7e caracteres.
ELAPT!ME
Reviso: 08/09/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
!"A.2EK! # $ c[oraEnicia& ' ( $ c[oraDina& ' + ,,' cEnterva&o
.ar/0etros
Arg10ento 2i3o 4escri5o
c[oraEnicia& 6aracter
En?or0e a Bora inicia& no ?or0ato BB:00:ss( on7e BB 9 a
Bora # 1 a 2I +( 00 os 0in1tos e ss os seg1n7os
c[oraDina& 6aracter
En?or0e a Bora ?ina& no ?or0ato BB:00:ss( on7e BB 9 a
Bora # 1 a 2I +( 00 os 0in1tos e ss os seg1n7os.
Retorno
2i3o 4escri5o
6aracter
A 7i?eren5a 7e te03o no ?or0ato BB:00:ss( on7e BB 9 a Bora # 1 a 2I +(
00 os 0in1tos e ss os seg1n7os
4escri5o
!&a32i0e#+ retorna 10a ca7eia 7e caracteres conten7o a 7i?eren5a 7e
te03o entre c[oraDina& , c[oraEnicia& ( no ?or0ato BB:00:ss.
Cs 7ois 3ar/0etros ( c[oraEnicia& e c[oraDina& ( 7eve0 ser es3eci?ica7os no ?or0ato
BB:00:ss ( co0 ta0anBo 7e 8 bMtes . 6aso 10 7os 3ar/0etros tenBa ta0anBo 7i?erente
7e 8 %Mtes( 9 gera7a 10a ocorrncia 7e !rro Data& Xinva&i7 &enX. ;1a&<1er caracter
inva&i7o nas 3osices re?erentes N Bora #BB+ ( 0in1to #00+ e seg1n7o #ss+ ( sero
ignora7os na co03osi5o 7e n10eros 3ara o c@&c1&o. 6aso o Bor@rio inicia& se=a 0aior
<1e o Bor@rio ?ina& ( 9 retorna7a a 7i?eren5a entre os Bor@rios acresci7os 7e 2IB. .ara
0aiores 7eta&Bes ( cons1&te o ee03&o 7a ?1n5o !&a32i0e#+
MO#T+
Reviso: 22/09/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
KCH2[ # $ 74ata ' + ,,' nKs
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 o va&or 7ata a ser converti7o.
Retorno
2i3o 4escri5o
H109rico
KCH2[#+ retorna 10 va&or n109rico inteiro na ?aia 7e 0 #Fero+ a 12.
-0a 7ata n1&a #62C4#XX++ retorna Fero.
4escri5o
KCH2[#+ 9 10a ?1n5ao 7e conversao 7e 7atas <1e 9 >ti& <1an7o voc 3recisa 7e 10
va&or 7e 0s n109rico 71rante c@&c1&os 3ara( 3or ee03&o( re&at:rios 3eri:7icos.
KCH2[#+ ?aF 3arte 7e 10 gr13o 7e ?1n5oes <1e retorna0 co03onentes 7e 10 va&or
7ata na ?or0a 7e va&ores n109ricos. C gr13o inc&1i 4AL#+ e L!AR#+( <1e retorna0 os
va&ores 7e 7ia e ano na Dor0a 7e n>0ericos. 6KCH2[#+ 9 10a ?1n5ao re&aciona7a(
<1e 3er0ite a voc retornar o no0e 7o 0s a 3artir 7e 10 va&or 7ata.
SE%O#DS
Reviso: 09/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
S!6CH4S # + ,,' nSeg1n7os
Retorno
2i3o 4escri5o
H109rico
S!6CH4S#+ retorna a Bora 7o siste0a co0o 10 va&or n109rico na ?or0a
seg1n7os.cent9si0os. C va&or n109rico retorna7o 9 a <1anti7a7e 7e
seg1n7os 7ecorri7os 7es7e a 0eia,noite( e te0 base e0 10 re&:gio 7e
vinte e <1atro Boras e0 10a ?aia 7e Fero a 86O99.
4escri5o
S!6CH4S#+ 9 10a ?1n5ao 7e Boras 1ti&iFa7a 3ara ?ornecer 10 09to7o si03&es 7e
ca&c1&ar o te03o 7ecorri7o( co0 base no re&:gio 7o siste0a( 71rante a eec15ao 7o
3rogra0a. U re&aciona7o N ?1n5ao 2EK!#+( a <1a& retorna a Bora 7o siste0a co0o 10a
ca7eia 7e caracteres na ?or0a BB:00:ss.
T!ME
Reviso: 1O/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
2EK! # + ,,' cString[ora
Retorno
2i3o 4escri5o
6aracter
2EK!#+ retorna a Bora 7o siste0a co0o 10a ca7eia 7e caracteres na ?or0a
BB:00:ss. BB in7ica a Bora no ?or0ato 7e 2I Boras( 00 in7ica os 0in1tos(
e ss in7ica os seg1n7os. [oras( 0in1tos e seg1n7os sao se3ara7as 3or 7ois
3ontos.
4escri5o
2EK!#+ 9 10a ?1n5ao 7e trata0ento 7e te03o( 1ti&iFa7a 3ara eibir o1 i03ri0ir a Bora
7o siste0a e0 10 re&at:rio o1 na te&a. 2EK!#+ est@ re&aciona7a a S!6CH4S#+( <1e
retorna a <1anti7a7e 7e seg1n7os 7ecorri7os 7es7e a 0eia,noite. S!6CH4S#+
gera&0ente 9 1ti&iFa7a e0 &1gar 7e 2EK!#+ 3ara c@&c1&os sobre o te03o.
EAR
Reviso: 1O/10/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
L!AR # $ 74ata ' + ,,' nAno
.ar/0etros
Arg10ento 2i3o 4escri5o
74ata 4ata $74ata' 9 o va&or 7ata a ser converti7o.
Retorno
2i3o 4escri5o
H109rico
L!AR#+ retorna o ano 7o va&or 7ata es3eci?ica7o( inc&1sive 7Agitos
in7icativos 7e s9c1&o( na ?or0a 7e 10 va&or n109rico 7e <1atro 7Agitos. C
va&or retorna7o nao 9 in?&1encia7o 3e&o ?or0ato 7e 4A2! o1 6!H2-RL
corrente. A es3eci?ica5ao 7e 10a 7ata n1&a #62C4#XX++ retorna Fero.
4escri5o
L!AR#+ 9 10a ?1n5ao 7e conversao 7e 7atas 1ti&iFa7a 3ara converter 10 va&or 7ata 3ara
10 va&or n109rico in7icativo 7o ano. .o7e ser 1ti&iFa7a e0 c@&c1&os 7e( 3or ee03&o(
re&at:rios 3eri:7icos( o1 3ara Dor0ata5ao 7e eibi5oes 7e 7ata.
L!AR#+ 9 0e0bro 7e 10 gr13o 7e ?1n5oes <1e retorna0 co03onentes 7e 10 va&or
7ata na ?or0a 7e va&ores n109ricos. !ste gr13o inc&1i 4AL#+ e KCH2[#+( <1e
retorna0 va&ores 7e 7ia e 0s na ?or0a 7e va&ores n109ricos.
FuncMes de Tratamento de Matri6es =ArraHs>
AADD
Reviso: 26/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
AA44 # $ a4estino ' ( ) e3Va&or * + ,,' Va&or
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM U o arraM ao <1a& o novo e&e0ento ser@ a7iciona7o.
e3Va&or #;1a&<1er+
U 10a e3resso v@&i7a <1e ser@ o va&or 7o
novo e&e0ento.
Retorno
2i3o 4escri5o
#;1a&<1er+
Ava&ia e3Va&or e retorna se1 Va&or. Se e3Va&or no ?or es3eci?ica7o(
AA44#+ retorna HE".
4escri5o
AA44#+ 9 10a ?1n5o 7e trata0ento 7e vetor <1e a7iciona 10 e&e0ento ao vetor. Ao
e&e0ento 7e vetor rec90 cria7o 9 atrib1i7o o va&or es3eci?ica7o 3or $e3Va&or'.
AA44#+ 9 1ti&iFa7o 3ara a10entar o ta0anBo 7e 10 vetor 7ina0ica0ente. U >ti& na
constr15o 7e ?i&as o1 &istas 7in/0icas.
AA44#+ 9 se0e&Bante N ?1n5o ASEV!#+( 0as a7iciona a3enas 10 e&e0ento 3or veFY
ASEV!#+ 3o7e a10entar o1 7i0in1ir 10 vetor a 10 ta0anBo es3eci?ica7o. AA44#+(
3or90( 3oss1i a vantage0 7e 3o7er atrib1ir 10 va&or ao novo e&e0ento( en<1anto <1e
ASEV!#+ nao 3o7e. AA44#+ 3o7e ta0b90 3arecer ser ig1a& a AEHS#+( 0as isso nao 9
ver7a7e: AEHS#+ 0ove e&e0entos 7entro 7e 10 vetor( 0as nao 0o7i?ica o ta0anBo 7o
vetor.
O)SERVACDO E 6aso $e3Va&or' se=a 10 o1tro vetor( o novo e&e0ento no vetor
7estino conter@ 10a re?erncia ao vetor es3eci?ica7o 3or $e3Va&or'.
A%LO#E
Reviso: 1O/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A6"CH! # $ aDonte ' + ,,' a413&ica
.ar/0etros
Arg10ento 2i3o 4escri5o
aDonte ArraM $aDonte' 9 o vetor a ser 713&ica7o.
Retorno
2i3o 4escri5o
ArraM ArraM i7ntico ao aDonte ( 3ore0 se0 nenB10a re?erncia ao 0es0o.
4escri5o
A6"CH!#+ 9 10a ?1n5ao 7e vetor <1e cria 10a 713&icata co03&eta 7o vetor 7e
$aDonte'. 6aso $aDonte' contenBa s1b,vetores( A6"CH!#+ cria s1b,vetores
corres3on7entes e os 3reencBe co0 c:3ias 7os va&ores conti7os nos s1b,vetores 7e
$aDonte'.
Ao ig1a&ar0os 7ois arraMs( e&es ?ica0 associa7os 3or re?erncia( 1ti&iFan7o
a6&one#+ no eiste re?erncia. A6"CH!#+ 9 se0e&Bante a A6C.L#+( 3or90 A6C.L#+
nao 713&ica vetores aninBa7os.
A%OP
Reviso: 1O/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
A6C.L # $ aDonte ' ( $ a4estino ' ( ) nEnicio * ( ) n6ont * ( ) n.os4estino * + ,,'
a4estino
.ar/0etros
Arg10ento 2i3o 4escri5o
aDonte ArraM $aDonte' 9 o vetor 7e on7e serao co3ia7os os e&e0entos.
a4estino ArraM
$a4estino' 9 o vetor 3ara on7e serao co3ia7os os
e&e0entos.
nEnicio H109rico
$nEnicio' 9 a 3osi5ao 7o e&e0ento inicia& no vetor
$aDonte'. Se nao ?or es3eci?ica7o( o va&or ass10i7o 9 10
#01+.
n6ont H109rico
$n6ont' 9 a <1anti7a7e 7e e&e0entos a sere0 co3ia7os 7o
vetor $aDonte' a 3artir 7a 3osi5ao $nEnicio'. 6aso
$n6ont' nao se=a es3eci?ica7o( to7os os e&e0entos e0
$aDonte' <1e co0e5a0 co0 o e&e0ento inicia& sao
co3ia7os.
n.os4estino H109rico
$n.os4estino' 9 a 3osi5ao 7o e&e0ento inicia& no vetor
$a4estino' <1e receber@ os e&e0entos 7e $aDonte'. Se
nao ?or es3eci?ica7o( o va&or 3a7rao 9 10 #01+.
Retorno
2i3o 4escri5o
ArraM A6C.L#+ retorna 10a re?erncia ao vetor 7estino( $a4estino'.
4escri5o
A6C.L#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e co3ia e&e0entos 7o vetor $aDonte'
3ara o vetor $a4estino'. C vetor $a4estino' =@ 7eve eistir e ser gran7e o s1?iciente
3ara conter os e&e0entos co3ia7os. 6aso o vetor $aDonte' tenBa 0ais e&e0entos( a&g1ns
e&e0entos nao serao co3ia7os.
A6C.L#+ co3ia va&ores 7e to7os os ti3os 7e 7a7os( inc&1sive HE" e b&ocos 7e c:7igo.
Se 10 e&e0ento 7o vetor $aDonte' ?or 10 s1b,vetor( o e&e0ento corres3on7ente no
vetor $a4estino' conter@ 10a re?erncia ao s1b,vetor. 6onse<1ente0ente( A6C.L#+
nao cria 713&icatas co03&etas 7e vetores 01&ti,7i0ensionais. .ara ?aFer isto( 1se a
?1n5ao A6"CH!#+.
ADEL
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A4!" # $ aDonte ' ( $ n.osicao ' + ,,' aDonte
.ar/0etros
Arg10ento 2i3o 4escri5o
aDonte ArraM
$aDonte' 9 o vetor <1e cont90 10 e&e0ento a ser
e&i0ina7o.
n.osicao H109rico
$n.osi5ao' 9 a 3osi5ao 7o e&e0ento 7e vetor ( a 3artir 7o
3ri0eiro ( <1e ser@ e&i0ina7o.
Retorno
2i3o 4escri5o
ArraM A4!"#+ retorna 10a re?erncia ao vetor 7estino( $aDonte'.
4escri5o
A4!"#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e e&i0ina 10 e&e0ento 7e 10 vetor. C
conte>7o 7o e&e0ento 7e vetor es3eci?ica7o 9 3er7i7o( e to7os os e&e0entos a 3artir
7a<1e&a 3osi5ao at9 o ?ina& 7o e&e0ento sobe0 10a 3osi5ao. C >&ti0o e&e0ento no
vetor torna,se HE".
AVESC : !0 A7v3&( vetores 01&ti,7i0ensionais sao i03&e0enta7os atrav9s 7o
aninBa0ento 7e vetores 7entro 7e o1tros vetores. 6aso o vetor $aDonte' se=a 10 vetor
01&ti,7i0ensiona&( A4!"#+ e&i0inar@ to7o o s1b,vetor es3eci?ica7o 3or $n.osi5ao'(
?or5an7o $aDonte' a nao 0ais ter 7i0ensoes reg1&ares.
AEVAL
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
A!VA" # $ aVetor ' ( $ b%&oco ' ( ) nEnicio * ( ) n6ont * + ,,' aVetor
.ar/0etros
Arg10ento 2i3o 4escri5o
aVetor ArraM $aVetor' 9 o vetor a ser varri7o.
b%&oco 6o7e,%&oc8
$b%&oco' 9 10 b&oco 7e c:7igo a ser eec1ta7o 3ara
ca7a e&e0ento encontra7o.
nEnicio H109rico
$nEnicio' 9 o e&e0ento inicia&. 6aso nao se=a
es3eci?ica7o( o 3a7rao ass10i7o 9 o e&e0ento 10.
n6ont H109rico
$n6ont' 9 a <1anti7a7e 7e e&e0entos a sere0
3rocessa7os a 3artir 7e $nEnAcio'. Se nao ?or
es3eci?ica7o( o 3a7rao 9 to7os os e&e0entos no vetor.
Retorno
2i3o 4escri5o
ArraM A!VA"#+ retorna 10a re?erncia a $aVetor'.
4escri5o
A!VA"#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e ava&ia 10 b&oco 7e c:7igo 10a veF
3ara ca7a e&e0ento 7e 10 vetor( 3assan7o o va&or 7o e&e0ento co0o 10 3ar/0etro 7e
b&oco. C va&or 7e retorno 7o b&oco 9 ignora7o. 2o7os os e&e0entos no $aVetor' sao
3rocessa7os a nao ser <1e o arg10ento $nEnicio' o1 $n6ont' se=a es3eci?ica7o.
A!VA"#+ nao ?aF s13osi5oes sobre o conte>7o 7os e&e0entos 7e vetor <1e e&e est@
3assan7o 3ara o b&oco. U ass10i7o <1e o b&oco sabe <1a& o ti3o 7e 7a7os Baver@ e0
ca7a e&e0ento.
A!VA"#+ 9 se0e&Bante a 4%!VA"#+( <1e a3&ica 10 b&oco 3ara ca7a registro 7e 10
ar<1ivo 7e banco 7e 7a7os. 4a 0es0a ?or0a <1e 4%!VA"#+( A!VA"#+ 3o7e ser
1ti&iFa7o co0o base 3ara a constr15ao 7e co0an7os 7e intera5ao tanto 3ara estr1t1ras 7e
vetor co03&eas co0o si03&es.
6ons1&te a se5ao %&ocos 7e 6:7igo no na se5o A "ing1age0 A7v3& 3ara 0aiores
in?or0a5es sobre 6o7e,%&oc8s.
AF!LL
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
ADE"" # $ a4estino ' ( $ Va&or!3 ' ( ) nEnicio * ( ) n6ont * + ,,' a4estino
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM $a4estino' 9 o vetor a ser 3reencBi7o.
Va&or!3 #;1a&<1er+
$Va&or!3' 9 o va&or a ser a&oca7o e0 ca7a e&e0ento 7e
vetor. .o7e ser 10a e3ressao 7e <1a&<1er ti3o 7e 7a7os
v@&i7o.
nEnicio H109rico
$nEnicio' 9 a 3osi5ao 7o 3ri0eiro e&e0ento a ser
3reencBi7o. 6aso este arg10ento se=a o0iti7o( o va&or
3a7rao 9 10.
n6ont H109rico
$n6ont' 9 a <1anti7a7e 7e e&e0entos a sere0
3reencBi7os inician7o co0 o e&e0ento $nEnicio'. Se este
arg10ento ?or o0iti7o( os e&e0entos sao 3reencBi7os a
3artir 7a 3osi5ao 7o e&e0ento inicia& at9 o ?ina& 7o vetor.
Retorno
2i3o 4escri5o
ArraM ADE""#+ retorna 10a re?erncia ao $a4estino'.
4escri5o
ADE""#+ 9 10a ?1n5ao 7e vetor <1e 3reencBe 10 vetor es3eci?ica7o co0 10 >nico
va&or 7e <1a&<1er ti3o 7e 7a7os #inc&1sive vetores( b&ocos 7e c:7igo o1 HE"+ atrib1in7o
$Va&or!3' a ca7a e&e0ento 7e vetor na ?aia es3eci?ica7a.
A2!HijC : ADE""#+ nao 3o7e ser 1ti&iFa7o 3ara 3reencBer vetores 01&ti,
7i0ensionais. !ste ti3o 7e vetores e0 6&i33er sao i03&e0enta7os aninBan7o,se vetores
7entro 7e o1tros vetores. A 1ti&iFa5ao 7e ADE""#+ co0 vetores 01&ti,7i0ensionais
sobre,escrever@ vetores 3ara as o1tras 7i0ensoes 7o vetor.
A!#S
Reviso: 16/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
AEHS # $ a4estino ' ( $ cn.os ' + ,,' a4estino
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM U o arraM 7e on7e ser@ inseri7o 10 ite0 HE".
n.os H109rico
U a 3osi5o( a 3artir 7a 1( na <1a& ser@ inseri7o 10
e&e0ento HE"
Retorno
2i3o 4escri5o
ArraM Retorna 10a re?erncia ao vetor a4estino
4escri5o
AEHS#+ 9 10a ?1n5o 7e vetor <1e insere 10 novo e&e0ento e0 10 vetor es3eci?ica7o.
C e&e0ento rec90 inseri7o 9 HE" at9 <1e 10 novo va&or se=a atrib1i7o a e&e. A3:s a
inser5o( o >&ti0o e&e0ento no vetor 9 7escarta7o( e to7os os e&e0entos 7e3ois 7o novo
e&e0ento 7esce0 10a 3osi5o.
n AVESC : AEHS#+ 7eve ser 1ti&iFa7o co0 c1i7a7o <1an7o se tratar 7e vetores 01&ti,
7i0ensionais. Vetores 01&ti,7i0ensionais e0 A7v3& sao i03&e0enta7os atrav9s 7o
aninBa0ento 7e vetores 7entro 7e o1tros vetores. -ti&iFar AEHS#+ co0 10 vetor 01&ti,
7i0ensiona& 7escarta o >&ti0o s1b,vetor no vetor 7estino es3eci?ica7o( o <1e ca1sa a
3er7a 7e 10a o1 0ais 7i0ensoes. .ara inserir 10a nova 7i0ensao e0 10 vetor(
3ri0eira0ente a7icione 10 novo e&e0ento ao ?ina& 7o vetor 1ti&iFan7o AA44#+ o1
ASEV!#+ antes 7e 1sar AEHS#+.
ARRA
Reviso: 26/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verses Anteriores
Sintae
ARRAL # $ n!&e0entos(... ' + ,,' aVetor
.ar/0etros
Arg10ento 2i3o 4escri5o
n!&e0entos(... H109rico
$n!&e0entos' 9 a <1anti7a7e 7e e&e0entos na 7i0ensao
es3eci?ica7a.Cs vetores e0 A7v3& 3o7e0 ter 10 n>0ero
i&i0ita7o 7e 7i0ensoes.
Retorno
2i3o 4escri5o
ArraM ARRAL#+ retorna 10 vetor 7e 7i0ensoes es3eci?ica7as.
4escri5o
ARRAL#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e retorna 10 vetor nao inicia&iFa7o
co0 a <1anti7a7e es3eci?ica7a 7e e&e0entos e 7i0ensoes. Se ?or es3eci?ica7o 0ais 7e
10 arg10ento $n!&e0entos'( 9 cria7o 10 vetor 01&ti,7i0ensiona& o1 aninBa7o( sen7o
<1e a <1anti7a7e 7e 7i0ensoes 9 ig1a& N <1anti7a7e 7e arg10entos $n!&e0entos'
es3eci?ica7a.
Ho A7v3&( B@ v@rias ?or0as 7e se criar 10 vetor. Voc 3o7e 7ec&arar 10 vetor
1ti&iFan7o "C6A" o1 S2A2E6Y voc 3o7e criar 10 vetor 1ti&iFan7o .REVA2! o1
.-%"E6Y voc 3o7e atrib1ir 10 vetor &itera& a 10a vari@ve& eistenteY o1 voc 3o7e
1sar a ?1n5ao ARRAL#+. ARRAL#+ te0 a vantage0 7e 3ossibi&itar a voc a cria5ao 7e
vetores 7entro 7e e3ressoes o1 b&ocos 7e c:7igo.
AS%A#
Reviso: 26/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
AS6AH # $ a4estino ' ( $ .roc1ra!3 ' ( ) nEnicio * ( ) n6ont * + ,,' n.aro1!0
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM $a4estino' 9 o vetor a ser varri7o.
.roc1ra!3 #;1a&<1er+
$.roc1ra!3' 3o7e ser 10 va&or si03&es a ser 3roc1ra7o(
o1 10 b&oco 7e c:7igo. 6aso $.roc1ra!3' se=a 10 va&or
si03&es( este 3o7er@ ser 7o ti3o n109rico( &:gico( 7ata( o1
caractere.
nEnicio H109rico
$nEnicio' 9 o e&e0ento a 3artir 7o <1a& ter@ inAcio a
3es<1isa. Se este arg10ento nao ?or es3eci?ica7o( a
3osi5ao inicia& 3a7rao 9 10.
n6ont H109rico
$n6ont' 9 a <1anti7a7e 7e e&e0entos <1e serao varri7os a
3artir 7a 3osi5ao inicia&. 6aso este arg10ento nao se=a
es3eci?ica7o( to7os os e&e0entos( 7es7e o e&e0ento inicia&
at9 o ?ina& 7o vetor( serao varri7os.
Retorno
2i3o 4escri5o
H109rico
AS6AH#+ retorna 10 va&or n109rico <1e re3resenta a 3osi5ao oc13a7a no
vetor 3e&o >&ti0o e&e0ento varri7o. Se $.roc1ra!3' ?or 10 va&or
si03&es( AS6AH#+ retorna a 3osi5ao 7o 3ri0eiro e&e0ento <1e
corres3on7er ao va&or 3roc1ra7o( o1 Fero caso nao Ba=a corres3on7ncia.
Se $.roc1ra!3' ?or 10 b&oco 7e c:7igo( AS6AH#+ retorna a 3osi5ao 7o
e&e0ento on7e o b&oco retorno1 ver7a7eiro #.2.+.
4escri5o
AS6AH#+ 9 10a ?1n5ao 7e trata0ento 7e vetor <1e varre 10 vetor 3roc1ran7o 10 va&or
es3eci?ica7o e o3era 7a 0es0a ?or0a <1e o co0an7o S!!f <1an7o 3es<1isa 10 va&or
si03&es. C va&or $.roc1ra!3' 9 co03ara7o ao e&e0ento 7e vetor 7estino <1e co0e5a
co0 o caractere 0ais N es<1er7a no e&e0ento 7estino e 3rosseg1e at9 <1e nao Ba=a 0ais
nenB10 caractere e0 $.roc1ra!3'. 6aso nao Ba=a corres3on7ncia( AS6AH#+ vai
3ara o 3r:i0o e&e0ento no vetor.
6o0o AS6AH#+ 1ti&iFa o o3era7or #_+ 3ara co03ara5oes( e&e 9 sensAve& ao stat1s 7e
!TA62. 6aso !TA62 este=a CH( o e&e0ento 7e vetor 7estino 7eve ser eata0ente
ig1a& ao res1&ta7o 7e $.roc1ra!3' 3ara <1e Ba=a corres3on7ncia.
Se o arg10ento 7e $.roc1ra!3' se=a 10 b&oco 7e c:7igo( AS6AH#+ varre o vetor
$a4estino' eec1tan7o o b&oco 3ara ca7a e&e0ento acessa7o. o 0e7i7a e0 <1e ca7a
e&e0ento 9 encontra7o( AS6AH#+ 3assa o va&or 7o e&e0ento co0o 10 arg10ento 3ara
o b&oco 7e c:7igo( e 7e3ois eec1ta 10 !VA"#+ no b&oco. A o3era5ao 7e 3es<1isa 3@ra
<1an7o o b&oco 7e c:7igo retorna ver7a7eiro #.2.+( o1 <1an7o AS6AH#+ atinge o >&ti0o
e&e0ento no vetor.
AS!(E
Reviso: 1O/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
ASEV! # $ a4estino ' ( $ cn2a0anBo ' + ,,' ASEV!#+
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM $a4estino' 9 o vetor a ser a10enta7o o1 7i0in1i7o.
n2a0anBo H109rico $n2a0anBo' 9 o novo ta0anBo 7o vetor.
Retorno
2i3o 4escri5o
ArraM Retorna 10a re?erncia ao arraM a4estino.
4escri5o
ASEV!#+ 9 10a ?1n5o 7e trata0ento 7e vetor <1e 017a o va&or rea& 7o vetor
$a4estino'. C vetor 9 7i0in1i7o o1 a10enta7o 3ara corres3on7er ao ta0anBo
es3eci?ica7o. 6aso o vetor se=a 7i0in1i7o( os e&e0entos no ?ina& 7o vetor sao 3er7i7os.
Se o vetor ?or a10enta7o( novos e&e0entos sao a7iciona7os ao ?ina& 7o vetor e a e&es
atrib1i7o HE".
ASEV!#+ 9 se0e&Bante a AA44#+( o <1a& a7iciona so0ente 10 novo e&e0ento ao ?ina&
7e 10 vetor e o3ciona&0ente atrib1i 10 novo va&or ao 0es0o te03o. Cbserve <1e
ASEV!#+ 9 7i?erente 7e AEHS#+ e A4!"#+( os <1ais na rea&i7a7e nao 0o7i?ica0 o
ta0anBo 7o vetor.
ASORT
Reviso: 26/07/2002
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
ASCR2 # $ a4estino ' ( ) nEnicio * ( ) n6ont * ( ) bCr7e0 * + ,,' a4estino
.ar/0etros
Arg10ento 2i3o 4escri5o
a4estino ArraM
$a4estino' 9 o vetor c1=os e&e0entos serao co&oca7os e0
or7e0.
nEnicio H109rico
$nEnicio' 9 o 3ri0eiro 7os e&e0entos <1e serao
co&oca7os e0 or7e0. 6aso nao se=a es3eci?ica7a( a
3osi5ao inicia& ass10i7a 9 10.
n6ont H109rico
$n6ont' 9 a <1anti7a7e 7e e&e0entos <1e serao
co&oca7os e0 or7e0. Se nao ?or es3eci?ica7a( to7os os
e&e0entos no vetor <1e co0e5a0 co0 o e&e0ento inicia&
sao or7ena7os.
bCr7e0 6o7e,%&oc8
$bCr7e0' 9 10 b&oco 7e c:7igo o3ciona& 1ti&iFa7o 3ara
7eter0inar <1a& a or7e0 <1e ser@ seg1i7a. 6aso nao se=a
es3eci?ica7a( a or7e0 3a7rao 9 ascen7ente. ggg Aten5o :
6aso 1ti&iFa7a a ?1n5o aSort 3ara 10 arraM aninBa7o
#0i&ti,7i0ensiona&+( o 3ar/0etro bCr7e0 7eve ser
3assa7o Y caso contr@rio o arraM no ser@ or7ena7o.
Retorno
2i3o 4escri5o
ArraM ASCR2#+ retorna 10a re?erncia ao vetor $a4estino'.
4escri5o
ASCR2#+ 9 10a ?1n5ao 7e vetor <1e co&oca e0 or7e0 to7o o1 3arte 7e 10 vetor <1e
cont90 e&e0entos 7e 10 >nico ti3o 7e 7a7os. Cs ti3os 7e 7a7os <1e 3o7e0 ser
or7ena7os inc&1e0 caractere( 7ata( &:gico e n109rico.
Se o arg10ento $bCr7e0' nao ?or es3eci?ica7o( a or7e0 3a7rao 9 ascen7ente.
!&e0entos co0 va&ores baios sao co&oca7os no inAcio 7o vetor #3ri0eiro e&e0ento+(
en<1anto e&e0entos co0 va&ores a&tos sao co&oca7os no ?ina& 7o vetor #>&ti0o
e&e0ento+.
6aso o arg10ento 7e b&oco $bCr7e0' se=a es3eci?ica7o( e&e 9 1ti&iFa7o 3ara 7eter0inar
a or7e0 e0 <1e os e&e0entos serao co&oca7os. 6a7a veF <1e o b&oco 9 ava&ia7o( 7ois
e&e0entos 7o vetor 7estino sao 3assa7os co0o 3ar/0etros 7e b&oco. C b&oco 7eve
retornar ver7a7eiro #.2.+ se os e&e0entos estivere0 or7ena7os. Esto 3o7e ser 1sa7o 3ara
criar 10a or7e0 7escen7ente o1 7e 7icion@rio. Ve=a os ee03&os abaio.
;1an7o or7ena7as( as ca7eias 7e caracteres sao co&oca7as na se<1ncia AS6EEY va&ores
&:gicos sao or7ena7os co0 ?a&so #.D.+ sen7o consi7era7o o va&or 0enorY va&ores 7ata sao
or7ena7os crono&ogica0enteY e n109ricos sao or7ena7os 3or 0agnit17e.
C%S!RVA5jC : Sen7o os vetores 01&ti,7i0ensionais e0 6&i33er i03&e0enta7os
atrav9s 7o aninBa0ento 7e s1b,vetores 7entro 7e o1tros vetores( ASCR2#+ nao or7ena
7ireta0ente vetores 7este ti3o. .ara or7enar 10 vetor aninBa7o( voc 7eve ?ornecer 10
b&oco 7e c:7igo <1e 7ar@ o trata0ento a7e<1a7o aos s1b,vetores.
Funes de !m2ress8o
GET!MPI!#DOIS
Reviso: 05/05/200O
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10
Sintae
J!2EK.REH4CRS # $ &Server ' + ,,' a.rinters
.ar/0etros
Arg10ento 2i3o 4escri5o
&Server ":gico
En?or0ar .2. se a &ista 7e i03ressoras 7eve ser obti7a 7o
.rotBe1s Server o1 .D. 3ara obter &ista 7e i03oressoras 7a
esta5o Re0ota. !ste 3ar/0etro 9 obrigat:rio.
Retorno
2i3o 4escri5o
ArraM
ArraM co0 no0e 7as i03ressoras 7is3onAveis. Va&e &e0brar <1e esta
?1n5o no veri?ica o stat1s at1a& 7a#s+ i03ressora#s+ encontra7a#s+.
4escri5o
J!2EK.REH4CRS# + retorna 10a &ista 7e i03ressoras 7is3onAveis no s3oo& 7o Server
o1 Re0ote. Se o Server est@ e0 a0biente -ni( a J!2EK.REH4CRS#+ retornar@ a
&ista co0 os no0es 7e i03ressoras ca7astra7as na cBave .REH2!RSHAK! 7o ar<1ivo
7e con?ig1ra5o 7o .rotBe1s Server.
6aso no se=a encontra7a nenB10a i03ressora ( 9 retorna7o 10 arraM co0 1 e&e0ento (
conten7o a String XHenB10a E03ressora 4is3onive&X.
O7ser/a8o E %aso a fun8o se:a 2assada com o argumento 0F0 = 7uscar
im2ressoras da esta8o Remote > 4 2orm a fun8o se:a e;ecutada a 2artir de um
<O) = 2rograma sem a interface Remota > 4 o arraH retornado ter1 a2enas A
e5emento 4 contendo a String N#enBuma !m2ressora Dis2oni/e5N0
GETPORTA%T!VE
Reviso: 2O/12/200I
Abrangncia
Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11
Sintae
J!2.CR2A62EV! # $ &Server ' + ,,' a.ortE03
.ar/0etros
Arg10ento 2i3o 4escri5o
&Server ":gico
6Aso es3eci?ica7o .2. ( a &ista 7e i03ressoras ser@ obti7a 7o
Server( caso .D. a &ista ser@ obti7a 7a esta5o #Re0ote+.
Retorno
2i3o 4escri5o
ArraM ArraM co0 as 3ortas 7e i03resso 7is3onAveis.
4escri5o
Retorna &ista 7e 3ortas 7e i03resso 7is3onAveis. A ?1n5o J!2.CR2A62EV!# +
retorna 10a &ista 7e 3ortas 7e i03resso 7is3onAveis 7o .rotBe1s Server o1 Re0ote. Se
o .rotBe1s Server est@ e0 a0biente -ni( a J!2.CR2A62EV!#+ retornar@ 10a &ista
co0 os no0es 7e 7evices 3ossAveis 3ara i03resso.
6aso no se=a0 encontra7as 3ortas 3ara i03resso ( 9 retorna7o 10 arraM co0 a3enas
10 e&e0ento ( conten7o a string XHao eiste0 3ortas 7is3oniveisX.
O7ser/a8o E %aso a fun8o se:a cBamada com o 2arOmetro 0F0 4 2ara o7ter as
2ortas de im2ress8o da esta8o remota 4 2orm a fun8o se:a cBamada atra/s de
um <O) = 2rograma sem a interface Remote > 4 a mesma retornar1 um arraH com
um e5emento 4 contendo a string N#ao e;istem 2ortas dis2oni/eisN0
[RELEASE] Builds superiores a 7.00.041130p
Ao veri?icar os 7evices 7e i03resso 7is3onAveis no S!RV!R( os 7evices es3eci?ica7os
na con?ig1ra5o 7e b&o<1eio 7e 3ortas 7e i03resso # DisableDevicePort + no server
no so &ista7os 3or esta ?1n5o.
;1an7o eec1ta7a e0 a0biente "in1( os 7evices 7e i03resso 7is3onAveis no
S!RV!R( a ?1n5o 7eia 7e retornar os 7evices co0o /7ev/&30 e /7ev/ttMs0 ... e 3assa a
retorn@,&os a no0enc&at1ra ".21:...6CK1:... ( &i0itan7o o retorno e0 no 0@i0o
I 3ortas 3ara&e&as e I 3ortas seriais.
Funes de !nterface +TTP
GETIE)<O)
Reviso: 16/10/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
J!2R!%QC% # + ,,' cQobHa0e
Retorno
2i3o 4escri5o
6aracter
cQobHa0e corres3on7e No no0e 7o =ob <1e con?ig1ra a Sor8ing 2Brea7
at1a& e0 1so. 6aso a cBa0a7a 7a ?1n5o se=a rea&iFa7a a 3artir 7e 10a
tBrea7 <1e no se=a 10a Ror8ing 2Brea7 # co0o 3or ee03&o ( 10a tBrea7
inicia7a a 3artir 7e 10 A3Re0ote + ( a ?1n5o JetRebQob#+ retornar@
10a string vaFia #XX+.
4escri5o
Atrav9s 7esta ?1n5o ( 9 3ossAve& rec13erar o no0e 7a con?ig1ra5o 7e Ror8ing
2Brea7s # Qob + <1e est@ sen7o 1ti&iFa7a 3e&a Ror8ing 2Brea7 at1a&.
O7ser/a8o E Esta fun8o est1 dis2on?/e5 a 2artir dos )ui5dPs A2Q gerados a 2artir
de GRKGSK'GG'0
+TTP%A%+E
Reviso: 16/09/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.6A6[! # $ c6acBe6ontro& ' + ,,' c"ast6acBe
.ar/0etros
Arg10ento 2i3o 4escri5o
c6acBe6ontro& 6aracter
4e?ine o novo conte>7o 7a eti<1eta 7o [ea7er 7e Retorno
[22. 6acBe,6ontro&.
Retorno
2i3o 4escri5o
6aracter
!sta ?1n5o retorna a 7e?ini5o at1a&0ente 1ti&iFa7a 3ara a eti<1eta 6acBe,
6ontro& 7o [ea7er [22..
4escri5o
Atrav9s 7esta ?1n5o ( 3o7e0os re7e?inir a eti<1eta 6A6[!,6CH2RC" 7o [ea7er 7e
Res3osta 7e re<1isi5o [22. ( sobre3on7o N 7e?ini5o 7e?a1t 7e retorno 6A6[!,
6CH2RC" ( o3ciona&0ente 7e?ini7a na con?ig1ra5o 7o [CS2 [22. no Ar<1ivo 7e
con?ig1ra5o 7o .rotBe1s Server.
Tabela A De!i"i#$es CAC%ECO&TROL
6onte>7o A3&ica5o
no,store
HenB10a in?or0a5o 7eve ser g1ar7a7a e0 6acBe 3e&o servi7or e/o1
3roie#s+.
O7ser/a8o E A defini8o de um no/o conteFdo 2ara o %A%+E@%O#TROL do
+eader +TTP a2enas ser1 2oss?/e5 caso esta fun8o Ad/25 se:a e;ecutada antes de
.ua5.uer en/io 2arcia5 de Btm5 ao 7roJser 4 rea5i6ado 2e5a fun8o +tt2Send=>0
+TTP%O"#TSESS!O#
Reviso: 25/08/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.6C-H2S!SSECH # + ,,' n6o1nt
Retorno
2i3o 4escri5o
H109rico
n6o1nt corres3on7e ao n>0ero 7e 1s1@rios <1e 3oss1e0 vari@veis 7e
session e0 1so no Server .RotBe1s.
4escri5o
!sta ?1n5o retorna o n>0ero 7e Sessions 7e 1s1@rios <1e esto at1a&0ente e0 1so na
0e0:ria.
TT ATE#CDO E De/emos atentar ao fato .ue esta fun8o a2enas ter1 o efeito
dese:ado caso o am7iente atua5 em uso 2e5o Pro:eto IE) se:a IE)E$ = Ie7
E;tended > TT
C%S!RVAijC : !sta ?1n5o ?oi i03&e0enta7a na Derra0enta A36 Server ( sen7o
necess@rio a7<1irir 10 %1i&7 7e .rotBe1s Server co0 7ata ig1a& o1 s13erior a
22/0I/2002.
+TTPFREESESS!O#
Reviso: 25/08/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.DR!!S!SSECH # + ,,' HE"
Retorno
2i3o 4escri5o
#H-"C+ !sta ?1n5o se03re retorna HE"
4escri5o
Atrav9s 7a ?1n5o [tt3DreeSession ( e&i0ina0os 7a 0e0:ria 7o Servi7or .rotBe1s
to7as as vari@veis 7e Session 7o 1s1@rio at1a&. Hor0a&0ente 1ti&iFa0os esta ?1n5o e0
o3era5es 7e "CJCDD ( on7e necessita0os &i03ar to7as os conte17os re&aciona7os N
Session 7este 1s1@rio.
TT ATE#CDO E De/emos atentar ao fato .ue esta fun8o a2enas ter1 o efeito
dese:ado caso o am7iente atua5 em uso 2e5o Pro:eto IE) se:a IE)E$ = Ie7
E;tended > TT
C%S!RVAijC : !sta ?1n5o ?oi i03&e0enta7a na Derra0enta A36 Server ( sen7o
necess@rio a7<1irir 10 %1i&7 7o Servi7or .rotBe1s Server co0 7ata ig1a& o1 s13erior a
22/0I/2002.
+TTPGET
Reviso: 16/08/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.J!2 # $ c-r& ' ( ) cJ!2.ar0s * ( ) n2i0eC1t * + ,,' c[tt3
.ar/0etros
Arg10ento 2i3o 4escri5o
c-r& 6aracter
c-r& corres3on7e ao en7ere5o Btt3 ( =1nta0ente co0 a
3asta e o 7oc10ento so&icita7os.
cJ!2.ar0s 6aracter
cJ!2.ar0s corres3on7e N String"ist 7e 3ar/0etros a
sere0 envia7os ao servi7or Btt3 atrav9s 7a -R& . 6aso no
es3eci?ica7o ( este 3ar/0etro 9 consi7era7o vaFio #XX+
n2i0eC1t H109rico
!0 n2i0eC1t es3eci?ica0os o te03o e0 seg1n7os
0@i0o 7e inativi7a7e 3er0iti7o 71rante a rece35o 7o
7oc10ento . 6aso no es3eci?ica7o ( o va&or 7e?a1&t
ass10i7o 9 120 seg1n7os # 2 0in1tos+.
Retorno
2i3o 4escri5o
6aracter String [t0& corres3on7en7o ao 7oc10ento so&icita7o.
4escri5o
A ?1n5o [tt3Jet#+ 3er0ite a e01&a5o 7e 10 6&ient [22. atrav9s 7e 10a ?1n5o
A7v3&( acessan7o 10 7eter0ina7o 7oc10ento Bt0& 31b&ica7o e0 10 servi7or Reb(
1ti&ian7o o 09to7o J!2 ( 3er0itin7o a 3assage0 7e 3ar/0etros via -R"( ag1ar7an7o
3or 10 te03o 7eter0ina7o #ti0e,o1t+ 3e&a res3osta 7o servi7or so&icita7o.
Cbserva5es :
,,, Ha 3assage0 7e 3ar/0tros J!2 ( 7eve0os atentar ao ?or0ato 7a string a ser 3assa7a
co0o 3ar/0etros ( 3ois a 0es0a seg1e o ?or0ato -RE #-ni?or0 Reso1rce E7enti?iers+ :
;1erM 6o03onent.
,,, 6aso nao se=a retorna7o o 7oc10ento antes 7o t9r0ino 7o 2i0e,o1t es3eci?ica7o na
cBa0a7a 7a ?1n5oY o1 caso no se=a 3ossAve& &oca&iFar o servi7or Y se=a 3or ?a&Ba 7e
reso&15o 7e 4HS ( o1 3or erro 7e sintae ao es3eci?icar a -R" ( a ?1n5o retornar@
H1&o #HE"+.
,,, 6aso nao se=a 3ossAve& o acesso ao 7oc10ento ( co0o 3or ee03&o o 7oc10ento no
eista ( ser@ retorna7o 10a string Bt0& co0 a 0ensage0 7e erro Bt0& envia7a 3e&o
servi7or corres3on7ente.
C%S!RVA6AC : !sta ?1nco est@ 7is3onive& a3enas e0 %1i&7s A36 gera7os a 3artir 7e
10/07/2002
+TTPLEAVESESS!O#
Reviso: 25/08/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22."!AV!S!SSECH # + ,,' HE"
Retorno
2i3o 4escri5o
#H-"C+ A ?1n5o [tt3"eaveSession#+ se03re retorna HE"
4escri5o
!sta ?1n5o ( 10a veF eec1ta7a ( &ibera o 3rocessa0ento 7e re<1isi5o 7e at1a&iF5o
7e conte>7os 7e vari@veis ti3o [tt3Session 3ara re<1isi5es 7e cons1&ta e/o1
at1a&iFa5es si01&t/neas 3ara o 1s1@rio at1a&.
TT ATE#CDO E De/emos atentar ao fato .ue esta fun8o a2enas ter1 o efeito
dese:ado caso o am7iente atua5 em uso 2e5o Pro:eto IE) se:a IE)E$ = Ie7
E;tended > TT
C%S!RVAijC : !sta ?1n5o ?oi i03&e0enta7a na Derra0enta A36 Server ( sen7o
necess@rio a7<1irir 10 b1i&7 7e Server .RotBe1s co0 7ata ig1a& o1 s13erior a
22/0I/2002.
+TTPLOGO#"SER
Reviso: 2I/09/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22."CJCH-S!R # + ,,' c"ogon-ser
Retorno
2i3o 4escri5o
6aracter
String conten7o o &ogin 7o 1s1@rio( no ?or0ato 4CKEHEC^&ogin. 6aso a
?1n5o no se=a eec1ta7a e0 10a tBrea7 inicia7a e0 10a inter?ace Btt3 (
o1 o acesso anWni0o No site no EES este=a Babi&ita7o ( a ?1n5o retornar@
10a string e0 branco #XX+.
4escri5o
Atrav9s 7a D1n5o [tt3"ogon-ser#+ ( <1an7o 1ti&iFa0os o A. Server ESA.E
# A7v3&Esa3i.7&&+ ( e0 con=1nto co0 o Kicroso?t EES #Enternet En?or0ation Services + (
obte0os o &ogin 7o 1s1@rio at1a&.
O7ser/a8o E Para .ue o usu1rio se:a o7rigado a informar um 5ogin indi/idua5 4
de/e ser desa7i5itado no !!S a configura8o .ue 2ermite acesso anUnimo ao site0
%aso esta configura8o n8o se:a a5terada 4 todos os usu1rios ser8o identificados
como NanUnimosN 2e5o !!S4 e a fun8o retornar1 uma String em 7ranco0
+TTPOT+ER%O#TE#T
Reviso: 10/09/2002
Abrangncia
Verso 7.10
Sintae
[22.C2[!R6CH2!H2 # + ,,' c6ontent
Retorno
2i3o 4escri5o
6aracter
c6ontent 9 a string corres3on7en7o ao conte>7o 7o cor3o 7o 3acote
[2K" 3osta7o no Server.
4escri5o
A ?1n5o [tt3CtBer6ontent#+ ( <1an7o 1ti&iFa7a e0 10a tBrea7 0onta7a e/o1
inicia&iFa7a 3ara aten7er N 10a re<1isi5o [tt3 # .a3& ( .a3S + ( retorna o conte>7o 7o
3acote Bt0& 3roveniente 7e 10a o3era5o 7e .CS2age0 7e 7a7os( se e so0ente se a
o3eraco 7e .CS2age0 es3eci?ico1 no [!a7er [22. 10 content,7is3osition o1
content,tM3e no trata7os a1to0atica0ente 3e&o Server .RotBe1s.
6aso a re<1isi5o no tenBa si7o rea&iFa7a 3or 10 c&ient [22. atrav9s 7o 09to7o 7e
3ostage0 ( o1 a 3ostage0 =@ 3oss1a trata0ento nativo no Server .rotBe1s ( o1 a ?1n5o
se=a cBa0a7a e0 10 a0biente <1e no este=a aten7en7o N 10a re<1isi5o [tt3 # co0o
10 QC% ( 3or ee03&o+ ( a ?1n5o retornar@ 10a string e0 branco #XX+.
+TTPPOST
Reviso: 07/08/200O
Abrangncia
Verso 6.09 Verso 7.10 Verso 8.11
Sintae
[22..CS2 # $ c-r& ' ( ) cJ!2.ar0s * ( ) c.CS2.ar0s * ( ) n2i0eC1t * (
) a[ea7Str * + ,,' c[t0&
.ar/0etros
Arg10ento 2i3o 4escri5o
c-r& 6aracter
c-r& corres3on7e ao en7ere5o Btt3 ( =1nta0ente co0 a
3asta e o 7oc10ento so&icita7os.
cJ!2.ar0s 6aracter
cJ!2.ar0s corres3on7e N String"ist 7e 3ar/0etros a
sere0 envia7os ao servi7or Btt3 atrav9s 7a -R& . 6aso no
es3eci?ica7o ( este 3ar/0etro 9 consi7era7o vaFio #XX+
c.CS2.ar0s 6aracter
c.ost.ar0s corres3on7e N String"ist 7e 3ar/0etros a
sere0 envia7os ao servi7or Btt3 atrav9s 7o 3acote [22. .
6aso no es3eci?ica7o ( este 3ar/0etro 9 consi7era7o
vaFio #XX+
n2i0eC1t H109rico
!0 n2i0eC1t es3eci?ica0os o te03o e0 seg1n7os
0@i0o 7e inativi7a7e 3er0iti7o 71rante a rece35o 7o
7oc10ento . 6aso no es3eci?ica7o ( o va&or 7e?a1&t
ass10i7o 9 120 seg1n7os # 2 0in1tos+.
a[ea7Str ArraM
Atrav9s 7este 3ara0etro ( 3o7e0os es3eci?icar 10 arraM
co0 strings a sere0 acrescenta7as ao [ea7er 7a re<1isi5o
[22. a ser rea&iFa7a.
Retorno
2i3o 4escri5o
6aracter
Atrav9s 7e c[t0& ser@ retorna7a a String [t0& corres3on7en7o ao
7oc10ento so&icita7o.
4escri5o
A ?1n5o [tt3.ost#+ 3er0ite a e01&a5o 7e 10 6&ient [22. atrav9s 7e 10a ?1n5o
A7v3&( 3ostan7o 10 b&oco 7e in?or0a5es 3ara 10 7eter0ina7o 7oc10ento 31b&ica7o
e0 10 servi7or Reb( 1ti&ian7o o 09to7o .CS2 ( 3er0itin7o a 3assage0 7e 3ar/0etros
a7icionais via -R" e ag1ar7an7o 3or 10 te03o 7eter0ina7o #ti0e,o1t+ 3e&a res3osta
7o servi7or so&icita7o.
Cbserva5es :
Ha 3assage0 7e 3ar/0tros J!2 e .CS2 ( 7eve0os atentar ao ?or0ato 7a string
a ser 3assa7a co0o 3ar/0etros ( 3ois a 0es0a seg1e o ?or0ato -RE #-ni?or0
Reso1rce E7enti?iers+ : ;1erM 6o03onent.
6aso nao se=a retorna7o o 7oc10ento antes 7o t9r0ino 7o 2i0e,o1t es3eci?ica7o
na cBa0a7a 7a ?1n5oY o1 caso no se=a 3ossAve& &oca&iFar o servi7or Y se=a 3or
?a&Ba 7e reso&15o 7e 4HS ( o1 3or erro 7e sintae ao es3eci?icar a -R" ( a
?1n5o retornar@ H1&o #HE"+.
6aso nao se=a 3ossAve& o acesso ao 7oc10ento ( co0o 3or ee03&o o 7oc10ento
no eista (ser@ retorna7o 10a string Bt0& co0 a 0ensage0 7e erro Bt0&
envia7a 3e&o servi7or corres3on7ente.
;1an7o 1ti&iFa0os a ?1n5o [tt3.ost#+ ( 3o7e0os es3eci?icar 10 6ontent,2M3e
7i?erencia7o 3ara o conte>7o 3osta7o. 6aso no se=a es3eci?ica7o 10 6ontent,
2M3e ( a&g1ns servi7ores trata0 a in?or0a5o 3osta7a co0o sen7o 10 7a7o 7o
ti3o \a33&ication/,SSS,?or0,1r&\ ( seria o e<1iva&ente a 10 ?or01&@rio [2K"
3osta7o via %roSser( o1tros servi7ores 3o7ero no reconBecer ta& in?or0a5o
3osta7a 7essa ?or0a. .ara es3eci?icar <1e o conte>7o 3osta7o 7eve ser trata7o
co0o 10 .CS2 7e ?or01&@rio [22. ( 7eve0os 3assar no 3ar/0etro a[ea7Str (
10 e&e0ento conten7o \6ontent,2M3e: a33&ication/,SSS,?or0,1r&\.
ATE#CDO
1. !sta ?1nco est@ 7is3onive& a3enas e0 %1i&7s A36 gera7os a 3artir 7e
10/07/2002 .
2. C 3ara0etro a[ea7Str a3enas est@ 7is3onAve& e0 %1i&7\s A36 e 3osteriores
gera7os a3os 01/10/2002.
+TTPPRAGMA
Reviso: 16/09/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22..RAJKA # $ c.rag0a ' + ,,' cC&7.rag0a
.ar/0etros
Arg10ento 2i3o 4escri5o
c.rag0a 6aracter
c.rag0a corres3on7e ao conte17o 7o .RAJKA a ser
7e?ini7o no [ea7er 7e retorno [22.. Ve=a tabe&a XAX 7e
7e?ini5es .RAJKA.
Retorno
2i3o 4escri5o
6aracter
A ?1n5o [tt3.rag0a retornar@ a 7e?ini5o anterior 7e .RAJKA
1ti&iFa7a.
4escri5o
Atrav9s 7esta ?1n5o ( 3o7e0os re7e?inir a eti<1eta .RAJKA 7o [ea7er 7e Res3osta
7e re<1isi5o [22. ( sobre3on7o N 7e?ini5o 7e?ai1t 7e retorno .RAJKA (
o3ciona&0ente 7e?ini7a na con?ig1ra5o 7o [CS2 [22. no Ar<1ivo 7e con?ig1ra5o
7o .rotBe1s Server.
Tabela A De!i"i#$es 'ra(ma
6onte>7o A3&ica5o
no,cacBe
En?or0a ao 6&ient [22. # %roSser + <1e a 3@gina retorna7a no 7eve ser
co&oca7a e0 6acBe( in7e3en7ente 7a con?ig1ra5o 7e 6acBe 7o %roSser.
O7ser/a8o E A defini8o de um no/o conteFdo 2ara o PRAGMA do +eader
+TTP a2enas ser1 2oss?/e5 caso esta fun8o Ad/25 se:a e;ecutada antes de
.ua.5.uer en/io 2arcia5 de Btm5 ao 7roJser 4 rea5i6ado 2e5a fun8o +tt2Send=>0
+TTPR%TD!SP
Reviso: 10/09/2002
Abrangncia
Verso 7.10
Sintae
[22.R624ES. # + ,,' c6t4is3
Retorno
2i3o 4escri5o
6aracter
c6t4is3 corres3on7e No conte17o 7o i7enti?ica7or 6ontent,7is3osition (
recebi7o <1an7o 10 Reb %roSser rea&iFa 10a re<1isi5o via [22. ao
servi7or.
4escri5o
A ?1n5o [tt3R6t4is3#+ ( <1an7o 1ti&Fa7a e0 10a tBrea7 0onta7a e/o1 inicia&iFa7a
3ara aten7er N 10a re<1isi5o [tt3 # .a3& ( .a3S + ( retorna o conte>7o 7o i7enti?ica7or
6ontent,7is3osition 7o [ea7er [22. .
6aso a re<1isi5o tenBa si7o rea&iFa7a 3or 10 c&ient [22. <1e no envio1 este
i7enti?ica7or no [ea7er [22. ( o1 a ?1n5o se=a cBa0a7a e0 10 a0biente <1e no
este=a aten7en7o N 10a re<1isi5o [tt3 # co0o 10 QC% ( 3or ee03&o+ ( a ?1n5o
retornar@ 10a String e0 branco #XX+.
+TTPR%TLE#
Reviso: 10/09/2002
Abrangncia
Verso 7.10
Sintae
[22.R62"!H # + ,,' n6t"en
Retorno
2i3o 4escri5o
H109rico
n6t"en corres3on7e No conte17o 7o i7enti?ica7or 6ontent,&engtB (
recebi7o <1an7o 10 Reb %roSser rea&iFa 10a re<1isi5o via [22. ao
servi7or.
4escri5o
A ?1n5o [tt3R6t"en#+ ( <1an7o 1ti&iFa7a e0 10a tBrea7 0onta7a e/o1 inicia&iFa7a
3ara aten7er N 10a re<1isi5o [tt3 # .a3& ( .a3S + ( retorna o conte>7o 7o i7enti?ica7or
6ontent,&engtB 7o [ea7er [22. ( co0o 10 7a7o n109rico .
6aso a re<1isi5o tenBa si7o rea&iFa7a 3or 10 c&ient [22. <1e no envio1 este
i7enti?ica7or no [ea7er [22. ( o1 a ?1n5o se=a cBa0a7a e0 10 a0biente <1e no
este=a aten7en7o N 10a re<1isi5o [tt3 # co0o 10 QC% ( 3or ee03&o+ ( a ?1n5o
retornar@ 0 # Vero + .
+TTPR%TTPE
Reviso: 10/09/2002
Abrangncia
Verso 7.10
Sintae
[22.R622L.! # + ,,' c6t2M3e
Retorno
2i3o 4escri5o
6aracter
c6t2M3e corres3on7e No conte17o 7o i7enti?ica7or 6ontent,tM3e ( recebi7o
<1an7o 10 Reb %roSser rea&iFa 10a re<1isi5o via [22. ao servi7or.
4escri5o
A ?1n5o [tt3R6t2M3e#+ ( <1an7o 1ti&Fa7a e0 10a tBrea7 0onta7a e/o1 inicia&iFa7a
3ara aten7er N 10a re<1isi5o [tt3 # .a3& ( .a3S + ( retorna o conte>7o 7o i7enti?ica7or
6ontent,tM3e 7o [ea7er [22. .
6aso a re<1isi5o tenBa si7o rea&iFa7a 3or 10 c&ient [22. <1e no envio1 este
i7enti?ica7or no [ea7er [22. ( o1 a ?1n5o se=a cBa0a7a e0 10 a0biente <1e no
este=a aten7en7o N 10a re<1isi5o [tt3 # co0o 10 QC% ( 3or ee03&o+ ( a ?1n5o
retornar@ 10a String e0 branco #XX+.
+TTPSE#D
Reviso: 10/09/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.S!H4 # $ c[t0&Str ' + ,,' c[t0&HoSen7
.ar/0etros
Arg10ento 2i3o 4escri5o
c[t0&Str 6aracter
c[t0&Str corres3on7e N string a ser envia7a ao %roSser
so&icitante 7e 10 3rocessa0ento .
Retorno
2i3o 4escri5o
6aracter
6aso a ?1n5o obtenBa s1cesso e0 enviar a String c[t0&Str 3ara o %roSse
so&icitante ( o retorno ser@ 10a string vaFia #XX+.
6aso no se=a 3ossAve& o envio 7a string ( 7evi7o No rec1rso 7e envio
si01&t/neo estar 7esabi&ita7o Y o1 ocorra 10a ?a&Ba 7e co01nica5o( o1 a
?1n5o [tt3Sen7#+ se=a eec1ta7a a 3artir 7e 1a0 tBrea7 <1e no 10a
Ror8ing 2Brea7 ( a ?1n5o ir@ retornar a string 3assa7a co0o 3ar/0etro.
4escri5o
Atrav9s 7esta ?1n5o( 9 3ossive& retornar 10a string [t0& N 10 broSser 71rante o
3rocessa0ento 7e 10a re<1isi5o rea&iFa7a atrav9s 7e 10 &in8 .A.R ( 1ti&iFan7o
Ror8ing 2Brea7s ( 71rante o 3rocessa0ento 7a 0es0a.
O7ser/a8o E Este recurso n8o funciona em re.uisies de 2rocesamento
rea5i6adas a 2artir de um 5in9 0a25 0 V necess1rio .ue a re.uisi8o se:a 2ara um
5in9 0a2J 4 atendida 2or uma Ior9ing TBread0
+TTPSETPART
Reviso: 10/09/2002
Abrangncia
Verso 6.09 Verso 7.10
Sintae
[22.S!2.AR2 # $ &[tt3Sen7 ' + ,,' HE"
.ar/0etros
Arg10ento 2i3o 4escri5o
&[tt3Sen7 ":gico
&[tt3Sen7 9 10 va&or boo&eano <1e Babi&ita o envio 3arcia&
# caso .2. + o1 7esabi&ita o envio 3arcia& 7e [2K" # .D. +
Retorno
2i3o 4escri5o
#H-"C+ !sta ?1n5o se03re retorna HE"
4escri5o
Atrav9s 7esta ?1nco ( 3o7e0os Babi&itar o1 7esabi&itar o envio 3arcia& 7e [t0& (
rea&iFa7o 3e&a ?1n5o [tt3Sen7#+ ( 3ara o %roSser so&icitante 7e 10 3rocessa0ento
A7v3& atrav9s 7e 10a Ror8ing 2Brea7.
SOAPRA%T!O#
Reviso: 10/09/2002
Abrangncia
Verso 7.10
Sintae
SCA.RA62ECH # + ,,' cSoa3Action
Retorno
2i3o 4escri5o
6aracter
cSoa3Action corres3on7e No conte17o 7o i7enti?ica7or soa3action (
recebi7o <1an7o 10 Reb %roSser rea&iFa 10a re<1isi5o via [22. ao
servi7or.
4escri5o
A ?1n5o Soa3RAction#+ ( <1an7o 1ti&iFa7a e0 10a tBrea7 0onta7a e/o1 inicia&iFa7a
3ara aten7er N 10a re<1isi5o [tt3 # .a3& ( .a3S + ( retorna o conte>7o string 7o
i7enti?ica7or soa3action 7o [ea7er [22. .
6aso a re<1isi5o tenBa si7o rea&iFa7a 3or 10 c&ient [22. <1e no envio1 este
i7enti?ica7or no [ea7er [22. ( o1 a ?1n5o se=a cBa0a7a e0 10 a0biente <1e no
este=a aten7en7o N 10a re<1isi5o [tt3 # co0o 10 QC% ( 3or ee03&o+ ( a ?1n5o
retornar@ 10a string e0 branco #XX+.