PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

equality, case, justify, substitute strings


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

ASSET PROFILE

UNIT NAME
String_Utilities
VERSION
1
REVIEW CODE
C1 1.0 A
INET ADDRESS
sun1.disacim.osd.mil (134.152.9.140)
AUTHOR
Software Development Center
Fort Lee, Virginia
RIGHTS
Approved for Public Release; Distribution Unlimited
COPYRIGHT
None -- Public Domain.
DATE CREATED
February 5, 1988
DATE RELEASED
January 17, 1994
DATE LAST UPDATED
January 17, 1994
LOCATION
DSRS Library
PAL
ENVIRONMENT
DEC VAX/VMS with DEC Ada Compilation System (ACS)
LIMITATIONS
None.
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Wednesday 25 May       1994 02:31:40Pm
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               2
Library Units       4
Lines            2610
Statements        408
Comments         1362

FILE LISTING

Directory Display


languages/ada/swcomps/dsrs/strutil:
  File Name                 Size
  ---------                 ----
  strutil.zip             23,876

languages/ada/swcomps/dsrs/charutil:
  File Name                 Size
  ---------                 ----
  charutil.zip            15,401


Totals
  ==============  ==============
    2 Files               39,277

ABSTRACT

                                String_Utilities
                                   01D001O3.1
                               (Old ID: LIB0002A)
PURPOSE/INTENDED USE:
String_Utilities is an Ada package which provides operations for
manipulating strings and text. The largest string length this package
will support is system dependent, i.e., the largest positive integer
supported by the system. 

EXAMPLE APPLICATIONS:
String_Utilities is valuable in a system required to perform string
manipulation functions. 

CERTIFICATION LEVEL:
String_Utilities is certified at Level 4.  This means that the Defense 
Information Systems Agency/Center for Information Management Software
Reuse  Program (SRP) management office has successfully compiled the
code of this  Reusable Software Asset (RSA) and measured
maintainability, portability,  reliability and reusability.  In
addition, this RSA includes a test suite and a  Reuser's Manual, which
will be provided when the asset is extracted. 
 
IMPLEMENTATION ISSUES:
The String_Utilities package depends on (withs) Character_Utilities
(01D001O0).

String_Utilities is a candidate for reuse by any program requiring
string manipulation. Examples would include input processors, report
generators, parsers, etc. 

String_Utilities raises the exception Lexical_Error.

HARDWARE/ENVIRONMENT CONSTRAINTS AND LIMITATIONS:
This package was compiled, linked, and tested on a DEC VAX/VMS machine
using the Ada Compilation System (ACS). 

SUBUNITS:
String_Utilities has the following visible subunits, which are grouped
according to their functionality:

 Inquiries: 

    Is_Null		 Checks for null or blank string.
    Is_Empty		 Checks for null or blank string.
    Location_Of		 Gives position of character in string.
    Number_Of            Gives quantity of character is string.
    Is_Uppercase	 Indicates if string is all upper case.
    Is_Lowercase         Indicates if string is all lower case.
    Is_Digit		 Indicates if string contains all digits.
    Is_Alphabetic        Indicates if string contains all alphabetics.
    Is_Alphanumeric	 Indicates if string contains all alphanumerics.
    Is_Control		 Indicates if string contains all control characters.
    Is_Graphic		 Indicates if string contains all graphics characters.
    Is_Special		 Indicates if string contains all special characters.
    String_Contains      Indicates if string contains requested character.
    String_End_Position  Gives position of end of first word.
    String_Leading_Non_Blank_Position  Gives position of first non-blank.
					
 Equalities:

    Is_Equal             For string variables.
    Is_Less_Than         For string variables.
    Is_Greater_Than      For string variables.

 Case conversions:
    
    Capitalized          Makes first character upper case (non-destructive).
    Uncapitalized        Makes first character lower case (non-destructive).
    Upper-case           Makes all characters upper case (non-destructive).
    Lowercase            Makes all characters lower case (non-destructive).
    Capitalize           Makes first character upper case (destructive).
    Uncapitalize         Makes first character lower case (destructive).
    Make_Uppercase       Makes all characters upper case (destructive).
    Make_Lowercase       Makes all characters lower case (destructive).

 Formatting:
			           
    Centered             Centers text (non-destructive).
    Left_Justified	 Left justifies (non-destructive).
    Right_Justified	 Right justifies (non-destructive).
					
 Substitutions:

    Substituted          Character substitution (non-destructive).
    Substitute           Character substitution (destructive).
    Padded               Pads string (non-destructive).
    Stripped             Strips all occurrences (non-destructive).
    Stripped_Leading 	 Strips all leading occurrences (non-destructive).

DSRS CLASSIFICATION:
availability:  extractable
certification level:  level_4
component type:  implementation
data representation:  string
environment:  mvii/vms/vaxada
function:  assess
function:  compare
function:  convert
function:  exchange
function:  fill_in
function:  identify
function:  inquire
function:  query
function:  replace
language:  ada
object:  field
object:  string
originator:  sdc-l
unit type:  package

LEGAL RESTRICTIONS:
This RSA contains public domain data with unlimited rights for all
users.   Extraction is permitted to all authorized library users. 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. 

MISCELLANEOUS:
The standard for Level 4 certification has recently been upgraded. This
asset is currently undergoing modification to meet the new Level 4
requirements. 


REVISION HISTORY

January 17, 1994 Version 1 Original submission to PAL


RELEASE NOTICE

This prologue must be included in all copies of this software.
Restrictions on use or distribution:  NONE

LEGAL RESTRICTIONS:
This RSA contains public domain data with unlimited rights for all
users.   Extraction is permitted to all authorized library users. 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.


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 particularpurpose 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.