1 /* Public Domain Curses */
5 RCSID("$Id: pdcclip.c,v 1.6 2008/07/14 04:24:52 wmcbrine Exp $")
9 /*man-start**************************************************************
14 int PDC_getclipboard(char **contents, long *length);
15 int PDC_setclipboard(const char *contents, long length);
16 int PDC_freeclipboard(char *contents);
17 int PDC_clearclipboard(void);
20 PDC_getclipboard() gets the textual contents of the system's
21 clipboard. This function returns the contents of the clipboard
22 in the contents argument. It is the responsibilitiy of the
23 caller to free the memory returned, via PDC_freeclipboard().
24 The length of the clipboard contents is returned in the length
27 PDC_setclipboard copies the supplied text into the system's
28 clipboard, emptying the clipboard prior to the copy.
30 PDC_clearclipboard() clears the internal clipboard.
33 indicator of success/failure of call.
34 PDC_CLIP_SUCCESS the call was successful
35 PDC_CLIP_MEMORY_ERROR unable to allocate sufficient memory for
36 the clipboard contents
37 PDC_CLIP_EMPTY the clipboard contains no text
38 PDC_CLIP_ACCESS_ERROR no clipboard support
40 Portability X/Open BSD SYS V
41 PDC_getclipboard - - -
42 PDC_setclipboard - - -
43 PDC_freeclipboard - - -
44 PDC_clearclipboard - - -
46 **man-end****************************************************************/
48 /* global clipboard contents, should be NULL if none set */
50 static char *pdc_SDL_clipboard
= NULL
;
52 int PDC_getclipboard(char **contents
, long *length
)
56 PDC_LOG(("PDC_getclipboard() - called\n"));
58 if (!pdc_SDL_clipboard
)
59 return PDC_CLIP_EMPTY
;
61 len
= strlen(pdc_SDL_clipboard
);
62 if ((*contents
= malloc(len
+ 1)) == NULL
)
63 return PDC_CLIP_MEMORY_ERROR
;
65 strcpy(*contents
, pdc_SDL_clipboard
);
68 return PDC_CLIP_SUCCESS
;
71 int PDC_setclipboard(const char *contents
, long length
)
73 PDC_LOG(("PDC_setclipboard() - called\n"));
75 if (pdc_SDL_clipboard
)
77 free(pdc_SDL_clipboard
);
78 pdc_SDL_clipboard
= NULL
;
83 if ((pdc_SDL_clipboard
= malloc(length
+ 1)) == NULL
)
84 return PDC_CLIP_MEMORY_ERROR
;
86 strcpy(pdc_SDL_clipboard
, contents
);
89 return PDC_CLIP_SUCCESS
;
92 int PDC_freeclipboard(char *contents
)
94 PDC_LOG(("PDC_freeclipboard() - called\n"));
96 /* should we also free empty the system clipboard? probably not */
100 /* NOTE: We free the memory, but we can not set caller's pointer
101 to NULL, so if caller calls again then will try to access
102 free'd memory. We 1st overwrite memory with a string so if
103 caller tries to use free memory they won't get what they
104 expect & hopefully notice. */
106 /* memset(contents, 0xFD, strlen(contents)); */
108 if (strlen(contents
) >= strlen("PDCURSES"))
109 strcpy(contents
, "PDCURSES");
114 return PDC_CLIP_SUCCESS
;
117 int PDC_clearclipboard(void)
119 PDC_LOG(("PDC_clearclipboard() - called\n"));
121 if (pdc_SDL_clipboard
)
123 free(pdc_SDL_clipboard
);
124 pdc_SDL_clipboard
= NULL
;
127 return PDC_CLIP_SUCCESS
;