Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 9738

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>sqlite_query</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="SQLite"
HREF="ref.sqlite.html"><LINK
REL="PREVIOUS"
TITLE="sqlite_prev"
HREF="function.sqlite-prev.html"><LINK
REL="NEXT"
TITLE="sqlite_rewind"
HREF="function.sqlite-rewind.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.sqlite-prev.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.sqlite-rewind.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.sqlite-query"
></A
>sqlite_query</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN211884"
></A
><P
>    (PHP 5)</P
>sqlite_query&nbsp;--&nbsp;
   Executa uma query em um banco de dados e retorna um conjunto de resultados.
  </DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN211887"
></A
><H2
>Descrição</H2
>resource <B
CLASS="methodname"
>sqlite_query</B
> ( resource dbhandle, string query )<BR
></BR
>resource <B
CLASS="methodname"
>sqlite_query</B
> ( string query, resource dbhandle )<BR
></BR
><P
>&#13;   Executa uma SQL indicada pelo parâmetro <CODE
CLASS="parameter"
>query</CODE
> com
   um banco de dados (especificado pelo parâmetro <CODE
CLASS="parameter"
>dbhandle</CODE
>).
  </P
><P
>&#13;   Para query que retornam linhas, esta função irá retornar um result handle
   que pode ser usado em funções como
   <A
HREF="function.sqlite-fetch-array.html"
><B
CLASS="function"
>sqlite_fetch_array()</B
></A
> e
   <A
HREF="function.sqlite-seek.html"
><B
CLASS="function"
>sqlite_seek()</B
></A
>.
  </P
><P
>&#13;   Para outros tipos de query, esta função irá retornar um resultado booleano;
   <TT
CLASS="constant"
><B
>TRUE</B
></TT
> para sucesso ou <TT
CLASS="constant"
><B
>FALSE</B
></TT
> para falha.
  </P
><P
>&#13;   Qualquer que seja o tipo da query, esta função irá retornar <TT
CLASS="constant"
><B
>FALSE</B
></TT
> se
   houver uma falha.
  </P
><P
>&#13;   <B
CLASS="function"
>sqlite_query()</B
> retorna um resultado guardado em buffer e navegavel. 
   Isto é util para query pequenas aonde você necessita acessar de forma aleatória as linhas.
   Resultados guardados em buffer irão alocar memoria para guardar todo o resultado e não irão
   retornar até que todo o resultado tenha sido retornado. Se você necessita apenas acesso
   sequencial aos dados, é recomendado que você use ao invés a função
   <A
HREF="function.sqlite-unbuffered-query.html"
><B
CLASS="function"
>sqlite_unbuffered_query()</B
></A
> que é muito mais rapida.
  </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
    Duas maneiras alternativas são suportadas para compatibilidade com outros bancos de 
    dados(como o MySQL). A forma preferida é a primeira, aonde o parâmetro
    <CODE
CLASS="parameter"
>db</CODE
> é o primeiro na função.
   </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>Atenção</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>&#13;    SQLite <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>irá</I
></SPAN
> executar multiplas query separadas por
    ponto e virgula, assimvocê pode executar um lote de SQL que você tenha
    carregado de um arquivo ou colocado em um script. Entretando, isto funciona apenas
    quando o resultado de uma função não é usado - se for usado,
    apenas o primeiro comando SQL será executado. A função 
    <A
HREF="function.sqlite-exec.html"
><B
CLASS="function"
>sqlite_exec()</B
></A
> irá sempre executar multiplos
    comandos SQL. 
   </P
><P
>&#13;    Quando executar multiplas query o valor de retorno desta função será
    <TT
CLASS="constant"
><B
>FALSE</B
></TT
> se houver um erro, mas indefinido em outro caso (pode ser
    <TT
CLASS="constant"
><B
>TRUE</B
></TT
> para sucesso ou retornar um conjunto de resultados).
   </P
></TD
></TR
></TABLE
></DIV
><P
>&#13;   Veja também <A
HREF="function.sqlite-unbuffered-query.html"
><B
CLASS="function"
>sqlite_unbuffered_query()</B
></A
> e
   <A
HREF="function.sqlite-array-query.html"
><B
CLASS="function"
>sqlite_array_query()</B
></A
>.
  </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.sqlite-prev.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.sqlite-rewind.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>sqlite_prev</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.sqlite.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>sqlite_rewind</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>