topic file-write-file / file-read-file size clarifications in Software Development Kit (SDK) and API Discussions

file-write-file / file-read-file size clarifications

kevingraham — Thu, 05 Jun 2025 06:27:50 GMT

Though the documentation for I/O size in file-write-file and file-read-file are technically correct, they could really use some clarification.

Quoting from the 4.1 SDK, file-write-file states that "API will fail if data exceeds 1 MB" and file-read-file says "API will fail if length exceeds 1 MB". Until recognizing the subtle difference between these two (or observing empirically), they appear to each allow 1MB I/O sizes, though due to the double-byte encoding of the data element, the actual sizes are 512kb for writes and 1024kb for reads. It'd be good to make this distinction more apparent in the documentation.

Re: file-write-file / file-read-file size clarifications

christin — Thu, 24 May 2012 01:04:09 GMT

Hi Kevin,

Thanks for the feedback. I have forwarded your comment to the appropriate team and will have give you an update as soon as I hear back.

Regards,

Christine

Re: file-write-file / file-read-file size clarifications

kunalm — Wed, 13 Jun 2012 06:34:52 GMT

Hi Kevin

Hope you are doing well. Thanks for pointing out about the clarification, we will fix this in a future release

-Kunal