@DATABASE String
$VER: String V1.50 (05.01.1999) by Laboureur -> AlphaSOUND <- Frédéric
@NODE MAIN "String V1.50"

    @{b}String V1.50 General Information:@{ub}

  * Blitz Basic II library number         : #166
  * Library size when linked to executable: 150 bytes
  * Number of commands                    : 11
  * Ressources automatically freed at end : Yes


    @{b}Commands summary:@{ub}

  @{" NAsc     " LINK NAsc} Function (Word)
  @{" NChr$    " LINK NChr$} Function (String)
  @{" NCvi     " LINK NCvi} Function (String)
  @{" NCvl     " LINK NCvl} Function (String)
  @{" NLCase$  " LINK NLCase$} Function (String)
  @{" NLeft$   " LINK NLeft$} Function (String)
  @{" NLen     " LINK NLen} Function (Long)
  @{" NMki$    " LINK NMki$} Function (Word)
  @{" NMkl$    " LINK NMkl$} Function (Long)
  @{" NRight$  " LINK NRight$} Function (String)
  @{" NUCase$  " LINK NUCase$} Function (String)

@ENDNODE


@NODE NAsc

    @{b}SYNTAX@{ub}
  Asc.w = NAsc(String$)

    @{b}FUNCTION@{ub}
  Return the ascii value of the first string letter.

@ENDNODE


@NODE NLen

    @{b}SYNTAX@{ub}
  length.w = NLen(String$)

    @{b}FUNCTION@{ub}
  Return the caracter length of the string.

@ENDNODE


@NODE NChr$

    @{b}SYNTAX@{ub}
  Text$ = NChr$(ASCII Value)

    @{b}FUNCTION@{ub}
  Return the letter associated to the given ASCII value.

@ENDNODE


@NODE NRight$

    @{b}SYNTAX@{ub}
  Result$ = NRigth$(String$, Length)

    @{b}FUNCTION@{ub}
  Return the caracters from right of the string with the
  given length. This function can't crash if you give incorrect
  value for the length parameter, it will return the best
  matching result.

@ENDNODE


@NODE NLeft$

    @{b}SYNTAX@{ub}
  Result$ = NLeft$(String$, Length)

    @{b}FUNCTION@{ub}
  Return the caracters from left of the string with the
  given length. This function can't crash if you give incorrect
  value for the length parameter, it will return the best
  matching result.

@ENDNODE


@NODE NUCase$

    @{b}SYNTAX@{ub}
  Result$ = NUCase$(String$)

    @{b}FUNCTION@{ub}
  Return the original string converted in Upper Case caracters
  (if possible). This command also support accent letter, so
  if an 'é' is found, it will be tranformed into Upper 'é'.
  Passing a null string cause the function return a null string.

@ENDNODE


@NODE NLCase$

    @{b}SYNTAX@{ub}
  Result$ = NLCase$(String$)

    @{b}FUNCTION@{ub}
  Return the original string converted in Lower Case caracters
  (if possible). This command also support accent letter, so
  if an Upper 'é' is found, it will be tranformed into 'é'.
  Passing a null string cause the function return a null string.

@ENDNODE


@NODE NMki$

    @{b}SYNTAX@{ub}
  Result$ = NMki$(Word number)

    @{b}FUNCTION@{ub}
  Convert a gived word number into 2 caracters equivalent.  It's
  often used to save disk space when saving numbers to disk.
  To reconvert the String into real number, you can use the
  NCvi() function.

@ENDNODE


@NODE NMkl$

    @{b}SYNTAX@{ub}
  Result$ = NMkl$(Long number)

    @{b}FUNCTION@{ub}
  Convert a gived long number into 4 caracters equivalent. It's
  often used to save disk space when saving numbers to disk.
  To reconvert the String into real number, you can use the
  NCvl() function.

@ENDNODE


@NODE NCvl

    @{b}SYNTAX@{ub}
  Result.l = NCvl(String$)

    @{b}FUNCTION@{ub}
  Convert a gived 4 caracters string into number equivalent.
  It's the complementary function of NMkl$().

@ENDNODE


@NODE NCvi

    @{b}SYNTAX@{ub}
  Result.w = NCvi(String$)

    @{b}FUNCTION@{ub}
  Convert a gived 2 caracters string into number equivalent.
  It's the complementary function of NMki$().

@ENDNODE