PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

String manipulation routines like those in the C library


MOVEMENT WITHIN THE PAL CARD CATALOG
Move to top-level taxonomy
Move to keyword list

ASSET PROFILE

UNIT NAME
CSTRINGS
VERSION
1.0
REVIEW CODE
CS(VMS/DEC Ada;Sun/Verdix Ada;MSDOS/Meridian Ada);ES;AR;C1 1.0 A
INET ADDRESS
rconn@wsmr-simtel20.army.mil
AUTHOR
Richard Conn
Management Assistance Corp of America
RIGHTS
Released to Ada Community
COPYRIGHT
(c) Richard Conn 1991
DATE CREATED
2/28/91
DATE RELEASED
2/28/91
DATE LAST UPDATED
2/28/91
LOCATION
ASR
AdaNET
ENVIRONMENT
VAX VMS 5.2/DEC Ada 2.1
SunOS 4.0.3/Verdix Ada 6.0
MSDOS 3.3/Meridian Ada 4.1E
LIMITATIONS
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Wednesday 25 May       1994 11:25:21Am
Overall Assessment of System: OK
Classification of System: A
Basis of Classification --
Syntax Errors                               PASS
Completeness                                PASS
Independence from External Libraries        PASS
Independence from a Specific Ada Compiler   PASS

Number of ...
Files               1
Library Units       2
Lines            1125
Statements        324
Comments          541

FILE LISTING

Directory Display


languages/ada/asr/components/cstrings:
  File Name                 Size
  ---------                 ----
  cstrings.zip            14,517


Totals
  ==============  ==============
    1 Files               14,517

ABSTRACT

 Package CStrings and test programs CSTEST0-CSTEST3
    CStrings provides a number of procedures and functions
which manipulate null-terminated strings (called C Strings)
and Ada Strings (which contain no ending null character).
Type STRING is used to contain C and Ada strings.  A C string
contains a sequence of characters followed by an ASCII.NUL;
more characters may follow the ASCII.NUL in the buffer, but
they are ignored.  An Ada string is a sequence of characters
bound by the dimensions of the buffer; all characters in the
buffer are a part of the string.
    This package contains implementations of all the string-
oriented C library functions described in the Sun Release 4.0
man pages on "strings."  The functionality and arguments of
these routines is almost always identical to the functionality
and arguments of the original C routines.  Most subprograms
will process either C or Ada strings.
    The routines implemented in this package are: Strcat (as
a procedure and a function), Strncat (as a procedure and
a function), Strcmp, Strncmp, Strcasecmp, Strncasecmp, Strcpy,
Strncpy, Strlen, Strchr, Strrchr, Strpbrk, Strspn, Strcspn,
and Strtok.
    MIL-HDBK-1804 PDL is used throughout the CStrings package.
To compile the package CStrings, simply compile CSTRINGS.SRC;
this is a Pager file containing the Spec and Body in compilation
order.
    Four test procedures, named CSTEST0 to CSTEST3, and their
supporting TEST_LOG package are included.  They conduct over
300 tests on the CStrings package.  To compile them, simply
compile the file CSTRINGS.TST; this is a Pager file containing
the components in compilation order.


REVISION HISTORY

DATE         VERSION	AUTHOR                  HISTORY
2/28/91         1.0  Richard Conn            Initial Release


RELEASE NOTICE

This prologue must be included in all copies of this software.
This software is copyright by the author.
This software is released to the Ada community.
Restrictions on use or distribution:  NONE


DISCLAIMER

	This software and its documentation are provided "AS IS" and
without any expressed or implied warranties whatsoever.  No warranties
as to performance, merchantability, or fitness for a particular
purpose exist.
	The user is advised to test the software thoroughly before
relying on it.  The user must assume the entire risk and liability of
using this software.  In no event shall any person or organization of
people be held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.