---
name: "Boulder::String"
section: "3pm"
platform: "linux"
package: "libboulder-perl"
version: "1.30-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Boulder::String/3pm"
---

# Boulder::String(3pm)

Read and write tag/value data from a string.

## NAME

Boulder::String - Read and write tag/value data from a string.

## SYNOPSIS

```
   #!/bin/perl
   # Read a B<Stone> from stdin and create a string that can be
   # passed to a dumb sub, which doesn't know about Stones.
   use Boulder::Stream;
   use Boulder::String;

   my $stream = Boulder::Stream->newFh;

   # read a stone from stdin
   my $record = <$stream> );
      print $stream $record;
    }
```

## DESCRIPTION

Boulder::String provides access to Boulder IO hierarchical tag/value data.   Stone objects printed to the tied string are appended to the string in Boulder format.

## Boulder::Stream METHODS

### $stream = Boulder::Stream-\>new($in\_string,\\$out\_string);

The **new()** method creates a new **Boulder::String** object.  You must provide an input string and a reference to an output string. The input string may be empty.

### $stream-\>write\_record($stone)

Write the passed stone in Boulder IO format into `$out_string`.

## AUTHOR

Lincoln D. Stein \<lstein@cshl.org\>, Cold Spring Harbor Laboratory, Cold Spring Harbor, NY.  This module can be used and distributed on the same terms as Perl itself.

Patches and bug fixes contributed by Bernhard Schmalhofer \<bernhard@biomax.de\>.

## SEE ALSO

Boulder, Boulder::Stream,  Boulder::Blast, Boulder::Genbank, Boulder::Medline, Boulder::Unigene, Boulder::Omim, Boulder::SwissProt