PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

convert, change case, classify ASCII


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

ASSET PROFILE

UNIT NAME
Character_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
November 9, 1989
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
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Wednesday 25 May       1994 02:10:49Pm
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             858
Statements        102
Comments          524

FILE LISTING

Directory Display


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


Totals
  ==============  ==============
    1 Files               15,401

ABSTRACT

                              Character_Utilities
                                   01D001O0.1
                               (Old ID: LIA0001A)
PURPOSE/INTENDED USE:
Character_Utilities is an Ada package which provides operations for use
in the manipulation of the ASCII character set. Operations are provided
to convert from upper case characters to lower case characters and vise
versa. Additional functions are provided to determine the class of a
character, i.e., upper case, lower case, alphabetic, graphic, etc. 

EXAMPLE APPLICATIONS:
Character_Utilities is intended for reuse by any application requiring
atomic manipulation of the ASCII character set. Examples of such
applications include parsers, Input/Output utilities, format conversion
utilities, etc. 

CERTIFICATION LEVEL:
Character_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:
Character_Utilities has no dependencies.

Character_Utilities only works with the ASCII character set. 
Modifications would be required if the EBCDIC or any other character set
is desired.

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
Character_Utilities has the following visible subunits, which are
grouped according to their functionality:

 Inquiries:

  Is_Alphabetic        Indicates if character is alphabetic.
  Is_Alphanumeric      Indicates if character is alphanumeric.
  Is_Control           Indicates if character is a control character.
  Is_Digit             Indicates if character is a digit.
  Is_Graphic           Indicates if character is a graphics character.
  Is_Lowercase         Indicates if character is lower case.
  Is_Null              Indicates if character is null or blank.
  Is_Special           Indicates if character is a special character.
  Is_Uppercase         Indicates if character is upper case.

 Conversions:

  Lowercase            Converts character to lower case (nondestructive).
  Lowercase_of         Converts position to lower case char (nondestructive)
  Uppercuts            Converts a character to upper case (nondestructive).
  Uppercase_of         Converts position to upper case char (nondestructive)
  Make_Lowercase       Converts character to lower case (destructive).
  Make_Uppercase       Converts character to upper case (destructive).
  Index_of             Converts character to alphabetic index number.
  Image_of             Converts numeric value to hexadecimal character.
  Value_of             Converts hexadecimal character to numeric value.

 Equalities:

  Is_Greater_Than      For character types.
  Is_Less_Than         For character types.
  Is_Equal             For character types.

DSRS CLASSIFICATION:
availability:  extractable
certification level:  level_4
component type:  implementation
data representation:  alphanumeric
data representation:  character
environment:  mvii/vms/vaxada
function:  assess
function:  compare
function:  convert
function:  exchange
function:  identify
function:  inquire
function:  replace
language:  ada
object:  character
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.