manual:chapter6:usb:cmd_usbsend [newRPL User Manual]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== USBSEND ====
----
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Send an object through the USB link
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^  ^  __Output Stack__  ^
|  **O**  |  **→**  |  **1/0**  |
|  //Level 1//  |  //→//  |  //Level 1//  | 

{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}

|**Type**| [[manual:chapter5:basics#commands|Command]]  ||
|**Parallel list processing**| [[manual:chapter5:listproc#group-5one-argument-one-result-commands|Group 5]]  || 
|**Affected by flags**|  [[manual:appendix:flags#flag-47|-47]] | Automatic reception and execution of data sent via USB  |
</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''USBSEND'' command sends an object to another calculator using the USB link, provided the connection has been successufully negotiated. If the transfer succeeds ''USBSEND'' will leave ''1'' on the stack, otherwise it will leave ''0''.

The setting of flag [[manual:appendix:flags#flag-47|-47]] on the __destination__ machine has an effect on ''USBSEND'' on the __source__ machine, because the transfer queue can manage just one object at a time: until the object currently sent is not received by the destination calc any subsequent transfer will fail.
</callout>

<callout type="danger" icon="true" title="Compatibility">
----
This command is new in newRPL and does not exist in userRPL.
</callout>

<callout type="info" icon="true" title="Usage">
----
The following program
<code>
«  @@ Make a list with value and variable name and send it
  2 →LIST
  DO
    DUP 
  UNTIL
    USBSEND
  END
  DROP 
  
  @@ Write a program to explode the list and do 'STO' in  the other calc...
  «
    OBJ→ DROP STO 
  »

  @@ ...and send it!
  DO
    DUP 
  UNTIL
    USBSEND
  END
  DROP 
»
</code>
executes a ''[[manual:chapter6:dirs:cmd_sto|STO]]'' through USB. See ''[[manual:chapter6:usb:cmd_usbrecv|USBRECV]]'' for implementation of a USB ''[[manual:chapter6:dirs:cmd_rcl|RCL]]''.
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:usb&nofooter&noeditbtn&inline}}
</callout>