speech-dispatcher: Characters and Keys in C

 
 4.1.4 Characters and Keys
 -------------------------
 
  -- C API function: int spd_char(SPDConnection* connection, SPDPriority
           priority, const char* character);
 
      Says a character according to user settings for characters.  For
      example, this can be used for speaking letters under the cursor.
 
      'connection' is the SPDConnection* connection created by
      spd_open().
 
      'priority' is the desired priority for this message.  ⇒Message
      Priority Model (ssip)Top.
 
      'character' is a NULL terminated string of chars containing one
      UTF-8 character.  If it contains more characters, only the first
      one is processed.
 
      It returns 0 on success, -1 otherwise.
 
  -- C API function: int spd_wchar(SPDConnection* connection, SPDPriority
           priority, wchar_t wcharacter);
 
      The same as spd_char(), but it takes a wchar_t variable as its
      argument.
 
      It returns 0 on success, -1 otherwise.
 
  -- C API function: int spd_key(SPDConnection* connection, SPDPriority
           priority, const char* key_name);
 
      Says a key according to user settings for keys.
 
      'connection' is the SPDConnection* connection created by
      spd_open().
 
      'priority' is the desired priority for this message.  ⇒Message
      Priority Model (ssip)Top.
 
      'key_name' is the name of the key in a special format.  ⇒
      Speech Synthesis and Sound Output Commands (ssip)Top, (KEY, the
      corresponding SSIP command) for description of the format of
      'key_name'
 
      It returns 0 on success, -1 otherwise.