make-synonym-stream symbol → synonym-stream

symbol — a symbol that names a dynamic variable.

synonym-stream — a synonym stream.

Returns a synonym stream whose synonym stream symbol is symbol.

 (setq a-stream (make-string-input-stream "a-stream") 
        b-stream (make-string-input-stream "b-stream")) 
→ #<String Input Stream> 
 (setq s-stream (make-synonym-stream 'c-stream)) 
→ #<SYNONYM-STREAM for C-STREAM> 
 (setq c-stream a-stream) 
→ #<String Input Stream> 
 (read s-stream) → A-STREAM 
 (setq c-stream b-stream) 
→ #<String Input Stream> 
 (read s-stream) → B-STREAM

Should signal type-error if its argument is not a symbol.

Section 21.1 (Stream Concepts)