File: nbdkit_parse_size.pod

package info (click to toggle)
nbdkit 1.42.6-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 14,700 kB
  • sloc: ansic: 59,169; sh: 16,858; makefile: 6,452; python: 1,837; cpp: 1,116; perl: 502; ml: 498; tcl: 62
file content (63 lines) | stat: -rw-r--r-- 1,222 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
=head1 NAME

nbdkit_parse_size - parse human-readable size strings for nbdkit

=head1 SYNOPSIS

 #include <nbdkit-plugin.h>

 int64_t nbdkit_parse_size (const char *str);

=head1 DESCRIPTION

Use the C<nbdkit_parse_size> utility function to parse human-readable
size strings such as C<"100M"> into the size in bytes.

The C<str> parameter is a string in a number of common formats.

=head1 RETURN VALUE

The function returns the size in bytes.

If there is an error it calls L<nbdkit_error(3)> and returns C<-1>.

=head1 LANGUAGE BINDINGS

In L<nbdkit-ocaml-plugin(3)>:

 NBDKit.parse_size : string -> int64

In L<nbdkit-python-plugin(3)>:

 import nbdkit
 size = nbdkit.parse_size(str)

In L<nbdkit-rust-plugin(3)>:

 use nbdkit::*;
 pub fn parse_size(s: &str) -> Result<i64>

In L<nbdkit-sh-plugin(3)>, C<nbdkit_parse_size> is called implicitly
to parse the output of C<get_size> and other methods.

=head1 HISTORY

C<nbdkit_parse_size> was present in nbdkit 0.1.0.

=head1 SEE ALSO

L<nbdkit(1)>,
L<nbdkit_parse_bool(3)>,
L<nbdkit_parse_delay(3)>,
L<nbdkit_parse_int(3)>,
L<nbdkit_parse_probability(3)>,
L<nbdkit-plugin(3)>,
L<nbdkit-filter(3)>.

=head1 AUTHORS

Richard W.M. Jones

=head1 COPYRIGHT

Copyright Red Hat