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

# Boulder::String(3)

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

```
   #!/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;
    }
```

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.\
 **$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`. 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\>. Boulder, Boulder::Stream,  Boulder::Blast, Boulder::Genbank, Boulder::Medline, Boulder::Unigene, Boulder::Omim, Boulder::SwissProt