# strings

Strings Library

Author | Matthew Schinkel - borntechi.com, copyright © 2009, all rights reserved.
Adapted-by | Oliver "Kiste" Seitz
Compiler | >=2.4k

Description

    Library for managing strings.

Dependencies

- characters

## Summary

### Global variables/contants

### Procedures

### Functions

- `string_compare(byte in string1[], byte in string2[]) return bit`
- `string_compare_mid(byte in string1[], byte in start, byte in string2[]) return bit`
- `string_to_dword_old(byte in chars[]) return dword`
- `string_compare_mid_case(byte in string1[], byte in start, byte in string2[]) return bit`
- `string_compare_case(byte in string1[], byte in string2[]) return bit`
- `string_to_dword(byte in chars[]) return dword`
- `string_length(byte in str[]) return byte`
- `string_to_sdword(byte in chars[]) return sdword`

## API details

### Global variables/contants

### Procedures

### Functions

- `string_compare(byte in string1[], byte in string2[]) return bit`

      compare two strings to see if they are the same. not case dependant.
      strings can optionally be terminated with a null character.
      (null character = 0).

- `string_compare_mid(byte in string1[], byte in start, byte in string2[]) return bit`

      compare the middle of string1 with string2
      string1 must be >= length of string2

- `string_to_dword_old(byte in chars[]) return dword`

      Convert a string representing a number into the actual number, as dword.
      String can be NULL terminated, or full contained, that is, filling the
      complete array. Old version of the function.

- `string_compare_mid_case(byte in string1[], byte in start, byte in string2[]) return bit`

      compare the middle of string1 with string2. case sensitive.
      string1 must be >= length of string2

- `string_compare_case(byte in string1[], byte in string2[]) return bit`

      compare two strings to see if they are the same. case dependant.
      strings can optionally be terminated with a null character.
      (null character = 0).

- `string_to_dword(byte in chars[]) return dword`

      Convert a string representing a number into the actual number, as dword.
      The Number may fill the whole array, or can be terminated by any non-number
      character. If the first character is not a number, zero is returned.
      If the number is too large, a wrong value is returned without notice.

- `string_length(byte in str[]) return byte`

      return string length

- `string_to_sdword(byte in chars[]) return sdword`

      Convert a string representing a number into the actual number, as sdword.
      The Number may fill the whole array, or can be terminated by any non-number
      character. Signs ("+" or "-") are allowed as first char only, any subsequent
      sign will terminate the conversion.
      If the number is too large, a wrong value is returned without notice.

## Related samples

Here are the list of samples which use this library:

16f15325 | 16f15325_bluetooth_hc05_master.jal
16f15325 | 16f15325_bluetooth_hc06_slave.jal
16f18857 | 16f18857_si5351a.jal
16f19176 | 16f19176_dfplayer.jal
18f27j53 | 18f27j53_sd_card_minix_demo.jal
18f27j53 | 18f27j53_sd_card_minix_readi.jal
18f27j53 | 18f27j53_sd_card_minix_read.jal
18f4620 | 18f4620_mp3_decoder_vs1053b_pata_hard_disk.jal
18f4620 | 18f4620_mp3_decoder_vs1053b_sd_card.jal
18f67j50 | 18f67j50_mp3_decoder_vs1053b_sd_card.jal
18f67j50 | 18f67j50_mp3_decoder_vs1053b_pata_hard_disk.jal