File: h_seq.e
Created: 17th/Dec/2003
Author: Hayden McKay
E-Mail: hmck1@dodo.com.au

---

h_seq.e

---

Function Descriptions:
string:: Check if string is a string and it does not exeede max char.
seq_int: Check if item a sequence and contains integers only.
b_name: Strips off leading drive letter and path from a given filename.
p_string: Pack a string/sequence into a smaller sequence.
u_string: Restore packed sequence to it's origional state.

---

Licence & Disclaimer

---

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to not alter it and redistribute it
freely in any way, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software or remove the original
authors' names.
2. Altered source versions are not permitted as such, and must not
be misrepresented as being the original software.
3. All software distributions, without modifications, must be
distributed under this license. And any later versions, in which case,
you should replace this notice with an appropriate one.
If this software is distributed as part of a larger product,
this item does not apply to the rest of the product.
4. If you use this software in a product, an acknowledgment in the
product documentation is required. If the software for the product
is not freely distributed, you must include information on how to
freely obtain the original software.

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

If you want to distribute this software in a way not allowed by this
license, or distribute the software under different license terms, contact
the authors for permission.

---

Functions

---

integer = string(object string, integer limit)
Check if string is a string and it does not exeede max char.
For example ASCII, UTF-8, UTF-16 etc. Returns 1 true, -1 false

---

integer = seq_int(object item)
Check if item a sequence and contains integers only.
Returns 1 true, -1 false.

---

object = b_name(sequence filename)
Strips off leading drive letter and path from a given filename.
Returns new filename, -1 on fail.

---

object = p_string(sequence string)
Pack a string/sequence into a smaller sequence.
Returns packed sequence, -1 on fail.

---

sequence = u_string(sequence packed sequence)
Restore packed sequence to it's origional state.
Returns origional string/sequence.

---