Contents page

Rules for Tools/stringtotime()

SYNOPSIS
     long stringtotime(struct Clip *clip, struct String *string,
                  long oldtime)

ARGUMENTS
    `struct Clip  *clip'
          Clip for conversion.

    `char *string'
          String to convert.

    `long oldtime'
          Original time.

DESCRIPTION
     Use `stringtotime()' to convert user input in the
     measure.beat.clock format into clock ticks.

     `stringtotime()' converts a string into an absolute time in clocks.
     For example, if the time signature is 4/4, `stringtotime()'
     converts the string, "2.01.05," into a time of 773 clocks.  If the
     user types in an illegal string, `stringtotime()' traps the error
     and returns oldtime instead.

     The clip pointer determines the time signature used for the
     conversion.

     string is a standard C ASCII text string, not a Bars&Pipes dynamic
     string.

SEE
     See stringtolength(), timetostring(), lengthtostring().