* Implemented cucul_getchar(). Useful because you don’t necessarily know

what you are importing.

cucul/canvas.c

@@ -74,6 +74,32 @@ int cucul_putchar(cucul_canvas_t *cv, int x, int y, unsigned long int ch)
     return 0;
 }
 
+/** \brief Get the Unicode character at the given coordinates.
+ *
+ *  This function gets the ASCII or Unicode value of the character at
+ *  the given coordinates. If the value is less or equal to 127 (0x7f),
+ *  the character can be printed as ASCII. Otherise, it must be handled
+ *  as a UTF-32 value.
+ *
+ *  If the coordinates are outside the canvas boundaries, a space (0x20)
+ *  is returned.
+ *
+ *  This function never fails.
+ *
+ *  \param cv A handle to the libcucul canvas.
+ *  \param x X coordinate.
+ *  \param y Y coordinate.
+ *  \param ch The requested character value.
+ *  \return The character always returns 0.
+ */
+unsigned long int cucul_getchar(cucul_canvas_t *cv, int x, int y)
+{
+    if(x < 0 || x >= (int)cv->width || y < 0 || y >= (int)cv->height)
+        return 0;
+
+    return (unsigned long int)cv->chars[x + y * cv->width];
+}
+
 /** \brief Print a string.
  *
  *  This function prints an UTF-8 string at the given coordinates, using the

cucul/cucul.h

@@ -101,6 +101,7 @@ int cucul_set_color(cucul_canvas_t *, unsigned char, unsigned char);
 int cucul_set_truecolor(cucul_canvas_t *, unsigned int, unsigned int);
 char const *cucul_get_color_name(unsigned int);
 int cucul_putchar(cucul_canvas_t *, int, int, unsigned long int);
+unsigned long int cucul_getchar(cucul_canvas_t *, int, int);
 int cucul_putstr(cucul_canvas_t *, int, int, char const *);
 int cucul_printf(cucul_canvas_t *, int, int, char const *, ...);
 int cucul_clear_canvas(cucul_canvas_t *);