| 롤 토토 : 문서 : 9.5 : 롤 토토 | |||
|---|---|---|---|
| PostgreSQL : 문서 : 9.5 : 비동기 범퍼카 토토 | PostgreSQL : 문서 : 9.5 : LIBPQ -C 토토 | 제 31 장.libpq-C 도서관 | 스포츠 토토 사이트 : 문서 : 9.5 : 제어 기능 |
the메이저 토토 사이트명령postgresqllibpq. 이 섹션에 설명 된 기능은 복사 데이터를 공급하거나 소비하여 응용 프로그램 이이 기능을 활용할 수 있도록합니다.
전체 프로세스는 응용 프로그램이 먼저 SQL을 발행한다는 것입니다.메이저 토토 사이트PQEXEC또는 동등한 함수 중 하나. 이것에 대한 응답 (명령에 오류가없는 경우)은 A입니다.pgresult상태 코드를 가진 객체pgres_메이저 토토 사이트_out또는pgres_메이저 토토 사이트_in(지정된 사본 방향에 따라 다름). 그런 다음 응용 프로그램은이 섹션의 기능을 사용하여 데이터 행을 수신하거나 전송해야합니다.pgresult객체가 반환되어 전송의 성공 또는 실패를 나타냅니다. 그 상태는pgres_command_ok성공 또는pgres_fatal_error문제가 발생한 경우. 이 시점에서 추가 SQL 명령은를 통해 발행 될 수 있습니다.PQEXEC. ( 동안 동일한 연결을 사용하여 다른 SQL 명령을 실행할 수 없습니다메이저 토토 사이트운영 진행 중입니다.)
a메이저 토토 사이트명령은를 통해 발행됩니다.PQEXEC추가 명령을 포함 할 수있는 문자열에서 응용 프로그램은 계속해서 결과를 가져와야합니다pqgetresult완료 후메이저 토토 사이트시퀀스. 만pqgetresult반환null확실합니까PQEXEC명령 문자열이 완료되었으며 더 많은 명령을 발행하는 것이 안전합니다.
이 섹션의 함수는 결과 상태를 얻은 후에 만 실행해야합니다pgres_메이저 토토 사이트_out또는pgres_메이저 토토 사이트_inFromPQEXEC또는pqgetresult.
A pgresult이러한 상태 값 중 하나를 갖는 개체에 대한 추가 데이터가 있습니다메이저 토토 사이트시작중인 작동. 이 추가 데이터는 쿼리 결과와 관련하여 사용되는 기능을 사용하여 사용할 수 있습니다.
pqnfields복사 할 열 (필드) 수를 반환합니다.
pqbinaryTuples0은 전체 사본 형식이 텍스트임을 나타냅니다 (줄로 분리 된 행, 분리기 문자로 분리 된 열). 도 1은 전체 사본 형식이 바이너리임을 나타냅니다.메이저 토토 사이트자세한 내용은
pqfformat사본 조작의 각 열과 관련된 형식 코드 (텍스트의 경우 0, 이진의 경우 1)를 반환합니다. 전체 사본 형식이 텍스트 인 경우 콜럼 당 형식 코드는 항상 0이되지만 이진 형식은 텍스트와 이진 열 모두를 지원할 수 있습니다.메이저 토토 사이트, 이진 기둥만이 이진 사본에 나타납니다. 따라서 컬럼 당 형식은 항상 전체 형식과 일치합니다.)
참고 :이 추가 데이터 값은 프로토콜 3.0을 사용할 때만 사용할 수 있습니다. 프로토콜 2.0을 사용하면이 모든 기능이 0을 반환합니다.
이 기능은 동안 데이터를 보내는 데 사용됩니다.stdin에서 복사. 연결이 없을 때 호출하면 실패합니다메이저 토토 사이트_inState.
pqput메이저 토토 사이트data기간 동안 서버로 데이터를 보냅니다메이저 토토 사이트_inState.
int pqput메이저 토토 사이트data (pgconn *conn,
전송메이저 토토 사이트지정된 데이터버퍼, 길이nbytes, 서버. 결과는 데이터를 대기하는 경우 1, 전체 버퍼로 인해 대기열이없는 경우 0 (비 블로킹 모드에서만 발생) 또는 오류가 발생한 경우 -1입니다.PQERRORMESSAGE반환 값이 -1 인 경우 세부 사항을 검색합니다. 값이 0 인 경우 쓰기 준비를 기다리고 다시 시도하십시오.)
응용 프로그램은를 나눌 수 있습니다.메이저 토토 사이트편리한 크기의 버퍼로드로의 데이터 스트림. 버퍼-로드 경계는 보낼 때 의미 론적 의미가 없습니다.메이저 토토 사이트명령; 보다메이저 토토 사이트자세한 내용.
PQPUT메이저 토토 사이트END기간 동안 서버에 데이터 종료 표시를 보냅니다메이저 토토 사이트_inState.
int pqput메이저 토토 사이트end (pgconn *conn,
종료메이저 토토 사이트_in성공적으로 작동하는 경우errormsgisnull. 만약에errormsgnull그런 다음메이저 토토 사이트|errormsg오류 메시지로 사용됩니다. (서버가 이미 실패했을 수 있으므로이 정확한 오류 메시지가 서버에서 돌아올 것이라고 가정해서는 안됩니다메이저 토토 사이트자체 이유로. 또한 Pre-3.0 protocol 연결을 사용할 때 강제 고장 옵션이 작동하지 않습니다.)
종료 메시지가 전송 된 경우 결과는 1입니다. 또는 비 차단 모드에서는 종료 메시지가 성공적으로 대기되었음을 나타낼 수 있습니다.pqflush, 0을 반환 할 때까지 반복합니다.) Zero는 전체 버퍼로 인해 함수가 종료 메시지를 대기열 할 수 없음을 나타냅니다. 이것은 비 차단 모드에서만 발생합니다.PQPUT메이저 토토 사이트END다시 호출하십시오.) 하드 오류가 발생하면 -1이 반환됩니다. 사용할 수 있습니다PQERRORMESSAGE세부 사항을 검색하려면
성공적으로 전화 한 후PQPUT메이저 토토 사이트END, Callpqgetresult의 최종 결과 상태를 얻으려면메이저 토토 사이트명령. 이 결과가 일반적인 방식으로 사용할 수 있기를 기다릴 수 있습니다.
이 함수는 동안 데이터를 수신하는 데 사용됩니다.stdout에 복사. 연결이 없을 때 호출하면 실패합니다메이저 토토 사이트_outState.
pqget메이저 토토 사이트Data기간 동안 서버로부터 데이터 수신메이저 토토 사이트_outState.
int pqget메이저 토토 사이트data (pgconn *conn,
a 서버에서 다른 행의 데이터 행을 얻으려고 시도합니다메이저 토토 사이트. 데이터는 항상 한 번에 하나의 데이터 행으로 반환됩니다.버퍼매개 변수는 비 여야합니다null. *버퍼할당 된 메모리를 가리 키거나null버퍼가 반환되지 않은 경우. 비null결과 버퍼를 사용하여 해제해야합니다PQFREEMEM더 이상 필요하지 않은 경우
행이 성공적으로 반환되면 반환 값은 행의 데이터 바이트 수입니다 (이것은 항상 0보다 큽니다). 반환 된 문자열은 항상 무효화되지만 텍스트에만 유용 할 것입니다메이저 토토 사이트. 0의 결과는임을 나타냅니다.메이저 토토 사이트아직 진행 중이지만 아직 사용 가능한 행이 없습니다 (이것은 가능합니다.async참). -1의 결과는임을 나타냅니다.메이저 토토 사이트완료되었습니다. -2의 결과는 오류가 발생했음을 나타냅니다 (ConsultPQERRORMESSAGE이유가 있습니다).
언제asynctrue (제로가 아님),pqget메이저 토토 사이트Data입력 대기를 차단하지 않습니다. 이면 0을 반환합니다.메이저 토토 사이트아직 진행 중이지만 완전한 행을 사용할 수 없습니다. (이 경우 읽기 준비를 기다린 다음 전화pqconsumeInput호출 전pqget메이저 토토 사이트Data다시.) 언제async거짓 (0),pqget메이저 토토 사이트Data데이터를 사용할 수 있거나 작업이 완료 될 때까지 차단됩니다.
이후pqget메이저 토토 사이트Datareturns -1, callpqgetresult의 최종 결과 상태를 얻으려면메이저 토토 사이트명령. 이 결과가 일반적인 방식으로 사용할 수 있기를 기다릴 수 있습니다.
이러한 기능은 오래된 취급 방법을 나타냅니다메이저 토토 사이트. 그들은 여전히 작동하지만 오류 처리가 열악하고, 데이터 종료를 감지하는 불편한 방법, 이진 또는 비 차단 전송에 대한 지원 부족으로 인해 더 이상 사용되지 않습니다.
pqgetlineNewline-Terminated 문자 라인 (서버에서 전송)을 버퍼 크기로 읽습니다길이.
int pqgetline (pgconn *conn,
이 함수는까지 복사합니다.길이-1 문자 버퍼로 문자를 사용하고 종단 신축을 제로 바이트로 변환합니다.pqgetline반환eof입력 끝에서 전체 라인을 읽은 경우 0, 버퍼가 가득 찼지만 종료 Newline이 아직 읽지 않은 경우 1..
신청서는 새 라인이 두 문자로 구성되어 있는지 확인해야합니다.\., 이는 서버가의 결과를 송신했음을 나타냅니다메이저 토토 사이트명령. 응용 프로그램이 이상의 줄을받을 수있는 경우길이-1 문자 길이는\.라인을 올바르게 (예를 들어, 터미네이터 라인의 긴 데이터 라인의 끝을 오해하지 마십시오)..
pqgetLineAnsync행을 읽는다메이저 토토 사이트데이터 (서버에서 전송) 차단없이 버퍼로 전송합니다.
int pqgetLineAneCync (pgconn *conn,
이 기능은와 유사합니다.pqgetline이지만 읽어야하는 응용 프로그램에서 사용할 수 있습니다메이저 토토 사이트데이터 비동기 적으로, 즉 차단하지 않고. 발행메이저 토토 사이트명령 및 apgres_메이저 토토 사이트_out응답, 신청서가 호출해야합니다pqconsumeInputandpqgetLineAnsync데이터 종료 신호가 감지 될 때까지.
와 달리pqgetline18567_18630
각 호출에서pqgetLineAnsync전체 데이터 행을 사용할 수 있으면 데이터를 반환합니다libpq의 입력 버퍼. 그렇지 않으면 나머지 행이 도착할 때까지 데이터가 반환되지 않습니다.PQEND메이저 토토 사이트, 그리고 정상 처리로 돌아갑니다.
반환 된 데이터는 데이터 열 경계를 넘어 확장되지 않습니다. 가능하면 전체 행이 한 번에 반환됩니다.\ n(이진에서메이저 토토 사이트, 실제 구문 분석메이저 토토 사이트동등한 결정을하기 위해서는 데이터 형식이 필요합니다.) 반환 된 문자열은 무효가 종결되지 않습니다. (종료 Null을 추가하려면 A를 통과하십시오.bufsize실제로 사용 가능한 방보다 작은 하나입니다.)
pqputline서버에 null 종결 문자열을 보냅니다. OK이고 0을 반환합니다.eof문자열을 보낼 수없는 경우.
int pqputline (pgconn *conn,
the메이저 토토 사이트일련의 통화로 전송 된 데이터 스트림pqputline|pqgetLineAnsync- 응용 프로그램이 정확히 하나의 데이터 행을 보낼 의무가 없다는 점을 제외하고pqputline전화; 통화 당 부분 줄 또는 여러 줄을 보내는 것은 괜찮습니다.
참고 :전postgresql프로토콜 3.0, 응용 프로그램이 두 문자를 명시 적으로 보내야 할 필요가있었습니다\.서버가 보내는 것을 나타내는 최종 라인으로메이저 토토 사이트데이터. 이것은 여전히 작동하지만 감가 상각되며의 특별한 의미는\.향후 릴리스에서 제거 될 수 있습니다. 전화하기에 충분합니다
PQEND메이저 토토 사이트실제 데이터를 보낸 후.
pqputnbytes널리 터진 문자열을 서버로 보냅니다. OK이고 0을 반환합니다.eof문자열을 보낼 수없는 경우.
int pqputnbytes (pgconn *conn,
이것은 똑같습니다pqputline-보내는 바이트 수가 직접 지정되기 때문에 데이터 버퍼를 무효화 할 필요가 없다는 점을 제외하고. 이진 데이터를 보낼 때이 절차를 사용하십시오.
PQEND메이저 토토 사이트서버와 동기화됩니다.
int pqend메이저 토토 사이트 (pgconn *conn);
이 기능은 서버가 복사를 마칠 때까지 기다립니다. 마지막 문자열이를 사용하여 서버로 전송 될 때 발행해야합니다.pqputline또는 마지막 문자열이 서버에서 사용하여 수신 된 경우pqgetline. 발행해야합니다. 그렇지 않으면 서버가 얻을 것입니다"동기화"클라이언트와. 이 기능에서 돌아 오면 서버는 다음 SQL 명령을 수신 할 준비가되었습니다.PQERRORMESSAGE반환 값이 0이 아닌 경우 세부 정보를 검색하려면.)
사용시pqgetresult, 응용 프로그램은 a에 응답해야합니다.pgres_메이저 토토 사이트_out실행하여 결과pqgetline반복적으로PQEND메이저 토토 사이트터미네이터 라인이 보입니다. 그런 다음로 돌아 가야합니다.pqgetresult루프까지pqgetresult널 포인터를 반환합니다. 마찬가지로 Apgres_메이저 토토 사이트_in결과는 일련의 일련의 처리입니다.pqputline통화 후PQEND메이저 토토 사이트, 그런 다음로 돌아갑니다.pqgetresult루프. 이 계약은 A를 보장합니다.메이저 토토 사이트일련의 명령SQL명령이 올바르게 실행됩니다.
이전 응용 프로그램이 a를 제출할 가능성이 높습니다.메이저 토토 사이트viaPQEXEC그리고 거래가 이후에 이루어 졌다고 가정합니다PQEND메이저 토토 사이트. 이것은 만 올바르게 작동합니다.메이저 토토 사이트유일한SQL명령 문자열의 명령.