Funciones de Ejecución de las Consultas

• Exec Envia una consulta al servidor. Probáblemente sea más deseable utilizar una de las dos siguientes funciones.

  ExecStatusType PgConnection::Exec(const char* query)

  Devuelve el resultado de la consulta. Se pueden esperar los siguientes resultados.

  PGRES_EMPTY_QUERY

  PGRES_COMMAND_OK, si la consulta era un comando

  PGRES_TUPLES_OK, si la consulta ha devuelto tuplas

  PGRES_COPY_OUT

  PGRES_COPY_IN

  PGRES_BAD_RESPONSE, si se ha recibido una respuesta inesperada

  PGRES_NONFATAL_ERROR

  PGRES_FATAL_ERROR

• ExecCommandOk Envía una consulta de comando sobre el servidor.

  int PgConnection::ExecCommandOk(const char *query)

  Devuelve VERDADERO si la consulta de comando se realizó con exito.

• ExecTuplesOk Envía una consulta de tuplas al servidor.

  int PgConnection::ExecTuplesOk(const char *query)

  Devuelve VERDADERO si la consulta se realizó con exito.

• ErrorMessage Devuelve el texto del último mensaje de error.

  const char *PgConnection::ErrorMessage()

• Tuples Devuelve el número de tuplas (instancias) presentes en el resultado de la consulta.

  int PgDatabase::Tuples()

• Fields Devuelve el número de campos (atributos) de cada tupla de las que componen el resultado de la consulta.

  int PgDatabase::Fields()

• FieldName Devuelve el nombre del campo (atributo) asociado al índice de campo dado. Los índices de campo empiezan en 0.

  const char *PgDatabase::FieldName(int field_num)

• FieldNum PQfnumber Devuelve el índice del campo (atributo) asociado con el nombre del campo dado.

  int PgDatabase::FieldNum(const char* field_name)

  Si el nombre de campo no se corresponde con ninguno de los de la consulta se devuelve un valor de -1.

• FieldType Devuelve el tipo de campo asociado con el índice de campo dado. El entero devuelto es una codificación interna del tipo. Los índices de campo empiezan en 0.

  Oid PgDatabase::FieldType(int field_num)

• FieldType Devuelve el tipo de campo asociado con el nombre de campo dado. El entero devuelto es una codificación interna del tipo. Los índices de campo empiezan en 0.

  Oid PgDatabase::FieldType(const char* field_name)

• FieldSize Devuelve el tamaño en bytes del campo asociado con el índice de campo dado. Los índices de campo empiezan en 0.

  short PgDatabase::FieldSize(int field_num)

  Devuelve el lugar ocupado por este campo en la tupla de base de datos, dando el número de campo. En otras palabras, el tamaño de la representación binaria en el servidor del tipo de datos. Devolverá -1 si se trata de un campo de tamaño variable.

• FieldSize Devuelve el tamaño en bytes del campo asociado con el índice de campo dado. Los índices de campo empiezan en 0.

  short PgDatabase::FieldSize(const char *field_name)

  Devuelve el espacio ocupado por este campo en la tupla de base de datos dando el nombre del campo. En otras palabras, el tamaño de la representación binaria del tipo de datos en el servidor. Se devolverá -1 si el campo es de tamaño variable.

• GetValue Devuelve un valor único de campo (atributo) en una tupla de PGresult. Los índices de tupla y de campo empiezan en 0.

  const char *PgDatabase::GetValue(int tup_num, int field_num)

  Para la mayoría de las consultas, el valor devuelto por GetValue es una representación en ASCII terminada con un null del valor del atributo. Pero si BinaryTuples() es VERDADERO, el valor que devuelve GetValue es la representación binaria del tipo en el formato interno del servidor (pero sin incluir el tamaño, en el caso de campos de longitud variable). Es responsabilidad del programador traducir los datos al tipo C correcto. El puntero de devuelve GetValue apunta al almacenamiento que es parte de la estructura PGresult. No se debería modificar, y se debería copiar explícitamente el valor a otro almacenamiento si se debe utilizar pasado el tiempo de vida de la estructura PGresult misma. BinaryTuples() no se ha implementado aún.

• GetValue Devuelve el valor de un único campo (atributo) en una tupla de PGresult. Los índices de tupla y campo empiezan en 0.

  const char *PgDatabase::GetValue(int tup_num, const char *field_name)

  Para la mayoría de las consultas, el valor devuelto por GetValue es una representación en ASCII terminada con un null del valor del atributo. Pero si BinaryTuples() es VERDADERO, el valor que devuelve GetValue es la representación binaria del tipo en el formato interno del servidor (pero sin incluir el tamaño, en el caso de campos de longitud variable). Es responsabilidad del programador traducir los datos al tipo C correcto. El puntero de devuelve GetValue apunta al almacenamiento que es parte de la estructura PGresult. No se debería modificar, y se debería copiar explícitamente el valor a otro almacenamiento si se debe utilizar pasado el tiempo de vida de la estructura PGresult misma. BinaryTuples() no se ha implementado aún.

• GetLength Devuelve la longitud de un campo (atributo) en bytes. Los índices de tupla y campo empiezan en 0.

  int PgDatabase::GetLength(int tup_num, int field_num)

  Esta es la longitud actual del valor particular del dato, que es el tamaño del objeto apuntado por GetValue. Tenga en cuenta que para valores representados en ASCII, este tamaño tiene poco que ver con el tamaño binario indicado por PQfsize.

• GetLength Devuelve la longitud de un campo (atributo) en bytes. Los índices de tupla y campo empiezan en 0.

  int PgDatabase::GetLength(int tup_num, const char* field_name)

  Esta es la longitud actual del valor particular del dato, que es el tamaño del objeto apuntado por GetValue. Tenga en cuenta que para valores representados en ASCII, este tamaño tiene poco que ver con el tamaño binario indicado por PQfsize.

• DisplayTuples Imprime todas las tuplas y, opcionalmente, los nombres de atributo de la corriente de salida especificada.

  void PgDatabase::DisplayTuples(FILE *out = 0, int fillAlign = 1, const char* fieldSep = "|",int printHeader = 1, int quiet = 0)

• PrintTuples Imprime todas las tuplas y, opcionalmente, los nombres de los atributos en la corriente de salida especificada.

  void PgDatabase::PrintTuples(FILE *out = 0, int printAttName = 1, int terseOutput = 0, int width = 0)

• GetLine

  int PgDatabase::GetLine(char* string, int length)

• PutLine

  void PgDatabase::PutLine(const char* string)

• OidStatus

  const char *PgDatabase::OidStatus()

• EndCopy

  int PgDatabase::EndCopy()