LocalLexicalValue()

word	LocalLexicalValue(
        word	ch);

This routine returns the passed character's lexical value, useful when trying to sort strings alphabetically.

Include: localize.h

LocalLexicalValueNoCase()

word	LocalLexicalValueNoCase(
        word	ch);

This routine returns the passed character's case-insensitive lexical value, useful when trying to sort strings alphabetically.

Include: localize.h

LocalParseDateTime()

Boolean	LocalParseDateTime( /* Returns FALSE on failure */
        const char *		str,
        DateTimeFormat 		format,
        TimerDateAndTime *		dateTime);

This routine takes a string describing a date or time (e.g. "9:37") and parses it using the passed format.

Include: localize.h

LocalSetCurrencyFormat()

void	LocalSetCurrencyFormat(
        const LocalCurrencyFormat *				buf,
        const char *				symbol);

This routine changes the stored preferred currency format.

Include: localize.h

LocalSetDateTimeFormat()

void	LocalSetDateTimeFormat(
        const char *		str,
        DateTimeFormat 		format);

This routine changes the stored preferred time and date format.

Include: localize.h

LocalSetMeasurementType()

void	LocalSetMeasurementType(
        MeasurementTypes meas);

This routine changes the stored preferred measurement type.

Include: localize.h

LocalSetNumericFormat()

void	LocalSetNumericFormat(
        const LocalNumericFormat *				buf);

This routine changes the stored preferred number format.

Include: localize.h

LocalSetQuotes()

void	LocalSetQuotes(
        const LocalQuotes *		quotes);

This routine changes the stored preferred quote marks.

Include: localize.h

LocalStringLength()

word	LocalStringLength(
        const char *		str);

This routine returns the length (in characters) of a null-terminated string (not counting the null), even for multibyte character sets.

Include: localize.h

LocalStringSize()

word	LocalStringSize(
        const char *		str);

This routine returns the size (in bytes) of a null-terminated string.

Include: localize.h

LocalUpcaseChar()

word	LocalUpcaseChar(
        word	ch);

This routine returns the upper case equivalent, if any, of the passed character.

Include: localize.h

LocalUpcaseString()

void	LocalUpcaseString(
        char *	str,
        word	size);

This routine converts the passed string to its all upper case equivalent.

Include: localize.h

LogAddEntry()

void 	LogAddEntry(
        LogEntry 		*logEntry);

This function adds an entry to the Contact log. (The Contact log keeps track of what calls the user has sent to and received from each of their contacts; this is the function that logs a call.) The function takes on argument, a LogEntry structure.

typedef struct {
  NameOrNumber 			LE_number;
  dword 			LE_contactID;
  LogEntryType 			LE_type;
  LogEntryDirection 			LE_direction;
  dword 			LE_duration;
  DateAndTime 			LE_datetime;
  LogEntryFlags 			LE_flags; 
} LogEntry;

Normally, this function is invoked twice for each call--once at the start of the call, and again when the call is done.

When invlking the function at the start of the call, set up the LogEntry structure. Fill in the LE_number and/or LE_contactID fields if you know the contact's name, number, or RecordID number, Fill in the LE_type field with one of LET_CALL, LET_FAX, LET_SMS, LET_DATA_MAILBOX, LET_DATA_WWW, or LET_DATA_TELNET. Fill in the LE_direction field with one of LED_SENT, LED_RECEIVED, or LED_MISSED. The LE_duration should be zero. Fill in the LE_datetime field with the current date and time. (The TimerGetDateAndTime() function returns this information.) Leave the LE_flags field alone.

Keep the structure around after you call the routine; it will fill in some of the fields. Then when the call is complete, fill in the LE_duration field and invoke the function again. The LE_duration field should contain the call's duration in seconds. One way to compute this time is to call TimerGetCount() twice: once at the start of the call and once at the end. By subtracting the start time from the end time and dividing by 60, one can compute the number of seconds that passed.

Having invoked the function a second time, the program may safely free the LogEntry structure.

Include: contlog.goh

See Also: TimerGetDateAndTime(), TimerGetCount().

LogDeleteAllEntries()

void 	LogDeleteAllEntries();

This function deletes all entries in the contact log.

Include: contlog.goh

LogDestroy()

void 	LogDestroy();

This function deletes the contact log's log file.

Include: contlog.goh