* The {\bf memcmppgm2ram} function performs a {\bf memcmp} where
 * {\bf s1} points to data memory and {\bf s2} points to program
 * memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 * @param n number of characters to compare
 */
signed char memcmppgm2ram (auto void *s1, auto const MEM_MODEL rom void *s2, auto sizeram_t n);

/** @name memcmpram2pgm
 * The {\bf memcmpram2pgm} function performs a {\bf memcmp} where {\bf s1} 
 * points to program memory and {\bf s2} point to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 * @param n number of characters to compare
 */
signed char memcmpram2pgm (auto MEM_MODEL rom void *s1, auto const void *s2, auto sizeram_t n);

/** @name strcmppgm
 * The {\bf strcmppgm} function performs a {\bf strcmp} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in program memory
 */
signed char strcmppgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strcmppgm2ram
 * The {\bf strcmppgm2ram} function performs a {\bf strcmp} where
 * {\bf s1} points to data memory and {\bf s2} points to program
 * memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 */
signed char strcmppgm2ram (auto const char *s1, auto const MEM_MODEL rom char *s2);

/** @name strcmpram2pgm
 * The {\bf strcmpram2pgm} function performs a {\bf strcmp} where {\bf s1} 
 * points to program memory and {\bf s2} point to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 */
signed char strcmpram2pgm (auto const MEM_MODEL rom char *s1, auto const char *s2);

/** @name strncmppgm
 * The {\bf strncmppgm} function performs a {\bf strncmp} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in program memory
 * @param n number of characters to compare
 */
signed char strncmppgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2, auto sizerom_t n);

/** @name strncmppgm2ram
 * The {\bf strncmppgm2ram} function performs a {\bf strncmp} where
 * {\bf s1} points to data memory and {\bf s2} points to program
 * memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 * @param n number of characters to compare
 */
signed char strncmppgm2ram (auto char *s1, auto const MEM_MODEL rom char *s2, auto sizeram_t n);

/** @name strncmpram2pgm
 * The {\bf strncmpram2pgm} function performs a {\bf strncmp} where {\bf s1} 
 * points to program memory and {\bf s2} point to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 * @param n number of characters to compare
 */
signed char strncmpram2pgm (auto MEM_MODEL rom char *s1, auto const char *s2, auto sizeram_t n);

/** @name memchrpgm
 * The {\bf memchrpgm} function performs a {\bf memchr} where {\bf s} 
 * points to program memory.
 * @param s pointer to object to search
 * @param c character to search for
 * @param n maximum number of chararacters to search
 */
MEM_MODEL rom char *memchrpgm (auto const MEM_MODEL rom char *s, auto const unsigned char c, auto sizerom_t n);

/** @name strchrpgm
 * The {\bf strchrpgm} function performs a {\bf strchr} where {\bf s} 
 * points to program memory.
 * @param s pointer to object to search
 * @param c character to search for
 * @param n maximum number of chararacters to search
 */
MEM_MODEL rom char *strchrpgm (auto const MEM_MODEL rom char *s, auto unsigned char c);

/** @name strcspnpgm
 * The {\bf strcspnpgm} function performs a {\bf strcspn} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in program memory
 */
sizerom_t strcspnpgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strcspnpgmram
 * The {\bf strcspnpgmram} function performs a {\bf strcspn} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 */
sizerom_t strcspnpgmram (auto const MEM_MODEL rom char *s1, auto const char *s2);

/** @name strcspnrampgm
 * The {\bf strcspnrampgm} function performs a {\bf strcspn} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 */
sizeram_t strcspnrampgm (auto const char *s1, auto const MEM_MODEL rom char *s2);

/** @name strpbrkpgm
 * The {\bf strpbrkpgm} function performs a {\bf strpbrk} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in program memory
 */
MEM_MODEL rom char *strpbrkpgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strpbrkpgmram
 * The {\bf strpbrkpgmram} function performs a {\bf strpbrk} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 */
MEM_MODEL rom char *strpbrkpgmram (auto const MEM_MODEL rom char *s1, auto const char *s2);

/** @name strpbrkrampgm
 * The {\bf strpbrkrampgm} function performs a {\bf strpbrk} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 */
char *strpbrkrampgm (auto const char *s1, auto const MEM_MODEL rom char *s2);

/** @name strrchrpgm
 * The {\bf strchrpgm} function performs a {\bf strchr} where {\bf s} 
 * points to program memory.
 * @param s pointer to object to search
 * @param c character to search for
 * @param n maximum number of chararacters to search
 */
/* MEM_MODEL rom char *strrchrpgm (auto MEM_MODEL rom char *s, auto unsigned char c); */

/** @name strspnpgm
 * The {\bf strspnpgm} function performs a {\bf strspn} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in program memory
 */
sizerom_t strspnpgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strspnpgmram
 * The {\bf strspnpgmram} function performs a {\bf strspn} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in program memory
 * @param s2 pointer to string in data memory
 */
sizerom_t strspnpgmram (auto const MEM_MODEL rom char *s1, auto const char *s2);

/** @name strspnrampgm
 * The {\bf strspnrampgm} function performs a {\bf strspn} where {\bf s1} 
 * points to program memory and {\bf s2} points to data memory.
 * @param s1 pointer to string in data memory
 * @param s2 pointer to string in program memory
 */
sizeram_t strspnrampgm (auto const char *s1, auto const MEM_MODEL rom char *s2);

/** @name strstrpgm
 * The {\bf strstrpgm} function performs a {\bf strstr} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to destination in program memory
 * @param s2 pointer to source in program memory
 */
MEM_MODEL rom char *strstrpgm (auto const MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strstrpgmram
 * The {\bf strstrpgmram} function performs a {\bf strstr} where
 * {\bf s1} points to program memory and {\bf s2} points to data
 * memory.
 * @param s1 pointer to destination in program memory
 * @param s2 pointer to source in data memory
 */
MEM_MODEL rom char *strstrpgmram (auto const MEM_MODEL rom char *s1, auto const char *s2);

/** @name strstrrampgm
 * The {\bf strstrrampgm} function performs a {\bf strstr} where {\bf s1} 
 * points to data memory and {\bf s2} points to program memory.
 * @param s1 pointer to destination in data memory
 * @param s2 pointer to source in program memory
 */
char *strstrrampgm (auto const char *s1, auto const MEM_MODEL rom char *s2);

/** @name strtokpgm
 * The {\bf strtokpgm} function performs a {\bf strtok} where both
 * {\bf s1} and {\bf s2} point to program memory.
 * @param s1 pointer to destination in program memory
 * @param s2 pointer to source in program memory
 */
MEM_MODEL rom char *strtokpgm (auto MEM_MODEL rom char *s1, auto const MEM_MODEL rom char *s2);

/** @name strtokpgmram
 * The {\bf strtokpgmram} function performs a {\bf strtok} where
 * {\bf s1} points to data memory and {\bf s2} points to program
 * memory.
 * @param s1 pointer to destination in data memory
 * @param s2 pointer to source in program memory
 */
char *strtokpgmram (auto char *s1, auto const MEM_MODEL rom char *s2);

/** @name strtokrampgm
 * The {\bf strtokrampgm} function performs a {\bf strtok} where {\bf s1} 
 * points to program memory and {\bf s2} point to data memory.
 * @param s1 pointer to destination in program memory
 * @param s2 pointer to source in data memory
 */
MEM_MODEL rom char *strtokrampgm (auto MEM_MODEL rom char *s1, auto const char *s2);

/** @name memsetpgm
 * The {\bf memsetpgm} function performs a {\bf memset} where {\bf s} 
 * points to program memory.
 * @param s pointer to object in program memory
 * @param c character to copy into object
 * @param n number of characters of object to copy {\bf c} into
 */
MEM_MODEL rom void *memsetpgm (auto MEM_MODEL rom void *s, auto unsigned char c, auto sizerom_t n);

/** @name struprpgm
 * The {\bf struprpgm} function performs a {\bf strupr} where {\bf s} 
 * points to program memory.
 * @param s pointer to object in program memory
 */
MEM_MODEL rom char *struprpgm (auto MEM_MODEL rom char *s);

/** @name strlwrpgm
 * The {\bf strlwrpgm} function performs a {\bf strlwr} where {\bf s} 
 * points to program memory.
 * @param s pointer to object in program memory
 */
MEM_MODEL rom char *strlwrpgm (auto MEM_MODEL rom char *s);

/** @name strlenpgm
 * The {\bf strlenpgm} function performs a {\bf strlen} where {\bf s} 
 * points to program memory.
 * @param s pointer to object in program memory
 */
sizerom_t strlenpgm (auto const MEM_MODEL rom char *s);

#undef MEM_MODEL

#else
/* The versions of the libraries shipped with MPLAB-C17 are currently
 * not completely correct. Specifically, the functions should return
 * a pointer to the destination buffer as the MPLAB-C18 versions do.
 * This will be corrected in a future version of MPLAB-C17.
 *
 * There are also a number of functions missing from the MPLAB-C17
 * implementation.
 */
void strcat (static char *, static char *);
signed char strcmp (static char *, static char *);
void strcpy (static char *, static char *);
unsigned char strlen (static char *);
void strlwr (static char *);
void strupr (static char *);
void strset (static char *, static char);
#endif

#endif