User Tools

Site Tools


uphp:functions:fread

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

uphp:functions:fread [2017/04/12 12:55]
jeff
uphp:functions:fread [2021/09/13 05:57]
Line 1: Line 1:
-======fread====== 
- 
-<badge>WMPRO, WMMINI FW >= 1.0</badge> <badge>WMMEGA FW >= 2.0</badge> 
- 
-Read bytes from a file, stream or socket 
- 
-====Description==== 
- 
-<well size="sm"> 
-<html> 
-<span style="font-size:125%;color:green">mixed 
-<span style="color:black"> 
-</html> 
-[[fread]] ( 
-<html> 
-<span style="color:green">int 
-<span style="color:blue">$handle<span style="color:black">, 
-<span style="color:green">int 
-<span style="color:blue">$bytes 
-<span style="color:black">) 
-</html> 
-</well> 
- 
-This function attempts to read a specified number of bytes from a file, stream or socket. If less than the number of bytes are available it will return the available data. If no data is available it will return an empty string. 
- 
-====Parameters==== 
- 
-<html><b><span style="color:blue">$handle<span style="color:black"></b></html>:  Valid handle of a previously opened resource 
- 
-<html><b><span style="color:blue">$bytes<span style="color:black"></b></html>:  Limit to the number of bytes returned 
- 
-====Return Values==== 
- 
-  * <html><b><span style="color:green">String<span style="color:black"></b></html> containing the data requested from the resource 
-    * <html>The length of the returned <b><span style="color:green">string<span style="color:black"></b> depends on available data (<b>0 to <span style="color:blue">$bytes<span style="color:black"></b>)</html> 
-  * <html><b><span style="color:green">Integer<span style="color:black"></b></html> 0 for error 
- 
-====Example==== 
- 
-**Read the 32 byte MD5 hash from file /md5.txt:** 
- 
-<code php> 
-<? 
-  $fp=fopen("/md5.txt","r"); 
-  if ($fp) { 
-    $data=fread($fp,32); // read 32 bytes from the file 
-    print($data); 
-    fclose($fp); 
-  } else { 
-    print("File open failed\n"); 
-  } 
-?> 
-</code> 
- 
-====See Also==== 
- 
-[[fopen()]] - Open a file for reading or writing 
- 
-[[fseropen()]] - Open the serial port at the specified baud rate with optional parameters 
- 
-[[f485open()]] - Open the RS-485 port at the specified baud rate and parity 
- 
-[[fsockopen()]] - Open an internet socket connection with optional timeout 
- 
-[[fgets()]] - Return a single line from a file, stream or socket, with optional size limit 
- 
-[[fwrite()]] - Write data to a file, stream or socket 
- 
-[[feof()]] - Test if no more data is available in a file, stream or socket 
- 
-[[filesize()]] - Return the size of a file, or the number of unread bytes in a stream or socket 
- 
-[[fseek()]] - Position the file pointer in an open file 
- 
-[[ftell()]] - Return the current position of a file read/write pointer 
- 
-[[fclose()]] - Close a file, stream or socket 
  
uphp/functions/fread.txt · Last modified: 2021/09/13 05:57 (external edit)