What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

hw_errormsg
Prev	XXVIII. Hyperwave Functions	Next

hw_errormsg

Name

hw_errormsg — Fetches the textual error message from the previously executed command.

Synopsis

string hw_errormsg(hw_link); resource hw_link: Connection ID to Hyperwave server

Returns

Error text from the previous command; FALSE on error

Description

hw_errormsg() fetches the textual error message generated by the most recently executed Hyperwave command. If that command was successful, the string No error is returned. This function doesn't return information about errors that may have occurred separately from the server. Only functions that accept a Hyperwave link identifier as a parameter have error codes that can be reported by hw_error() .

As of PHP 4.0.5, these are the possible values for the returned string:

No error
No access
No documents
No collection name
Object is not a document
No object received
No collections received
Connection to low-level database failed
Object not found
Collection already exists
Parent collection disappeared
Parent collection not a collection
Collection not empty
Destination not a collection
Source equals destination
Request pending
Timeout
Name not unique
Database now read-only; try again later
Object locked; try again later
Attribute not removed
Change of base-attribute
Attribute exists
No or unknown language specified
Unknown error: <error code>

Version

PHP 3 since 3.0.3, PHP 4

Example

Example 478. Explain an error condition

hw_gettext($hw_link, $document_id);
if (hw_error()) {
    echo 'Could not fetch existing document: ' . hw_errormsg($hw_link);
}

Prev	Home	Next
hw_error	Up	hw_free_document

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.