Delta Chat Core C Interface
Macros
DC_STR

These constants are used to define strings using dc_set_stock_translation(). This allows localisation of the texts used by the core, you have to call dc_set_stock_translation() for every DC_STR string you want to translate. More...

Macros

#define DC_STR_AC_SETUP_MSG_BODY   43
 "This is the Autocrypt Setup Message, open it in a compatible client to use your setup" More...
 
#define DC_STR_AC_SETUP_MSG_SUBJECT   42
 "Autocrypt Setup Message" More...
 
#define DC_STR_ARCHIVEDCHATS   40
 "Archived chats" More...
 
#define DC_STR_AUDIO   11
 "Audio" More...
 
#define DC_STR_BAD_TIME_MSG_BODY   85
 "Date or time of your device seem to be inaccurate (%1$s). Adjust your clock to ensure your messages are received correctly" More...
 
#define DC_STR_CANNOT_LOGIN   60
 "Cannot login as %1$s." More...
 
#define DC_STR_CANTDECRYPT_MSG_BODY   29
 "This message was encrypted for another setup." More...
 
#define DC_STR_CONFIGURATION_FAILED   84
 "Error: %1$s" More...
 
#define DC_STR_CONTACT_NOT_VERIFIED   36
 "Cannot verify %1$s." More...
 
#define DC_STR_CONTACT_SETUP_CHANGED   37
 "Changed setup for %1$s." More...
 
#define DC_STR_CONTACT_VERIFIED   35
 "%1$s verified" More...
 
#define DC_STR_DEADDROP   8
 "Contact requests" More...
 
#define DC_STR_DEVICE_MESSAGES   68
 "Device messages" More...
 
#define DC_STR_DEVICE_MESSAGES_HINT   70
 "Messages in this chat are generated locally by your Delta Chat app." More...
 
#define DC_STR_DRAFT   3
 "Draft" More...
 
#define DC_STR_E2E_AVAILABLE   25
 "End-to-end encryption available." More...
 
#define DC_STR_E2E_PREFERRED   34
 "End-to-end encryption preferred." More...
 
#define DC_STR_ENCR_NONE   28
 "No encryption." More...
 
#define DC_STR_ENCR_TRANSP   27
 
#define DC_STR_ENCRYPTEDMSG   24
 "Encrypted message" More...
 
#define DC_STR_EPHEMERAL_DAY   79
 "Message deletion timer is set to 1 day." More...
 
#define DC_STR_EPHEMERAL_DAYS   95
 "Message deletion timer is set to %1$s days." More...
 
#define DC_STR_EPHEMERAL_DISABLED   75
 "Message deletion timer is disabled." More...
 
#define DC_STR_EPHEMERAL_FOUR_WEEKS   81
 
#define DC_STR_EPHEMERAL_HOUR   78
 "Message deletion timer is set to 1 hour." More...
 
#define DC_STR_EPHEMERAL_HOURS   94
 "Message deletion timer is set to %1$s hours." More...
 
#define DC_STR_EPHEMERAL_MINUTE   77
 "Message deletion timer is set to 1 minute." More...
 
#define DC_STR_EPHEMERAL_MINUTES   93
 "Message deletion timer is set to %1$s minutes." More...
 
#define DC_STR_EPHEMERAL_SECONDS   76
 "Message deletion timer is set to %1$s s." More...
 
#define DC_STR_EPHEMERAL_WEEK   80
 "Message deletion timer is set to 1 week." More...
 
#define DC_STR_EPHEMERAL_WEEKS   96
 "Message deletion timer is set to %1$s weeks." More...
 
#define DC_STR_ERROR_NO_NETWORK   87
 "No network." More...
 
#define DC_STR_FAILED_SENDING_TO   74
 "Failed to send message to %1$s." More...
 
#define DC_STR_FILE   12
 "File" More...
 
#define DC_STR_FINGERPRINTS   30
 "Fingerprints" More...
 
#define DC_STR_FORWARDED   97
 "Forwarded" More...
 
#define DC_STR_GIF   23
 "GIF" More...
 
#define DC_STR_IMAGE   9
 "Image" More...
 
#define DC_STR_LOCATION   66
 "Location" More...
 
#define DC_STR_MSGACTIONBYME   63
 "%1$s by me" More...
 
#define DC_STR_MSGACTIONBYUSER   62
 "%1$s by %2$s" More...
 
#define DC_STR_MSGADDMEMBER   17
 "Member %1$s added." More...
 
#define DC_STR_MSGDELMEMBER   18
 "Member %1$s removed." More...
 
#define DC_STR_MSGGROUPLEFT   19
 "Group left." More...
 
#define DC_STR_MSGGRPIMGCHANGED   16
 "Group image changed." More...
 
#define DC_STR_MSGGRPIMGDELETED   33
 "Group image deleted." More...
 
#define DC_STR_MSGGRPNAME   15
 "Group name changed from %1$s to %2$s." More...
 
#define DC_STR_MSGLOCATIONDISABLED   65
 "Location streaming disabled." More...
 
#define DC_STR_MSGLOCATIONENABLED   64
 "Location streaming enabled." More...
 
#define DC_STR_NEWGROUPDRAFT   14
 "Hi, i've created the group %1$s for us." More...
 
#define DC_STR_NOMESSAGES   1
 "No messages." More...
 
#define DC_STR_PROTECTION_DISABLED   89
 "Chat protection disabled." More...
 
#define DC_STR_PROTECTION_ENABLED   88
 "Chat protection enabled." More...
 
#define DC_STR_READRCPT   31
 "Message opened" More...
 
#define DC_STR_READRCPT_MAILBODY   32
 "The message '%1$s' you sent was displayed on the screen of the recipient." More...
 
#define DC_STR_REPLY_NOUN   90
 "Reply" More...
 
#define DC_STR_SAVED_MESSAGES   69
 "Saved messages" More...
 
#define DC_STR_SELF   2
 "Me" More...
 
#define DC_STR_SELF_DELETED_MSG_BODY   91
 "You deleted the 'Saved messages' chat..." More...
 
#define DC_STR_SERVER_RESPONSE   61
 "Could not connect to %1$s: %2$s" More...
 
#define DC_STR_SERVER_TURNED_OFF   92
 "'Delete messages from server' turned off as now all folders are affected." More...
 
#define DC_STR_STATUSLINE   13
 "Sent with my Delta Chat Messenger: https://delta.chat" More...
 
#define DC_STR_STICKER   67
 "Sticker" More...
 
#define DC_STR_SUBJECT_FOR_NEW_CONTACT   73
 "Message from %1$s" More...
 
#define DC_STR_UNKNOWN_SENDER_FOR_CHAT   72
 "Unknown sender for this chat. See 'info' for more details." More...
 
#define DC_STR_UPDATE_REMINDER_MSG_BODY   86
 "Your Delta Chat version might be outdated, check https://get.delta.chat for updates." More...
 
#define DC_STR_VIDEO   10
 "Video" More...
 
#define DC_STR_VIDEOCHAT_INVITATION   82
 "Video chat invitation" More...
 
#define DC_STR_VIDEOCHAT_INVITE_MSG_BODY   83
 "You are invited to a video chat, click %1$s to join." More...
 
#define DC_STR_VOICEMESSAGE   7
 "Voice message" More...
 
#define DC_STR_WELCOME_MESSAGE   71
 "Welcome to Delta Chat! Delta Chat looks and feels like other popular messenger apps ..." More...
 

Detailed Description

These constants are used to define strings using dc_set_stock_translation(). This allows localisation of the texts used by the core, you have to call dc_set_stock_translation() for every DC_STR string you want to translate.

Some strings contain some placeholders as %1$s or %2$s - these will be replaced by some content defined in the DC_STR description below. As a synonym for %1$s you can also use %1$d or %1$@; same for %2$s.

If you do not call dc_set_stock_translation() for a concrete DC_STR constant, a default string will be used.

Macro Definition Documentation

◆ DC_STR_AC_SETUP_MSG_BODY

#define DC_STR_AC_SETUP_MSG_BODY   43

"This is the Autocrypt Setup Message, open it in a compatible client to use your setup"

Used as message text of outgoing Autocrypt Setup Messages.

◆ DC_STR_AC_SETUP_MSG_SUBJECT

#define DC_STR_AC_SETUP_MSG_SUBJECT   42

"Autocrypt Setup Message"

Used in subjects of outgoing Autocrypt Setup Messages.

◆ DC_STR_ARCHIVEDCHATS

#define DC_STR_ARCHIVEDCHATS   40

"Archived chats"

Used as the name for the corresponding chatlist entry.

◆ DC_STR_AUDIO

#define DC_STR_AUDIO   11

"Audio"

Used in summaries.

◆ DC_STR_BAD_TIME_MSG_BODY

#define DC_STR_BAD_TIME_MSG_BODY   85

"Date or time of your device seem to be inaccurate (%1$s). Adjust your clock to ensure your messages are received correctly"

Used as device message if a wrong date or time was detected.

  • %1$s will be replaced by a date/time string as YY-mm-dd HH:MM:SS

◆ DC_STR_CANNOT_LOGIN

#define DC_STR_CANNOT_LOGIN   60

"Cannot login as %1$s."

Used in error strings.

  • %1$s will be replaced by the failing login name

◆ DC_STR_CANTDECRYPT_MSG_BODY

#define DC_STR_CANTDECRYPT_MSG_BODY   29

"This message was encrypted for another setup."

Used as message text if decryption fails.

◆ DC_STR_CONFIGURATION_FAILED

#define DC_STR_CONFIGURATION_FAILED   84

"Error: %1$s"

Used in error strings.

  • %1$s will be replaced by the concrete error

◆ DC_STR_CONTACT_NOT_VERIFIED

#define DC_STR_CONTACT_NOT_VERIFIED   36

"Cannot verify %1$s."

Used in status messages.

  • %1$s will be replaced by the name of the contact that cannot be verified

◆ DC_STR_CONTACT_SETUP_CHANGED

#define DC_STR_CONTACT_SETUP_CHANGED   37

"Changed setup for %1$s."

Used in status messages.

  • %1$s will be replaced by the name of the contact with the changed setup

◆ DC_STR_CONTACT_VERIFIED

#define DC_STR_CONTACT_VERIFIED   35

"%1$s verified"

Used in status messages.

  • %1$s will be replaced by the name of the verified contact

◆ DC_STR_DEADDROP

#define DC_STR_DEADDROP   8

"Contact requests"

Used as the name for the corresponding chat.

◆ DC_STR_DEVICE_MESSAGES

#define DC_STR_DEVICE_MESSAGES   68

"Device messages"

Used as the name for the corresponding chat.

◆ DC_STR_DEVICE_MESSAGES_HINT

#define DC_STR_DEVICE_MESSAGES_HINT   70

"Messages in this chat are generated locally by your Delta Chat app."

Used as message text for the message added to a newly created device chat.

◆ DC_STR_DRAFT

#define DC_STR_DRAFT   3

"Draft"

Used in summaries.

◆ DC_STR_E2E_AVAILABLE

#define DC_STR_E2E_AVAILABLE   25

"End-to-end encryption available."

Used to build the string returned by dc_get_contact_encrinfo().

◆ DC_STR_E2E_PREFERRED

#define DC_STR_E2E_PREFERRED   34

"End-to-end encryption preferred."

Used to build the string returned by dc_get_contact_encrinfo().

◆ DC_STR_ENCR_NONE

#define DC_STR_ENCR_NONE   28

"No encryption."

Used to build the string returned by dc_get_contact_encrinfo().

◆ DC_STR_ENCR_TRANSP

#define DC_STR_ENCR_TRANSP   27
Deprecated:
Deprecated 2021-02-07, this string is no longer needed.

◆ DC_STR_ENCRYPTEDMSG

#define DC_STR_ENCRYPTEDMSG   24

"Encrypted message"

Used in subjects of outgoing messages.

◆ DC_STR_EPHEMERAL_DAY

#define DC_STR_EPHEMERAL_DAY   79

"Message deletion timer is set to 1 day."

Used in status messages.

◆ DC_STR_EPHEMERAL_DAYS

#define DC_STR_EPHEMERAL_DAYS   95

"Message deletion timer is set to %1$s days."

Used in status messages. %1$s will be replaced by the number of days (always >1) the timer is set to.

◆ DC_STR_EPHEMERAL_DISABLED

#define DC_STR_EPHEMERAL_DISABLED   75

"Message deletion timer is disabled."

Used in status messages.

◆ DC_STR_EPHEMERAL_FOUR_WEEKS

#define DC_STR_EPHEMERAL_FOUR_WEEKS   81
Deprecated:
Deprecated 2021-01-30, DC_STR_EPHEMERAL_WEEKS is used instead.

◆ DC_STR_EPHEMERAL_HOUR

#define DC_STR_EPHEMERAL_HOUR   78

"Message deletion timer is set to 1 hour."

Used in status messages.

◆ DC_STR_EPHEMERAL_HOURS

#define DC_STR_EPHEMERAL_HOURS   94

"Message deletion timer is set to %1$s hours."

Used in status messages. %1$s will be replaced by the number of hours (always >1) the timer is set to.

◆ DC_STR_EPHEMERAL_MINUTE

#define DC_STR_EPHEMERAL_MINUTE   77

"Message deletion timer is set to 1 minute."

Used in status messages.

◆ DC_STR_EPHEMERAL_MINUTES

#define DC_STR_EPHEMERAL_MINUTES   93

"Message deletion timer is set to %1$s minutes."

Used in status messages. %1$s will be replaced by the number of minutes (alwasy >1) the timer is set to.

◆ DC_STR_EPHEMERAL_SECONDS

#define DC_STR_EPHEMERAL_SECONDS   76

"Message deletion timer is set to %1$s s."

Used in status messages when the other constants (DC_STR_EPHEMERAL_MINUTE, DC_STR_EPHEMERAL_HOUR and so on) do not match the timer.

  • %1$s will be replaced by the number of seconds the timer is set to

◆ DC_STR_EPHEMERAL_WEEK

#define DC_STR_EPHEMERAL_WEEK   80

"Message deletion timer is set to 1 week."

Used in status messages.

◆ DC_STR_EPHEMERAL_WEEKS

#define DC_STR_EPHEMERAL_WEEKS   96

"Message deletion timer is set to %1$s weeks."

Used in status messages. %1$s will be replaced by the number of weeks (always >1) the timer is set to.

◆ DC_STR_ERROR_NO_NETWORK

#define DC_STR_ERROR_NO_NETWORK   87

"No network."

Used in error strings.

◆ DC_STR_FAILED_SENDING_TO

#define DC_STR_FAILED_SENDING_TO   74

"Failed to send message to %1$s."

Used in status messages.

  • %1$s will be replaced by the name of the contact the message cannot be sent to

◆ DC_STR_FILE

#define DC_STR_FILE   12

"File"

Used in summaries.

◆ DC_STR_FINGERPRINTS

#define DC_STR_FINGERPRINTS   30

"Fingerprints"

Used to build the string returned by dc_get_contact_encrinfo().

◆ DC_STR_FORWARDED

#define DC_STR_FORWARDED   97

"Forwarded"

Used in message summary text for notifications and chatlist.

◆ DC_STR_GIF

#define DC_STR_GIF   23

"GIF"

Used in summaries.

◆ DC_STR_IMAGE

#define DC_STR_IMAGE   9

"Image"

Used in summaries.

◆ DC_STR_LOCATION

#define DC_STR_LOCATION   66

"Location"

Used in summaries.

◆ DC_STR_MSGACTIONBYME

#define DC_STR_MSGACTIONBYME   63

"%1$s by me"

Used to concretize actions.

◆ DC_STR_MSGACTIONBYUSER

#define DC_STR_MSGACTIONBYUSER   62

"%1$s by %2$s"

Used to concretize actions,

◆ DC_STR_MSGADDMEMBER

#define DC_STR_MSGADDMEMBER   17

"Member %1$s added."

Used in status messages for added members.

  • %1$s will be replaced by the name of the added member

◆ DC_STR_MSGDELMEMBER

#define DC_STR_MSGDELMEMBER   18

"Member %1$s removed."

Used in status messages for removed members.

  • %1$s will be replaced by the name of the removed member

◆ DC_STR_MSGGROUPLEFT

#define DC_STR_MSGGROUPLEFT   19

"Group left."

Used in status messages.

◆ DC_STR_MSGGRPIMGCHANGED

#define DC_STR_MSGGRPIMGCHANGED   16

"Group image changed."

Used in status messages for group images changes.

◆ DC_STR_MSGGRPIMGDELETED

#define DC_STR_MSGGRPIMGDELETED   33

"Group image deleted."

Used in status messages for deleted group images.

◆ DC_STR_MSGGRPNAME

#define DC_STR_MSGGRPNAME   15

"Group name changed from %1$s to %2$s."

Used in status messages for group name changes.

  • %1$s will be replaced by the old group name
  • %2$s will be replaced by the new group name

◆ DC_STR_MSGLOCATIONDISABLED

#define DC_STR_MSGLOCATIONDISABLED   65

"Location streaming disabled."

Used in status messages.

◆ DC_STR_MSGLOCATIONENABLED

#define DC_STR_MSGLOCATIONENABLED   64

"Location streaming enabled."

Used in status messages.

◆ DC_STR_NEWGROUPDRAFT

#define DC_STR_NEWGROUPDRAFT   14

"Hi, i've created the group %1$s for us."

Used as a draft text after group creation.

  • %1$s will be replaced by the group name

◆ DC_STR_NOMESSAGES

#define DC_STR_NOMESSAGES   1

"No messages."

Used in summaries.

◆ DC_STR_PROTECTION_DISABLED

#define DC_STR_PROTECTION_DISABLED   89

"Chat protection disabled."

Used in status messages.

◆ DC_STR_PROTECTION_ENABLED

#define DC_STR_PROTECTION_ENABLED   88

"Chat protection enabled."

Used in status messages.

◆ DC_STR_READRCPT

#define DC_STR_READRCPT   31

"Message opened"

Used in subjects of outgoing read receipts.

◆ DC_STR_READRCPT_MAILBODY

#define DC_STR_READRCPT_MAILBODY   32

"The message '%1$s' you sent was displayed on the screen of the recipient."

Used as message text of outgoing read receipts.

  • %1$s will be replaced by the subject of the displayed message

◆ DC_STR_REPLY_NOUN

#define DC_STR_REPLY_NOUN   90

"Reply"

Used in summaries. Note: the string has to be a noun, not a verb (not: "to reply").

◆ DC_STR_SAVED_MESSAGES

#define DC_STR_SAVED_MESSAGES   69

"Saved messages"

Used as the name for the corresponding chat.

◆ DC_STR_SELF

#define DC_STR_SELF   2

"Me"

Used as the sender name for oneself.

◆ DC_STR_SELF_DELETED_MSG_BODY

#define DC_STR_SELF_DELETED_MSG_BODY   91

"You deleted the 'Saved messages' chat..."

Used as device message text.

◆ DC_STR_SERVER_RESPONSE

#define DC_STR_SERVER_RESPONSE   61

"Could not connect to %1$s: %2$s"

Used in error strings.

  • %1$s will be replaced by the failing server
  • %2$s by a the error message as returned from the server

◆ DC_STR_SERVER_TURNED_OFF

#define DC_STR_SERVER_TURNED_OFF   92

"'Delete messages from server' turned off as now all folders are affected."

Used as device message text.

◆ DC_STR_STATUSLINE

#define DC_STR_STATUSLINE   13

"Sent with my Delta Chat Messenger: https://delta.chat"

Used as the default footer if nothing else is set by the dc_set_config()-option selfstatus.

◆ DC_STR_STICKER

#define DC_STR_STICKER   67

"Sticker"

Used in summaries.

◆ DC_STR_SUBJECT_FOR_NEW_CONTACT

#define DC_STR_SUBJECT_FOR_NEW_CONTACT   73

"Message from %1$s"

Used in subjects of outgoing messages in one-to-one chats.

  • %1$s will be replaced by the name of the sender, this is the dc_set_config()-option displayname or addr

◆ DC_STR_UNKNOWN_SENDER_FOR_CHAT

#define DC_STR_UNKNOWN_SENDER_FOR_CHAT   72

"Unknown sender for this chat. See 'info' for more details."

Use as message text if assigning the message to a chat is not totally correct.

◆ DC_STR_UPDATE_REMINDER_MSG_BODY

#define DC_STR_UPDATE_REMINDER_MSG_BODY   86

"Your Delta Chat version might be outdated, check https://get.delta.chat for updates."

Used as device message if the used version is probably outdated.

◆ DC_STR_VIDEO

#define DC_STR_VIDEO   10

"Video"

Used in summaries.

◆ DC_STR_VIDEOCHAT_INVITATION

#define DC_STR_VIDEOCHAT_INVITATION   82

"Video chat invitation"

Used in summaries.

◆ DC_STR_VIDEOCHAT_INVITE_MSG_BODY

#define DC_STR_VIDEOCHAT_INVITE_MSG_BODY   83

"You are invited to a video chat, click %1$s to join."

Used as message text of outgoing video chat invitations.

  • %1$s will be replaced by the URL of the video chat

◆ DC_STR_VOICEMESSAGE

#define DC_STR_VOICEMESSAGE   7

"Voice message"

Used in summaries.

◆ DC_STR_WELCOME_MESSAGE

#define DC_STR_WELCOME_MESSAGE   71

"Welcome to Delta Chat! Delta Chat looks and feels like other popular messenger apps ..."

Used as message text for the message added to the device chat after successful login.