Subsections

• SUMMARY
• ATTRIBUTES
• HOW TO USE THE PACKAGE
• SPECIFICATION OF GROWL_GOOGLESEARCH
  • Argument List
  • Data Distribution
  • Control and Information
  • Control Parameters
  • Information returned to the User
  • Errors and Warnings
  • Error Returns
  
  
• GENERAL INFORMATION
• METHOD
• EXAMPLE
  • Example text
  • Example data
  • Example results

GIZMOS

SUMMARY

Interfaces to a variety of public-domain Web services such as those from Google and XMethods.

ATTRIBUTES

Version: 1.0
Public calls: growl_googleSearch
Public modules: libgrowl.a
Other modules required: libbase.a, gSOAP v2.1.4
Date: 2004
Origin: Hand-Knitted Software, R.J. Allan, CCLRC Daresbury Laboratory
Language: C
Conditions on external use: Standard, see separate chapter

HOW TO USE THE PACKAGE

This package provides access to a range of public-domain Web services such as those from Google and XMethods.

SPECIFICATION OF GROWL_GOOGLESEARCH

Argument List

[frame=single]
     int growl_googleSearch(char *key,
                            char *searchString,
			    char **response);

char *key
On entry: your personal key for Google Web service API, obtained by registering with Google via http://api.google.com. Permits up to 100 searches per day.

char *searchString
On entry: text string identical to what would be typed in to Google search form interface.

char **response
On exit: response string (tbd).

Data Distribution

Control and Information

Control Parameters

Information returned to the User

Integer, 0=success, !0=failure.

Errors and Warnings

Error Returns

SOAP error message if there is a problem.

GENERAL INFORMATION

Workspace: internal workspace is allocated in all these routines by the gSOAP system for the long return string. This should be freed by the user when it is no longer required.
Use of globals: none
Other routines called directly: none
Input/ output: none
Restrictions:
Notes:

METHOD

EXAMPLE

Put the example code here. Should also be provided as part of the distribution.

Example text

[frame=single]
Part of code listing

Example data

Input data

Example results

Output data