Rules for Tools/stringtotime()
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().