You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

33 lines
1.1 KiB
Groff

.TH scan_base64url 3
.SH NAME
scan_base64url \- decode base64url encoded data
.SH SYNTAX
.B #include <libowfat/textcode.h>
size_t \fBscan_base64url\fP(const char *\fIsrc\fR,char *\fIdest\fR,size_t* \fIdestlen\fR);
.SH DESCRIPTION
base64url is a variant of base64 for use in URLs (standard base64 uses /
and +, which can cause problems in URLs, so base64url uses - and _
instead; also base64url does not use = padding at the end).
scan_base64url decodes base64url encoded data from src into dest.
It will stop when it encounters any non-valid input characters.
It will then write the number of decoded bytes in dest into *destlen,
and return the number of bytes decoded from src.
Many base64 variants demand padding in the last block. Some don't. This
implementation will consume padding if it is there, but will not
complain if it is not.
dest can be NULL. destlen can be NULL. dest can be src.
.SH "RETURN VALUE"
scan_base64url returns the number of bytes successfully scanned and
processed from src.
.SH EXAMPLES
scan_base64url("Zm5vcmQ",buf,&i) -> return 7, i=5, buf="fnord"
.SH "SEE ALSO"
scan_base64(3), scan_xlong(3), scan_8long(3), fmt_ulong(3)