File I/O API - C++ Sample Program

04 Feb 03

Overview
Dictls32.exe is a C++ sample program which utilizes the File I/O API. It is a multiple
document interface (MDI) application which displays the dictionary information from SPSS data
files in one or more child windows. The user simply selects “Open” from the “File” menu to get a
standard Open File dialog. If the selected file is an SPSS data file, its dictionary information is
displayed in an edit control in a child window. The application is terminated by selecting “Exit”
from the “File” menu.

Building
The sample program has been built with version 6.0 of Microsoft Visual C++. Other compilers
may work, but they have not been tested. In order to build the sample program, perform the
following steps:

1. Copy all the files from the SPSS\Developer\io_dll\smpl_cpp directory on the

distribution disk to a directory on your hard disk.

2. Make sure spssdio.h is on the compiler’s search path - either by copying it to the directory
containing the sample program or by modifying the INCLUDE environment variable.

3. Made sure spssio32.lib is on the linker’s search path - either by copying the file to the
directory containing the sample program or by modifying the LIB environment variable.

4. Use the nmake utility to build the application:

nmake -f dictls32.mak DEBUG=1

Each of the makefiles recognizes two options which can either be set as environment variables or
defined on the command line. The first option is “DEBUG”. If this symbol is defined (regardless
of its value), the resulting executable will contain debug symbols. The default is not to include
debug symbols. The second option is “STATICMFC”. If this symbol is defined (regardless of its
value), the resulting executable will contain statically-linked Microsoft Foundation Classes (MFC)
and C Run-Time. The default is to use DLL-resident versions of MFC and the C Run-Time.

The makefile writes its intermediate and target files to a subdirectory named “32”. In order to
execute the resulting application, spssio32.dll must be accessible at execution time.

Integrated Development Environment

Most users will opt to use Microsoft’s Integrated Development Environment (IDE) to build and
debug an application. The sample application is amenable to being built in this fashion. Simply
open dictls32.mak by selecting “Open Workspace” from the “File” menu. You will have to
select “Settings” on the “Build” menu to specify the name of the target file, the name of the
required DLL, and the debug build command line.

Constituent Files
The following files are included as part of the sample program:
File I/O API - C++ Sample Program 04 Feb 03

dictafx.cpp for building precompiled headers

dictafx.h includes the headers to be precompiled
dictdoc.cpp CDocument class CDictListDoc - does all the work
dictdoc.h Interface to class CDictListDoc
dictdoc.ico Icon for class CDictListDoc
dictlist.cpp CEditView class CDictListEditView and a CWinApp class
dictlist.h Interface to classes CDictListEditView and CDictListApp
dictls32.mak External makefile
dictls32.rc Resources
dictmain.ico Icon for the application’s MDI frame window
dict-res.h Interface to the resources

-2-